Launchchair Agent Loop Mcp

Created By
LaunchChaira day ago
LaunchChair Agent Loop MCP connects desktop agents like Codex and Claude Code to LaunchChair’s Agent API. Agents can create and find LaunchChair projects, run structured product ideation, validation, MVP blueprint, stack setup, and build-card loops, claim “Run with agent” jobs, apply structured outputs, retry or remediate failed work, and return links back to LaunchChair synthesis pages while LaunchChair remains the source of truth for the living spec.
Overview
DocsOpen app
Public docs

LaunchChair MCP turns project work into a local agent loop.

The LaunchChair MCP bridge runs locally over stdio. Desktop agents call MCP tools, the bridge talks to LaunchChair Agent API, and a configured runner executes the queued work.

JSON catalogPersonalized setup

Agent API and MCP Docs

Agent API Docs

Hermes Agent Setup

MCP Setup Docs

CLI Setup

Codex Desktop Setup

Claude Desktop Setup

Install

Download the local bridge files.

The bridge files are public JavaScript files. Download them locally with AGENTS.md, then configure your MCP client with the bridge path and your authenticated LaunchChair environment variables. The install snippet also creates a tiny project-local AGENTS.md pointer when the target folder does not already have one, so fresh chats know to read the LaunchChair bootstrap file first.

mkdir -p "$HOME/launchchair-agent"
curl -fsSL "https://www.launchchair.io/api/agent/v1/bridge/local-bridge.mjs" -o "$HOME/launchchair-agent/local-bridge.mjs"
curl -fsSL "https://www.launchchair.io/api/agent/v1/bridge/launchchair-cli.mjs" -o "$HOME/launchchair-agent/launchchair-cli.mjs"
curl -fsSL "https://www.launchchair.io/api/agent/v1/bridge/mcp-bridge-server.mjs" -o "$HOME/launchchair-agent/mcp-bridge-server.mjs"
curl -fsSL "https://www.launchchair.io/api/agent/v1/bridge/runner-command.mjs" -o "$HOME/launchchair-agent/runner-command.mjs"
curl -fsSL "https://www.launchchair.io/api/agent/v1/bridge/codex-runner.mjs" -o "$HOME/launchchair-agent/codex-runner.mjs"
curl -fsSL "https://www.launchchair.io/api/agent/v1/bridge/claude-code-runner.mjs" -o "$HOME/launchchair-agent/claude-code-runner.mjs"
curl -fsSL "https://www.launchchair.io/api/agent/v1/bridge/chatgpt-runner.mjs" -o "$HOME/launchchair-agent/chatgpt-runner.mjs"
curl -fsSL "https://www.launchchair.io/api/agent/v1/bridge/claude-runner.mjs" -o "$HOME/launchchair-agent/claude-runner.mjs"
curl -fsSL "https://www.launchchair.io/agent-artifacts/AGENTS.md" -o "$HOME/launchchair-agent/AGENTS.md"
chmod +x "$HOME/launchchair-agent"/*.mjs
LAUNCHCHAIR_AGENT_WORKDIR="${LC_AGENT_CODEX_CWD:-${LC_AGENT_CLAUDE_CODE_CWD:-$PWD}}"
if [ -d "$LAUNCHCHAIR_AGENT_WORKDIR" ] && [ ! -f "$LAUNCHCHAIR_AGENT_WORKDIR/AGENTS.md" ]; then
  printf '%s\n' \
    '# LaunchChair Agent Bootstrap Pointer' \
    '' \
    'Before searching this repo, read ~/launchchair-agent/AGENTS.md.' \
    'Use LaunchChair MCP/API first for product phases, project discovery, project creation, and phase loops.' \
    'Do not ask for extra confirmation before using LaunchChair MCP/API when the user already requested the action and the token permits it.' \
    'Only inspect this repo for Stack Setup, Build MVP, Design/Landing Page, SEO implementation, smoke testing, security review, or code remediation.' \
    > "$LAUNCHCHAIR_AGENT_WORKDIR/AGENTS.md"
fi

Fresh chats

Read AGENTS.md before searching the repo.

Fresh Codex, Claude, and Hermes chats should read the public bootstrap file before doing local repo discovery. LaunchChair product phases can run without a repo, and an empty runner folder is expected before Stack Setup creates or records the GitHub repo.

curl -fsSL https://www.launchchair.io/agent-artifacts/AGENTS.md

Use launchchair_status before searching local files.

Use launchchair_list_projects when the user names a project and LAUNCHCHAIR_PROJECT_ID is blank.

Use launchchair_create_project when the user wants to start from a new idea.

Do not ask for extra confirmation before normal LaunchChair MCP/API actions the user already requested and the token permits.

Only inspect the repo during Stack Setup, Build MVP, Design and Landing Page, SEO implementation, or code remediation.

Environment

The bridge needs a base URL, token, project ID, and runner target.

The public docs use placeholders. Users get the real token and project ID from Settings -> API Access after logging in.

LAUNCHCHAIR_BASE_URL="https://www.launchchair.io"
LAUNCHCHAIR_AGENT_TOKEN="<full lc_at token from Settings API Access>"
LAUNCHCHAIR_PROJECT_ID="PASTE_PROJECT_UUID_OR_LEAVE_BLANK_IF_AGENT_CREATES_PROJECT"

Use LC_AGENT_ROUTER_GPT_TARGET and LC_AGENT_ROUTER_CODEX_TARGET to route work.

Use codex for Codex Desktop local runs.

Use claude_code for Claude Desktop plus Claude Code local runs.

Set the CWD variable to an existing repo folder or an empty folder the local runner should build into.

A Hermes env file only helps Hermes; Codex Desktop needs these values in Codex MCP config.

If Codex asks to approve the local bridge fallback shell command, approve the LaunchChair bridge command prefix once. Exposed MCP tools avoid that shell prompt.

Tools

The primary loop tool is launchchair_continue_project.

The loop tool asks LaunchChair to inspect project state, queue the next agent-actionable step, run it with the configured local runner, complete it, apply or validate output, remediate when needed, and return phase synthesis links when phases finish. During Stack Setup, it passes local repo evidence to LaunchChair and stops with explicit instructions if the user still needs to authorize GitHub, Vercel, Supabase, or Stripe.

Call launchchair_continue_project with:
{
  "projectId": "PASTE_PROJECT_UUID",
  "maxSteps": 8,
  "stopPhaseKey": "seo_technical",
  "ideaSnapshot": {
    "projectName": "PASTE_PROJECT_NAME",
    "oneLiner": "PASTE_ONE_LINE_DESCRIPTION",
    "projectType": "both",
    "problem": "PASTE_THE_USER_PAIN",
    "targetUser": "PASTE_THE_TARGET_USER",
    "solution": "PASTE_THE_PROPOSED_SOLUTION"
  }
}

When a phase completes, show me the LaunchChair phase synthesis link.

launchchair_create_project

launchchair_list_projects

launchchair_status

launchchair_heartbeat

launchchair_claim_next_run

launchchair_complete_run

launchchair_run_once

launchchair_select_choice

launchchair_continue_project

Background worker

Use local-bridge.mjs when LaunchChair should pick up queued UI runs automatically.

The MCP bridge responds when a desktop agent calls a tool. The local bridge is the polling worker: it sends heartbeats, claims queued runs created by the Run with agent button, routes them to Codex or Claude Code, and completes the run back to LaunchChair.

LAUNCHCHAIR_BASE_URL="https://www.launchchair.io" 
LAUNCHCHAIR_AGENT_TOKEN="<full lc_at token from Settings API Access>"
LAUNCHCHAIR_PROJECT_ID="PASTE_PROJECT_UUID"
LC_AGENT_ROUTER_GPT_TARGET="codex"
LC_AGENT_ROUTER_CODEX_TARGET="codex"
LC_AGENT_CODEX_CWD="/absolute/path/to/the-folder-codex-should-build-into"
node "$HOME/launchchair-agent/local-bridge.mjs" --verbose

Use the MCP bridge for agent-directed loops inside Codex, Claude, or Hermes.

Use local-bridge.mjs for always-on Run with agent behavior from the LaunchChair UI.

Keep the terminal process running while you want LaunchChair to pick up queued work.

Machine-readable summary

What agents should remember

LaunchChair MCP uses a local stdio bridge server.

Fresh agent chats should read /agent-artifacts/AGENTS.md before local repo discovery.

LaunchChair local-bridge.mjs is the background polling worker for queued Run with agent jobs.

The bridge requires LAUNCHCHAIR_BASE_URL, LAUNCHCHAIR_AGENT_TOKEN, and LAUNCHCHAIR_PROJECT_ID.

The primary MCP loop tool is launchchair_continue_project.

The bridge can route work to Codex, Claude Code, ChatGPT API, or Claude API runners.

The bridge passes local build folder evidence so LaunchChair can verify Codex or Claude Code setup during Stack Setup.

FAQ

Is LaunchChair MCP a hosted remote MCP server?

No. The current setup uses a local stdio bridge. That lets desktop agents run local tools while LaunchChair keeps project state and loop orchestration.

Does MCP require an OpenAI or Anthropic API key?

Not when routing to Codex or Claude Code runners that reuse local CLI auth. Direct chatgpt or claude API runners require provider API keys.


Agent API docs · MCP setup · structured project loops

Create token
Explore LaunchChair pages
LaunchChair featuresLaunchChair guidesLaunchChair blogLaunchChair comparisonsAgent API and MCP DocsAgent API DocsHermes Agent SetupMCP Setup DocsCLI SetupCodex Desktop SetupClaude Desktop SetupAI MVP PlannerStartup Validation WorkflowProduct Spec GeneratorSpec-Aware PromptsGuide: AI MVP PlannerGuide: AI PRD GeneratorGuide: Spec-Aware PromptsGuide: Startup Validation With AIGuide: Spec Coding vs Vibe CodingGuide: Vibe Coding vs Spec-Driven BuildsGuide: Spec-Driven AI App DevelopmentGuide: Plan an MVP Before LovableGuide: AI App Builders for Non-Technical FoundersGuide: Avoid Rebuilding an AI-Generated MVPGuide: LaunchChair vs Idea ValidatorsGuide: Before Using an AI App BuilderVibe Coding Is BrokenLaunchChair Is a LoopHow to Validate a SaaS Startup in 2026LaunchChair vs LovableLaunchChair vs BoltLaunchChair vs Base44LaunchChair vs Vibe CodingLaunchChair vs ChatGPTLaunchChair vs Claude CodeLaunchChair vs CursorLaunchChair vs Replit AgentLaunchChair vs v0LaunchChair vs AI App Builders
MCP turns project work into a local agent loop.","name":"LaunchChair MCP Docs | Local Agent Bridge and Project Loop","description":"Public LaunchChair MCP setup docs for the local bridge server, MCP tools, runner routing, project loop execution, and phase synthesis links.","dateModified":"2026-06-19","inLanguage":"en-US","isPartOf":{"@id":"https://www.launchchair.io/#website"},"author":{"@id":"https://www.launchchair.io/#organization"},"publisher":{"@id":"https://www.launchchair.io/#organization"},"about":["LaunchChair MCP","MCP bridge","launchchair_continue_project","AI agent loop"],"mentions":["LaunchChair MCP uses a local stdio bridge server.","Fresh agent chats should read /agent-artifacts/AGENTS.md before local repo discovery.","LaunchChair local-bridge.mjs is the background polling worker for queued Run with agent jobs.","The bridge requires LAUNCHCHAIR_BASE_URL, LAUNCHCHAIR_AGENT_TOKEN, and LAUNCHCHAIR_PROJECT_ID.","The primary MCP loop tool is launchchair_continue_project.","The bridge can route work to Codex, Claude Code, ChatGPT API, or Claude API runners.","The bridge passes local build folder evidence so LaunchChair can verify Codex or Claude Code setup during Stack Setup."]},{"@type":"FAQPage","@id":"https://www.launchchair.io/docs/mcp#faq","mainEntity":[{"@type":"Question","name":"Is LaunchChair MCP a hosted remote MCP server?","acceptedAnswer":{"@type":"Answer","text":"No. The current setup uses a local stdio bridge. That lets desktop agents run local tools while LaunchChair keeps project state and loop orchestration."}},{"@type":"Question","name":"Does MCP require an OpenAI or Anthropic API key?","acceptedAnswer":{"@type":"Answer","text":"Not when routing to Codex or Claude Code runners that reuse local CLI auth. Direct chatgpt or claude API runners require provider API keys."}}]}]}",{}]}]}]},"$undefined","$undefined",true],["",["$","$1","c",{"children":[[["$","link","0",{"rel":"stylesheet","href":"/_next/static/css/3be41560363d29c3.css?dpl=dpl_FfudGGGQ4G8qVEwtWgPKCfFqhU6h","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}]],["$","html",null,{"lang":"en","suppressHydrationWarning":true,"children":[["$","head",null,{"children":[["$","link",null,{"rel":"ai-index","href":"https://www.launchchair.io/llms.txt"}],["$","link",null,{"rel":"alternate","type":"text/plain","href":"https://www.launchchair.io/llms.txt","title":"LaunchChair LLM instructions"}],["$","link",null,{"rel":"alternate","type":"text/plain","href":"https://www.launchchair.io/llms-full.txt","title":"LaunchChair full machine-readable product brief"}]]}],["$","body",null,{"suppressHydrationWarning":true,"className":"__variable_dd5b2f __className_dd5b2f","children":[["$","$L2",null,{"initialColorMode":"light"}],["$","$L3",null,{}],["$","$L4",null,{"children":["$","$L5",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L6",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":[[["$","title",null,{"children":"404: This page could not be found."}],["$","div",null,{"style":{"fontFamily":"system-ui,\"Segoe UI\",Roboto,Helvetica,Arial,sans-serif,\"Apple Color Emoji\",\"Segoe UI Emoji\"","height":"100vh","textAlign":"center","display":"flex","flexDirection":"column","alignItems":"center","justifyContent":"center"},"children":["$","div",null,{"children":[["$","style",null,{"dangerouslySetInnerHTML":{"__html":"body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}"}}],["$","h1",null,{"className":"next-error-h1","style":{"display":"inline-block","margin":"0 20px 0 0","padding":"0 23px 0 0","fontSize":24,"fontWeight":500,"verticalAlign":"top","lineHeight":"49px"},"children":404}],["$","div",null,{"style":{"display":"inline-block"},"children":["$","h2",null,{"style":{"fontSize":14,"fontWeight":400,"lineHeight":"49px","margin":0},"children":"This page could not be found."}]}]]}]}]],[]],"forbidden":"$undefined","unauthorized":"$undefined"}]}]]}]]}]]}],{"children":["docs",["$","$1","c",{"children":[null,["$","$L5",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L6",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":"$undefined","forbidden":"$undefined","unauthorized":"$undefined"}]]}],{"children":[["docSlug","mcp","d"],["$","$1","c",{"children":[null,["$","$L5",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L6",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":"$undefined","forbidden":"$undefined","unauthorized":"$undefined"}]]}],{"children":["PAGE",["$","$1","c",{"children":["$L7","$undefined",null,["$","$L8",null,{"children":["$L9","$La",null]}]]}],{},null,false]},null,false]},null,false]},null,false],["$","$1","h",{"children":[null,["$","$1","akfwwRXtInP2dKrflzldb",{"children":[["$","$Lb",null,{"children":"$Lc"}],["$","meta",null,{"name":"next-size-adjust","content":""}]]}],["$","$Ld",null,{"children":"$Le"}]]}],false]],"m":"$undefined","G":["$f","$undefined"],"s":false,"S":true}\n"])" -o "$HOME/launchchair-agent/local-bridge.mjs"\ncurl -fsSL "https://www.launchchair.io/api/agent/v1/bridge/launchchair-cli.mjs" -o "$HOME/launchchair-agent/launchchair-cli.mjs"\ncurl -fsSL "https://www.launchchair.io/api/agent/v1/bridge/mcp-bridge-server.mjs" -o "$HOME/launchchair-agent/mcp-bridge-server.mjs"\ncurl -fsSL "https://www.launchchair.io/api/agent/v1/bridge/runner-command.mjs" -o "$HOME/launchchair-agent/runner-command.mjs"\ncurl -fsSL "https://www.launchchair.io/api/agent/v1/bridge/codex-runner.mjs" -o "$HOME/launchchair-agent/codex-runner.mjs"\ncurl -fsSL "https://www.launchchair.io/api/agent/v1/bridge/claude-code-runner.mjs" -o "$HOME/launchchair-agent/claude-code-runner.mjs"\ncurl -fsSL "https://www.launchchair.io/api/agent/v1/bridge/chatgpt-runner.mjs" -o "$HOME/launchchair-agent/chatgpt-runner.mjs"\ncurl -fsSL "https://www.launchchair.io/api/agent/v1/bridge/claude-runner.mjs" -o "$HOME/launchchair-agent/claude-runner.mjs"\ncurl -fsSL "https://www.launchchair.io/agent-artifacts/AGENTS.md" -o "$HOME/launchchair-agent/AGENTS.md"\nchmod +x "$HOME/launchchair-agent"/*.mjs\nLAUNCHCHAIR_AGENT_WORKDIR="${LC_AGENT_CODEX_CWD:-${LC_AGENT_CLAUDE_CODE_CWD:-$PWD}}"\nif [ -d "$LAUNCHCHAIR_AGENT_WORKDIR" ] \u0026\u0026 [ ! -f "$LAUNCHCHAIR_AGENT_WORKDIR/AGENTS.md" ]; then\n "]) MCP turns project work into a local agent loop.","name":"LaunchChair MCP Docs | Local Agent Bridge and Project Loop","description":"Public LaunchChair MCP setup docs for the local bridge server, MCP tools, runner routing, project loop execution, and phase synthesis links.","dateModified":"2026-06-19","inLanguage":"en-US","isPartOf":{"@id":"https://www.launchchair.io/#website"},"author":{"@id":"https://www.launchchair.io/#organization"},"publisher":{"@id":"https://www.launchchair.io/#organization"},"about":["LaunchChair MCP","MCP bridge","launchchair_continue_project","AI agent loop"],"mentions":["LaunchChair MCP uses a local stdio bridge server.","Fresh agent chats should read /agent-artifacts/AGENTS.md before local repo discovery.","LaunchChair local-bridge.mjs is the background polling worker for queued Run with agent jobs.","The bridge requires LAUNCHCHAIR_BASE_URL, LAUNCHCHAIR_AGENT_TOKEN, and LAUNCHCHAIR_PROJECT_ID.","The primary MCP loop tool is launchchair_continue_project.","The bridge can route work to Codex, Claude Code, ChatGPT API, or Claude API runners.","The bridge passes local build folder evidence so LaunchChair can verify Codex or Claude Code setup during Stack Setup."]},{"@type":"FAQPage","@id":"https://www.launchchair.io/docs/mcp#faq","mainEntity":[{"@type":"Question","name":"Is LaunchChair MCP a hosted remote MCP server?","acceptedAnswer":{"@type":"Answer","text":"No. The current setup uses a local stdio bridge. That lets desktop agents run local tools while LaunchChair keeps project state and loop orchestration."}},{"@type":"Question","name":"Does MCP require an OpenAI or Anthropic API key?","acceptedAnswer":{"@type":"Answer","text":"Not when routing to Codex or Claude Code runners that reuse local CLI auth. Direct chatgpt or claude API runners require provider API keys."}}]}]}"]) launchchair_status before searching local files.","Use launchchair_list_projects when the user names a project and LAUNCHCHAIR_PROJECT_ID is blank.","Use launchchair_create_project when the user wants to start from a new idea.","Do not ask for extra confirmation before normal LaunchChair MCP/API actions the user already requested and the token permits.","Only inspect the repo during Stack Setup, Build MVP, Design and Landing Page, SEO implementation, or code remediation."]},{"eyebrow":"Environment","title":"The bridge needs a base URL, token, project ID, and runner target.","body":"The public docs use placeholders. Users get the real token and project ID from Settings -\u003e API Access after logging in.","code":"LAUNCHCHAIR_BASE_URL=\"https://www.launchchair.io\"\nLAUNCHCHAIR_AGENT_TOKEN=\"\u003cfull lc_at token from Settings API Access\u003e\"\nLAUNCHCHAIR_PROJECT_ID=\"PASTE_PROJECT_UUID_OR_LEAVE_BLANK_IF_AGENT_CREATES_PROJECT\"","bullets":["Use LC_AGENT_ROUTER_GPT_TARGET and LC_AGENT_ROUTER_CODEX_TARGET to route work.","Use codex for Codex Desktop local runs.","Use claude_code for Claude Desktop plus Claude Code local runs.","Set the CWD variable to an existing repo folder or an empty folder the local runner should build into.","A Hermes env file only helps Hermes; Codex Desktop needs these values in Codex MCP config.","If Codex asks to approve the local bridge fallback shell command, approve the LaunchChair bridge command prefix once. Exposed MCP tools avoid that shell prompt."]},{"eyebrow":"Tools","title":"The primary loop tool is launchchair_continue_project.","body":"The loop tool asks LaunchChair to inspect project state, queue the next agent-actionable step, run it with the configured local runner, complete it, apply or validate output, remediate when needed, and return phase synthesis links when phases finish. During Stack Setup, it passes local repo evidence to LaunchChair and stops with explicit instructions if the user still needs to authorize GitHub, Vercel, Supabase, or Stripe.","code":"Call launchchair_continue_project with:\n{\n \"projectId\": \"PASTE_PROJECT_UUID\",\n \"maxSteps\": 8,\n \"stopPhaseKey\": \"seo_technical\",\n \"ideaSnapshot\": {\n \"projectName\": \"PASTE_PROJECT_NAME\",\n \"oneLiner\": \"PASTE_ONE_LINE_DESCRIPTION\",\n \"projectType\": \"both\",\n \"problem\": \"PASTE_THE_USER_PAIN\",\n \"targetUser\": \"PASTE_THE_TARGET_USER\",\n \"solution\": \"PASTE_THE_PROPOSED_SOLUTION\"\n }\n}\n\nWhen a phase completes, show me the LaunchChair phase synthesis link.","bullets":["launchchair_create_project","launchchair_list_projects","launchchair_status","launchchair_heartbeat","launchchair_claim_next_run","launchchair_complete_run","launchchair_run_once","launchchair_select_choice","launchchair_continue_project"]},{"eyebrow":"Background worker","title":"Use local-bridge.mjs when LaunchChair should pick up queued UI runs automatically.","body":"The MCP bridge responds when a desktop agent calls a tool. The local bridge is the polling worker: it sends heartbeats, claims queued runs created by the Run with agent button, routes them to Codex or Claude Code, and completes the run back to LaunchChair.","code":"LAUNCHCHAIR_BASE_URL=\"https://www.launchchair.io\" \\\nLAUNCHCHAIR_AGENT_TOKEN=\"\u003cfull lc_at token from Settings API Access\u003e\" \\\nLAUNCHCHAIR_PROJECT_ID=\"PASTE_PROJECT_UUID\" \\\nLC_AGENT_ROUTER_GPT_TARGET=\"codex\" \\\nLC_AGENT_ROUTER_CODEX_TARGET=\"codex\" \\\nLC_AGENT_CODEX_CWD=\"/absolute/path/to/the-folder-codex-should-build-into\" \\\nnode \"$HOME/launchchair-agent/local-bridge.mjs\" --verbose","bullets":["Use the MCP bridge for agent-directed loops inside Codex, Claude, or Hermes.","Use local-bridge.mjs for always-on Run with agent behavior from the LaunchChair UI.","Keep the terminal process running while you want LaunchChair to pick up queued work."]}],"facts":["LaunchChair MCP uses a local stdio bridge server.","Fresh agent chats should read /agent-artifacts/AGENTS.md before local repo discovery.","LaunchChair local-bridge.mjs is the background polling worker for queued Run with agent jobs.","The bridge requires LAUNCHCHAIR_BASE_URL, LAUNCHCHAIR_AGENT_TOKEN, and LAUNCHCHAIR_PROJECT_ID.","The primary MCP loop tool is launchchair_continue_project.","The bridge can route work to Codex, Claude Code, ChatGPT API, or Claude API runners.","The bridge passes local build folder evidence so LaunchChair can verify Codex or Claude Code setup during Stack Setup."],"faqs":[{"question":"Is LaunchChair MCP a hosted remote MCP server?","answer":"No. The current setup uses a local stdio bridge. That lets desktop agents run local tools while LaunchChair keeps project state and loop orchestration."},{"question":"Does MCP require an OpenAI or Anthropic API key?","answer":"Not when routing to Codex or Claude Code runners that reuse local CLI auth. Direct chatgpt or claude API runners require provider API keys."}]},"endpoints":[{"id":"project-list","method":"GET","path":"/api/agent/v1/projects?query=:name","scope":["projects.read","prompts.read"],"description":"List projects visible to the current Agent API token, optionally filtered by project name. Use this to resolve user-provided project names before continuing a loop.","risk":"read"},{"id":"project-create","method":"POST","path":"/api/agent/v1/projects","scope":"projects.write","description":"Create a LaunchChair project in the token workspace, optionally save the first Idea Snapshot, and optionally start the project loop.","risk":"write"},{"id":"agent-heartbeat","method":"POST","path":"/api/agent/v1/heartbeat","scope":["presence.write","prompts.read"],"description":"Send heartbeat + client metadata for agent presence.","risk":"read"},{"id":"agent-runs-next","method":"POST","path":"/api/agent/v1/runs/next","scope":["runs.claim","prompts.read"],"description":"Claim next queued run for the current token.","risk":"read"},{"id":"agent-runs-complete","method":"POST","path":"/api/agent/v1/runs/:runId/complete","scope":["runs.complete","prompts.read"],"description":"Complete/fail the claimed run, send structured result payload, and let LaunchChair apply, validate, retry, or queue remediation when configured.","risk":"write"},{"id":"project-loop-continue","method":"POST","path":"/api/agent/v1/projects/:projectId/loop/continue","scope":["loop.continue","prompts.read"],"description":"Inspect the project, optionally save the first Idea Snapshot from ideaSnapshot, optionally apply requested choiceSelections, queue the next agent-actionable bucket or build-card run, and return phase synthesis links when completed phases are detected.","risk":"write"},{"id":"project-choice-select","method":"POST","path":"/api/agent/v1/projects/:projectId/choices/select","scope":["choices.write","buckets.write"],"description":"Select or change a generated user-choice option, such as wedge, pricing, or feature direction. Supports optionId, optionTitle/optionQuery, and resetDownstream.","risk":"write"},{"id":"project-spec-read","method":"GET","path":"/api/agent/v1/projects/:projectId/spec","scope":"spec.read","description":"Read the full normalized project spec.","risk":"read"},{"id":"project-spec-write","method":"PATCH","path":"/api/agent/v1/projects/:projectId/spec","scope":"spec.write","description":"Write project spec directly (disabled for MVP token profiles).","risk":"write"},{"id":"project-buckets-list","method":"GET","path":"/api/agent/v1/projects/:projectId/buckets","scope":"buckets.read","description":"List phase buckets with current status and metadata.","risk":"read"},{"id":"project-bucket-read","method":"GET","path":"/api/agent/v1/projects/:projectId/buckets/:phaseKey/:bucketKey","scope":"buckets.read","description":"Read a single bucket payload for the target phase/bucket.","risk":"read"},{"id":"project-bucket-write","method":"PATCH","path":"/api/agent/v1/projects/:projectId/buckets/:phaseKey/:bucketKey","scope":"buckets.write","description":"Write non-prompt bucket data for the target phase/bucket.","risk":"write"},{"id":"project-bucket-prompt","method":"GET","path":"/api/agent/v1/projects/:projectId/buckets/:phaseKey/:bucketKey/prompt","scope":"prompts.read","description":"Retrieve compiled prompt text for a bucket.","risk":"read"},{"id":"project-bucket-apply","method":"POST","path":"/api/agent/v1/projects/:projectId/buckets/:phaseKey/:bucketKey/apply-spec-update","scope":"buckets.write","description":"Apply parsed SPEC_UPDATE payload for a bucket run.","risk":"write"},{"id":"project-build-cards-list","method":"GET","path":"/api/agent/v1/projects/:projectId/build-cards","scope":"build_cards.read","description":"List build cards, board state, and latest agent-facing SQL/manual QA checkpoints for the project.","risk":"read"},{"id":"project-build-card-readwrite","method":"PATCH","path":"/api/agent/v1/projects/:projectId/build-cards/:cardId","scope":"build_cards.write","description":"Update build card status, testing metadata, and SQL action completion state.","risk":"write"},{"id":"project-build-card-prompt","method":"GET","path":"/api/agent/v1/projects/:projectId/build-cards/:cardId/prompt","scope":"prompts.read","description":"Retrieve compiled prompt text for a build card.","risk":"read"},{"id":"project-build-card-apply","method":"POST","path":"/api/agent/v1/projects/:projectId/build-cards/:cardId/apply-run","scope":"build_cards.write","description":"Apply build card CHANGELOG_JSON/REQUIRES run output. SQL actions and manual QA can pause the loop for human completion.","risk":"write"},{"id":"project-export-mvp-spec","method":"GET","path":"/api/agent/v1/projects/:projectId/exports/mvp-ai-spec","scope":"exports.read","description":"Download AI-ready MVP markdown export.","risk":"read"},{"id":"project-export-phase","method":"GET","path":"/api/agent/v1/projects/:projectId/exports/phase/:phaseKey","scope":"exports.read","description":"Download phase summary markdown export.","risk":"read"}],"showEndpointCatalog":false}],["$","script",null,{"type":"application/ld+json","dangerouslySetInnerHTML":{"__html":"$12"}}]]\n"])"])

Server Config

{
  "mcpServers": {
    "launchchair": {
      "command": "node",
      "args": [
        "/Users/you/launchchair-agent/mcp-bridge-server.mjs"
      ],
      "env": {
        "LAUNCHCHAIR_BASE_URL": "https://www.launchchair.io",
        "LAUNCHCHAIR_AGENT_TOKEN": "<YOUR_LAUNCHCHAIR_AGENT_TOKEN>",
        "LAUNCHCHAIR_PROJECT_ID": "<OPTIONAL_PROJECT_UUID>",
        "LC_AGENT_ROUTER_GPT_TARGET": "codex",
        "LC_AGENT_ROUTER_CODEX_TARGET": "codex",
        "LC_AGENT_CODEX_CWD": "/absolute/path/to/your/project-or-empty-build-folder"
      }
    }
  }
}
Project Info
Created At
a day ago
Updated At
a day ago
Author Name
LaunchChair
Star
-
Language
-
License
-
Category
Tags

Recommend Servers

View All
SAIHM — Sovereign AI Horizontal Memory
@SAIHM-Admin

What this is A sovereign, encrypted, sharable, persistent memory protocol for AI agents. A Model Context Protocol server that exposes eight tools any MCP-capable AI agent (Claude Code, Claude Desktop, custom agents) can call to gain a persistent, encrypted memory layer the user owns: saihm_remember — store an encrypted memory cell saihm_recall — retrieve and decrypt your memories saihm_forget — true cryptographic erasure (GDPR Art. 17) saihm_status — your protocol-runtime stats and storage tier dashboard saihm_share / saihm_revoke_share — selectively share a memory with another agent or user saihm_governance_propose / saihm_governance_vote — protocol governance via gSAIHM Each tool forwards to a SAIHM operator endpoint that runs the full protocol stack on COTI V2 mainnet. The server itself holds no crypto, no storage, and no protocol runtime — those live behind the operator endpoint. Tool reference Tool Title Behavior saihm_remember Remember writes a new memory cell saihm_recall Recall read-only; safe to repeat saihm_forget Forget (GDPR erasure) destructive — irreversible erasure saihm_status Status read-only saihm_share Share writes a sharing contract saihm_revoke_share Revoke share withdraws a grant saihm_governance_propose Propose (governance) opens a proposal saihm_governance_vote Vote (governance) casts a vote Each tool carries MCP annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) and a human-readable title, so MCP hosts can gate confirmations and agents can select the right tool at reasoning time. Companion package This package speaks MCP. For production client-side cryptography — post-quantum sealing, authenticated sharing, and provable erasure performed on your own machine so the operator stays blind — pair it with @saihm/client-pro. See it run Runnable, one-command demos ground a memory you own in every major model — Claude, GPT, DeepSeek, Qwen, Kimi, GLM — then prove you can erase it, alongside drop-in adapters for LangChain, LlamaIndex, CrewAI, AutoGen, and LangGraph. Each runs offline in about a minute; no account needed. Live demos: https://citw2.github.io/saihm-demos/ demo-claude-code wires this server into Claude Code and Cursor as an MCP server. Measured — up to ~86% fewer context tokens. Most agents re-send their entire transcript every turn, so context spend grows ~O(N²) over a session; recalling a bounded set of memory cells instead cut input tokens by 62.8%–85.9% across a realistic multi-session coding task. The benchmark is open, offline, and deterministic — reproduce the number rather than trust it: git clone https://github.com/citw2/saihm-token-benchmark cd saihm-token-benchmark && npm install && node benchmark.mjs Install npm install @saihm/mcp-server # or run directly without install: npx @saihm/mcp-server Configure The server needs two env vars: SAIHM_ENDPOINT_URL=https://operator.example.com/mcp SAIHM_AUTH_HEADER=Bearer <token-issued-by-your-operator> SAIHM_ENDPOINT_URL — the SAIHM operator endpoint. Operators publish their endpoint URLs at https://saihm.coti.global. SAIHM_AUTH_HEADER — the Authorization header value the operator expects (typically a Bearer <token> issued to you after key-bound enrolment). The server is authentication-agnostic and never transmits raw private keys; the operator's enrolment flow keeps your signing key on your machine. Place these in a .env file alongside the server (the .gitignore excludes all .env* files from any future repo). Wire into Claude Code { "mcpServers": { "saihm": { "command": "npx", "args": ["@saihm/mcp-server"], "env": { "SAIHM_ENDPOINT_URL": "https://operator.example.com/mcp", "SAIHM_AUTH_HEADER": "Bearer <token>" } } } } What gets persisted, where The server itself persists nothing. The operator endpoint runs the full protocol stack: cells are encrypted under a per-cell DEK, sealed by a per-agent KEK, persisted to the operator's configured durable storage, and audited on COTI V2 mainnet. See the operator's documentation for tier details, and Storage is the operator's responsibility (by design) below. Storage is the operator's responsibility (by design) For operators — read this first. SAIHM does not hard-wire your durable storage to any single provider, and it does not silently provision storage for you. Choosing and configuring where cells are persisted is your job, on purpose. This is a deliberate design choice for operator convenience and data sovereignty — not a missing feature. If memory writes fail with a storage error, it almost always means the backend has not been configured yet. Why it works this way: Provider sovereignty. You decide where your tenants' encrypted cells live. The protocol never locks you to one vendor or one network. Local-first, then deep-archive. A typical operator routes writes to a local IPFS (Kubo) node first — fast, authoritative, and under your own control — and then asynchronously to a Filecoin deep-archive provider such as Pinata, Synapse, or Lighthouse. The same content addressing spans both tiers. Your memory and your tenants' take the same path. Whatever backend you configure serves both the operator's own memory and every tenant's — there is no separate hidden sink hard-coded to one provider. What you configure (your operator deployment guide lists the exact settings): a reachable IPFS / Kubo endpoint (a local node is recommended) for the authoritative low-latency tier, and credentials for at least one Filecoin / IPFS pinning provider for durable deep-archive. If neither is configured, the endpoint has nowhere durable to put cells and will reject writes rather than lose data. That refusal is intentional. Prefer not to run storage yourself? Join SAIHM. You have two paths, and either is fine: Run your own operator endpoint and configure the storage backend as described above — full sovereignty, your infrastructure. Join the hosted SAIHM operator and let it provide durable storage for you. It runs blind / non-custodial: paired with client-side sealing (see @saihm/client-pro and @saihm/mcp-server-pro), it only ever stores ciphertext and never holds your keys — so you get managed storage without giving up custody. Enrol via Join SAIHM at https://saihm.coti.global (a paid hosted service). Reporting engine A reporting library is bundled as a sub-export, so operators can compose the eight MCP calls into bespoke reports with their own tooling (no extra dependency, no extra service): import { validateBespokeTemplate, registerTemplate, generateRegistryAttestation, StubPublicRegistry, InMemoryReportingRuntime, GDPR_ART15_FIELDS, REGISTRY_ATTESTATION_FIELDS, type BespokeReportTemplate, } from "@saihm/mcp-server/reporting"; What it covers Field universe (FIELD_UNIVERSE) — 280 fields (262 framework + 18 ledger). Templates that project a field outside this set are rejected at validation. Bespoke template schema — zod validator + universe-membership check + scope/cap enforcement. Authorization path validators — 4 paths: public / self / operator-self / operator-for-downstream. Receipt emission — 6 sub-kinds (report_generated / report_rejected / template_registered / template_superseded / erasure_chain_broken / rate_limit_exceeded) under a stable, domain-separated receipt namespace. Framework smoke — registry-attestation (public auth) for end-to-end plumbing verification. Constraints Every fieldProjections[] entry MUST be in FIELD_UNIVERSE. scope.customerIdHashes 64-hex; max 10,000 per template. scope.timeRange window ≤ 366 days. fieldProjections length 1–200. framework ∈ {gdpr-art-15, gdpr-art-17, soc2-t1, soc2-t2, iso27001, aml, audit-export, billing-history, registry-attestation}. format ∈ {pdfa3, json, csv}. Worked example const template: BespokeReportTemplate = { templateId: "acme-q1-summary", templateVersion: 1, operatorIdHash: "ab".repeat(32), scope: { customerIdHashes: ["cd".repeat(32)], timeRange: { from: "2026-01-01T00:00:00Z", to: "2026-04-01T00:00:00Z" }, }, framework: "gdpr-art-15", fieldProjections: [GDPR_ART15_FIELDS[0], GDPR_ART15_FIELDS[1]], format: "pdfa3", }; const v = validateBespokeTemplate(template); if (!v.valid) throw new Error(v.errors.join(", ")); const runtime = new InMemoryReportingRuntime(); // replace with your audit-ledger runtime const reg = await registerTemplate(template, runtime); if (reg.ok) console.log("registered:", reg.templateHash); In production, replace InMemoryReportingRuntime with a runtime that persists audit payloads to your operator's audit ledger. Operators who inject signature verifiers should use pure-crypto libraries (@noble/curves for EIP-712, @noble/post-quantum for FIPS 204 ML-DSA) — the package itself bundles no EVM tooling. Security The server enforces a small set of defaults so misconfiguration cannot leak the Authorization header in transit: HTTPS-only endpoints. SAIHM_ENDPOINT_URL must use https://. Plain http:// is rejected at construction time, except for 127.0.0.1 and localhost (so a local operator endpoint works during development). Per-call abort window. Each request runs under an AbortController that aborts after 30s, preventing a hung endpoint from starving the MCP server. Response-size cap. Responses whose Content-Length exceeds 16 MB are rejected before deserialisation. No header echo. Authorization is never included in thrown error messages or stdout. No filesystem reads. The package never reads from disk; configuration flows entirely through env vars. Zero EVM tooling. No ethers, no eth_*, no Solidity. If operators inject signature verifiers via AuthVerifiers, they should use pure-crypto libraries (@noble/curves, @noble/post-quantum). Trust model: this client trusts whatever endpoint the operator configures. Cell IDs, audit anchors, and report receipts returned from that endpoint are surfaced to the agent verbatim — operators are the authority for content shown via saihm_recall. Verifying receipts against COTI V2 mainnet anchors is out of scope for this server; consume the cellId and auditCellId fields and verify against your own SAIHM mainnet read path. For distribution integrity, each release carries the npm registry signature; verify with npm audit signatures (and inspect npm view @saihm/mcp-server --json | jq .dist). Dependencies The published npm package has a minimal runtime surface: Dependency License Role Node.js (≥ 20.x) MIT Runtime @modelcontextprotocol/sdk MIT MCP SDK; binds the eight-tool surface TypeScript Apache-2.0 Build-time only tsx MIT TypeScript runner for tests + CLI No copyleft, no proprietary dependencies. Cryptographic primitives at the operator-endpoint layer (ML-DSA-65 / Ed25519 / key derivation) are not bundled into this MCP server; operators implementing the protocol stack are recommended to use @noble/post-quantum and @noble/curves (MIT) rather than rolling custom code. Achievements OpenSSF Best Practices Passing badge — project 12898, 100% Passing criteria (2026-05-19). https://www.bestpractices.dev/projects/12898 IETF Independent Submission Stream — draft-saihm-memory-protocol-01 (2026-05-27) is In ISE Review in the Independent Submission Stream. It is not an Internet Standard, is not endorsed by the IETF, and has no formal standing in the IETF standards process. https://datatracker.ietf.org/doc/draft-saihm-memory-protocol/ npm registry — @saihm/mcp-server@0.3.4 published (2026-06-22) adds a conspicuous "Storage is the operator's responsibility (by design)" section — documenting BYO storage and the Join-SAIHM hosted, non-custodial option. 0.3.3 (2026-06-22) was a documentation release that states the Independent-Submission status precisely (no implied IETF endorsement) and cross-references the companion package @saihm/client-pro. 0.3.2 (2026-06-22) corrected the documented operator-endpoint path to /mcp (the canonical SAIHM_ENDPOINT_URL path) across the README and client comments. 0.3.1 (2026-05-28) was a metadata patch that sources the MCP serverInfo.version from package.json (was hardcoded "0.1.0" from 0.1.0 through 0.3.0). 0.3.0 (also 2026-05-28) aligned the saihm_status response shape with draft-saihm-memory-protocol-01 §3.4 (full eight-field schema: prs, bfsi, bfsi_window_start_ts, bfsi_R, bfsi_M, shards, contracts, governance). 0.2.0 (also 2026-05-28) aligned the cell-tuple response shape with §2.1; 0.1.3 was the OpenSSF Best Practices Passing badge release (2026-05-19). MCP Registry / Glama — server listed for discovery (2026-05-16). Roadmap A 12-month roadmap is maintained in the project's AAIF proposal and will be mirrored to https://saihm.coti.global/roadmap with the v0.2.x release. Near-term tracks: 2026-Q2 — Operator-endpoint reference implementation; OpenSSF Silver pursuit (governance, code-of-conduct, DCO, signed releases, coverage tooling, assurance case). 2026-Q3 — First 2–3 external organization deployments; formal AAIF Project Proposal submission when adoption blockers clear. 2026-Q4 — NIST AI RMF crosswalk public review; EU AI Act compliance-checklist generator. OpenSSF Silver award (target). 2027-Q1 — Independent-stream (ISE) RFC publication, subject to RFC-Editor review — not an IETF-consensus standard; v1.0 reference implementation. License Apache-2.0 — see LICENSE. Project Site: https://saihm.coti.global Issue tracker: https://github.com/SAIHM-Admin/saihm-mcp/issues Security: see SECURITY.md for private vulnerability disclosure Contributing: see CONTRIBUTING.md and CODE_OF_CONDUCT.md Governance: see GOVERNANCE.md Changelog: see CHANGELOG.md

19 hours ago
Hokyo 豊胸

3 hours ago