corgi mcp
corgi mcp
Run corgi as an MCP server over stdio (for AI agent clients)
Synopsis
Starts a Model Context Protocol server over stdio. AI agent clients spawn this as a subprocess and call corgi's commands as structured tools.
Register it in .mcp.json (project) or ~/.claude.json:
{ "mcpServers": { "corgi": { "command": "corgi", "args": ["mcp"] } } }
corgi mcp [flags]
Options
--allow-origin strings Extra browser Origin allowed on /mcp (scheme://host[:port]); loopback origins and the tunnel's are always allowed. Also CORGI_MCP_ALLOWED_ORIGINS, comma-separated.
--bind-all Let --http listen on a non-loopback address (0.0.0.0, a LAN IP). Off, a bare port binds 127.0.0.1.
-h, --help help for mcp
--http string Serve MCP over Streamable HTTP at this address (e.g. :8765 or 127.0.0.1:8765) instead of stdio.
--insecure Disable bearer-token auth on the HTTP endpoint.
--no-oauth Do not serve the OAuth sign-in (Connect button) beside /mcp; the Authorization header path still works.
--oauth-client-host strings Extra host whose https redirect URIs OAuth clients may use (claude.ai and claude.com are built in). Also CORGI_MCP_OAUTH_CLIENT_HOSTS, comma-separated.
--pair Open a single-use pairing window so a device can claim its own revocable token (requires --http).
--token string Bearer token for HTTP auth (auto-generated when --tunnel is set).
--tunnel Open a public tunnel to the --http addr (requires --http).
--tunnel-hostname string Custom public hostname for the tunnel (${VAR} expanded).
--tunnel-name string cloudflared named-tunnel name.
--tunnel-provider string Tunnel provider (cloudflared|ngrok|localtunnel). (default "cloudflared")
--viewer The device that pairs in this window only reads: the board, the inbox, the brief - never a transcript, never a button (with --pair).
Options inherited from parent commands
--describe Describe contents of corgi-compose file
--dockerContext string Specify docker context to use, can be default,orbctl,colima (default "default")
-l, --exampleList List examples to choose from. Click on any example to download it
-f, --filename string Custom filepath for for corgi-compose
--fromScratch Clean the .corgi/corgi_services folder before running
-t, --fromTemplate string Create corgi service from template url
--fromTemplateName string Create corgi service from template name and url
-g, --global Use global path to one of the services
--interactive Force interactive prompts even when no TTY/agent detected
--isolate string Run this workspace under a named lease: own port block, own database names, own containers
--json Emit machine-readable JSON output
--privateToken string Private token for private repositories to download files
-o, --runOnce Run corgi once and exit
--silent Hide all welcome messages
SEE ALSO
- corgi - Corgi cli magic friend
- corgi mcp devices - List and revoke devices paired with corgi mcp