Agent Hub MCP server

agent-mcp-hub

One MCP server that bridges multiple CLI coding agents — Codex, Cursor, OpenCode, Claude, and Antigravity — into any MCP client.

stdio only — by design. The hub ships no Docker image and no HTTP

transport (both were removed during the 0.5.x line). A containerised or remote

server cannot see the caller's repository path and cannot reuse the caller's

CLI logins — it would break the product contract on both halves. The hub runs

as a child process of your MCP client, on your machine, as you.

Tools

Agent tools accept prompt (required), model, cwd, timeoutMs (total runtime cap, default 1800000 = 30 min), and idleTimeoutMs (inactivity cap, default 300000 = 5 min). See Long-running tasks & timeouts.

Known limitation: opencode prompts may not start with - (its CLI could parse them as flags); the tool returns an actionable error instead of guessing.

Choosing models per agent

Model ids are agent-specific and do not overlap. o3 means nothing to agy, gemini-3.6-flash-low means nothing to codex, and opencode namespaces its own (opencode/big-pickle). So a single model value is valid for at most one agent in a fan-out.

to model, then to their own CLI default.

• runall takes models** — a per-agent map. Agents you don't list fall back

writing the change and the agent judging it can use different engines and tiers. model remains a fallback for both.

• reviewchange takes runnerModel and reviewerModel**, so the agent

{
  "tool": "run_all",
  "arguments": {
    "prompt": "Explain the retry logic in src/exec.ts",
    "models": { "codex": "o3", "agy": "gemini-3.6-flash-low", "claude": "haiku" }
  }
}

An unknown agent name in models is rejected with the list of enabled agents — a typo never silently falls back to the default model.

Where to find valid ids: opencode models, cursor-agent models and agy models list them. codex and claude have no such command — codex reads its default from ~/.codex/config.toml, and claude accepts the documented aliases (opus, sonnet, haiku, fable). Note claude models is not a subcommand: it is treated as a prompt, so its "model list" is generated text, not a source of truth.

Error handling

When a wrapped CLI fails, the hub classifies the failure and returns a clean, ANSI-free, actionable isError result — never a raw terminal dump — naming the class and the exact fix:

Shortened. The full README is on GitHub.