Skip to main content

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

-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.
--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")

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 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
--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
Auto generated by spf13/cobra on 8-Jun-2026