claude-mcp-bridge
This server bridges any MCP host to Claude Opus running headlessly, enabling powerful autonomous AI delegation. It offers the following tools:
ask— Pose read-only questions to Opus for architecture, planning, or explanations.delegate— Hand off a complete autonomous task (file edits, shell commands, tests) to Opus, which runs its own agentic loop until completion.fire— Start a background autonomous task and return immediately with asession_idfor later progress checks.check— Poll the status and progress of a backgroundfiretask bysession_id.follow_up— Continue a prior session bysession_idwithout resending context, since it lives on Claude's side.adversarial_review— Get a critical, read-only review of code, plans, or diffs — hunting for bugs, edge cases, security issues, and race conditions. Useful as a pre-merge gate.web_lookup— Delegate a web/documentation lookup to Opus (with live web access) to find library docs, API references, error explanations, or current package versions.
All tools support cwd (project root) and effort (low/medium/high) parameters, and most support model selection (defaulting to Opus). Delegated tasks also support permission controls (e.g., acceptEdits, bypassPermissions).
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@claude-mcp-bridgeanalyze the src directory for bugs"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
claude-mcp-bridge
MCP server that lets any agent or MCP host (Cursor, Codex, Antigravity, another Claude Code,
your own app) escalate to Opus via Claude Code running headless (claude -p / claude --bg).
Opus is expensive but very capable — this bridge is deliberately narrow: complex reasoning, architecture questions, adversarial review, and autonomous work. Cheap mechanical work (mapping a repo, scanning files) should stay on the host agent's lighter model.
Nested MCP delegation is blocked: Opus sessions spawned by this bridge cannot call claude-mcp-bridge (or any MCP) again.
Tools
Tool | Purpose | Model |
| Read-only Q&A — architecture, explanation, planning ( | Opus (forced) |
| Full autonomous task — edit, shell, tests (max turns, synchronous) | Opus (forced) |
| Fire-and-forget background task — returns | Opus (forced) |
| Compact progress report for a | read-only (no model) |
| Continue a prior session by | Opus (forced) |
Parallel background tasks
fire({ prompt: "Refactor the auth module to use JWT" })
→ returns session_id immediately
check({ session_id: "..." })
→ check progress anytimeExamples
// Ask Opus to explain architecture (read-only)
{ "prompt": "Explain the architecture of this project" }
// Delegate autonomous work (waits for completion)
{ "prompt": "Refactor auth to JWT and fix all tests" }
// Background refactor — poll while you keep working
{ "prompt": "Refactor the auth module to use JWT", "name": "JWT refactor" }
// → session_id: ...
{ "session_id": "..." }Every tool accepts: cwd (project root), effort (low | medium | high, default high).
Related MCP server: mcp-agent-review
Requirements
Node ≥ 18
claudeCLI v2.1.139+ installed and authenticated (claudeonce to log in). Background tasks (fire/check) requireclaude --bgandclaude agents --json.
Install
git clone https://github.com/JaimeJunr/claude-mcp-bridge.git
cd claude-mcp-bridge
npm install
npm run buildRegister in an MCP host
Claude Code:
claude mcp add claude-bridge -s user -- node /abs/path/to/claude-mcp-bridge/dist/index.jsCursor / Codex / any host — add to its mcp.json:
{
"mcpServers": {
"claude-bridge": {
"command": "node",
"args": ["/abs/path/to/claude-mcp-bridge/dist/index.js"]
}
}
}Configuration (env)
Var | Default | Meaning |
|
| Path to the |
|
| Model alias — always Opus in this bridge. |
|
| Default reasoning effort. |
|
| Max agentic turns for |
|
| Permission mode for delegate/fire: |
|
| Per-call timeout for sync tools ( |
|
| Timeout for |
Security:
acceptEditslets delegated Opus edit files autonomously;bypassPermissionsadditionally allows unrestricted shell. Only raise this for trusted workspaces.askalways usesplan(read-only).
Develop
npm test # vitest — unit tests for arg building / json parsing
npm run dev # run from source via tsxLicense
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/JaimeJunr/claude-mcp-bridge'
If you have feedback or need assistance with the MCP directory API, please join our Discord server