chimera mcp add
Add (or replace-by-name) an MCP server. Persists to .chimera/mcp.json — no connect.
Options
--command, -cstr
The launch command (e.g. npx, uvx, python).
--urlstr
A streamable-HTTP MCP endpoint.
--call-timeoutfloat
Per-call timeout in seconds for this server (default 120).
--connect-timeoutfloat
Connect timeout in seconds for this server (default 30).
--catalog-timeoutfloat
Timeout in seconds for listing tools (default 30).
--cwdstr
Working directory for a local stdio server.
--max-output-charsint
Maximum response characters per tool call for this server.
--token-envstr
Environment variable containing a bearer token.
--oauth-authorization-urlstr
OAuth authorization endpoint.
--oauth-token-urlstr
OAuth token endpoint.
--oauth-client-idstr
OAuth public client ID.
--oauth-redirect-uristr
OAuth loopback redirect URI.
--oauth-scopestr
OAuth scope string.
--arg, -astr
A command argument (repeatable).
--env, -estr
An env var as K=V (repeatable).
chimera mcp approve
Show how a held server's tools changed since you approved them, and approve the change.
A server whose tool descriptions or parameters changed since they were approved is not mounted
by the app, `chimera serve` or its bots until approved here or on the app's MCP screen. File
I/O only; the server is connected again on the next start.
chimera mcp desktop
Serve an MCP server on stdio that operates the RUNNING desktop app (for Claude Code/Desktop).
Needs the app open with Settings > "Allow Claude to operate this app" on; the tools then call
the app's local bridge. Register it with: claude mcp add chimera-desktop -- chimera mcp desktop
Options
This command takes no options.
chimera mcp disable
Keep the server configured but exclude it from every connection and agent mount.
Options
This command takes no options.
chimera mcp enable
Restore a configured server to normal connection eligibility.
Options
This command takes no options.
chimera mcp list
List configured MCP servers (name, command + args, env key names). No connect.
Options
This command takes no options.
chimera mcp login
Sign in to a remote MCP server through your browser (OAuth 2.1 with PKCE).
Discovers the server's authorization server, registers Chimera with it when no client id is
configured, and keeps the tokens in the OS vault (or a 0600 file in the data folder) — never in
mcp.json. Runs only in an interactive terminal and asks before opening the browser; nothing
unattended (serve, bots, cron, the app's Test) ever starts a sign-in.
chimera mcp logout
Revoke (when the server offers it) and forget the stored OAuth sign-in of a server.
Options
This command takes no options.
chimera mcp remove
Remove a configured MCP server by name.
Options
This command takes no options.
chimera mcp test
Live-connect a configured server and print the tools it exposes (or a clear error).
This is the ONLY MCP subcommand that connects (spawns the server + runs the async handshake). It
is the sole honest proof a server is reachable. Needs the 'mcp' extra and the server's own runtime
(e.g. Node for an npx server).
