chimera mcp

Configure MCP servers (persisted to .chimera/mcp.json). Terminal-first source of truth.

Subcommands

chimera mcp add

Add (or replace-by-name) an MCP server. Persists to .chimera/mcp.json — no connect.

Arguments

NAMEstrrequired
A unique name for the server (namespaces its tools).

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.

Arguments

NAMEstrrequired
The held server whose changed tools to approve.

Options

--yes, -yboolean
Approve without asking (the diff still prints).

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.

Arguments

NAMEstrrequired
The server name to disable.

Options

This command takes no options.

chimera mcp enable

Restore a configured server to normal connection eligibility.

Arguments

NAMEstrrequired
The server name to enable.

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.

Arguments

NAMEstrrequired
The configured streamable-HTTP server to sign in to.

Options

--timeoutfloatdefault: 180.0
Seconds to wait for the browser sign-in.

chimera mcp logout

Revoke (when the server offers it) and forget the stored OAuth sign-in of a server.

Arguments

NAMEstrrequired
The server to sign out of.

Options

This command takes no options.

chimera mcp remove

Remove a configured MCP server by name.

Arguments

NAMEstrrequired
The server name to remove.

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

Arguments

NAMEstrrequired
The configured server to live-test.

Options

--timeoutfloatdefault: 12.0
Connect timeout in seconds.