Codex MCP Bridge vs Claude MCP Bridge
A side-by-side look at the Codex MCP Bridge and Claude MCP Bridge MCP servers: transport, auth, tools, quality signals, and the config to install either one in Claude, Cursor, Windsurf or VS Code.
Verdict: choose Codex MCP Bridge for coding agents work as a local process; choose Claude MCP Bridge for coding agents as a local process. You can also run both side by side in one mcpServers block.
Which MCP server should you choose?
Choose Codex MCP Bridge when
- You need dedicated capabilities in the Coding Agents domain.
- You prefer a local stdio subprocess transport.
- Its auth model fits you: API key required.
- You have the keys it needs:
OPENAI_API_KEY, CODEX_MAX_CONCURRENT. - You want tools like
codex, search, query.
Choose Claude MCP Bridge when
- You need dedicated capabilities in the Coding Agents domain.
- You prefer a local stdio subprocess transport.
- Its auth model fits you: other.
- You want tools like
query, structured, search.
Feature & specification comparison
Rows where the two servers differ are marked.
| Spec | ||
|---|---|---|
| Category | Coding Agents | Coding Agents |
| Quality signal | 64/100 · Good | 64/100 · Good |
| Install command | Confirmed | Confirmed |
| Transport | Local subprocess (stdio) | Local subprocess (stdio) |
| Auth | API key required | other |
| Pricing | BYOK (pay the provider) | BYOK (pay the provider) |
| Required env vars | OPENAI_API_KEYCODEX_MAX_CONCURRENT | None listed |
| Verified owner | Community listing | Community listing |
| GitHub stars | 3 | 7 |
| Directory activity | 4 views 0 installs 0 upvotes | 6 views 0 installs 0 upvotes |
| Tools | 7 | 5 |
| Full listing | View Codex MCP Bridge | View Claude MCP Bridge |
Tools & capabilities
Codex MCP Bridge tools 7
codexExecute a prompt via Codex CLI. Codex is an AI coding agent that can generate, analyze, refactor, and explain code with full project context (reads AGENTS.md/CODEX.md automatically). Capabilities: code generation and refactoring, code analysis and explanation, file reading and modification (when sandbox allows), git operations and terminal commands, multi-turn conversations via sessionId. When to use a different tool: - For analysis of text you already have (plans, docs, opinions), inline it directly in the prompt rather than passing file paths. The files parameter triggers full file I/O and increases timeout pressure. Tips: - Set workingDirectory to the target repo for project-aware responses. - Use sandbox "read-only" (default) for analysis, "full-auto" for code changes. - Break complex tasks into focused prompts rather than one large request. - Resume multi-turn conversations with sessionId (returned in previous response metadata). - Include relevant files via the files parameter for targeted context (text and images supported). - Set reasoningEffort to control depth: "none" for trivial, "minimal" for lightweight, "low"/"medium" for routine, "high"/"xhigh" for deep analysis.searchWeb search via Codex CLI. Searches the web and synthesizes a comprehensive answer with source URLs. Use for current information, documentation lookups, API references, and research questions. Tips: - Ask specific, focused questions for best results. - Results include source URLs for verification. - Use maxResponseLength to control response verbosity. - Default timeout is 2 minutes; increase for complex research queries that may require multiple web fetches.queryLightweight query for analysis or opinions on text you already have. No file reading, no repo exploration, no session state. Pass text in the context parameter. For code execution or file operations, use the codex tool instead. Use cases: reviewing a plan, critiquing a draft, comparing approaches, answering questions about provided text, generating summaries. Tips: - Pass the text to analyze in the context parameter, not as file paths. - Set reasoningEffort to control depth: "none" for trivial, "minimal" for lightweight, "low"/"medium" for routine, "high"/"xhigh" for thorough analysis. - Use maxResponseLength to control verbosity.reviewRun Codex CLI's native diff-aware review via codex exec review --json. The bridge does not accept or bundle a review prompt; upstream Codex owns the reviewer instructions. Use for MCP clients that cannot run shell commands but need native Codex review of uncommitted changes, a base branch diff, or a single commit. Tips: - Set workingDirectory to the target git repository. - Choose mode "uncommitted", "base", or "commit". - Use the codex tool with sandbox "read-only" for free-form review prompts.structuredGenerate a JSON response conforming to a provided JSON Schema. Use for data extraction, classification, or any task needing machine-parseable output.listSessionsList active Codex conversation sessions. Returns session metadata for orchestration (no prompts or responses, just IDs and timing). Use to check available sessions before resuming with the codex tool's sessionId parameter.pingHealth check: verifies Codex CLI is installed and authenticated, reports versions and capabilities.
Claude MCP Bridge tools 5
queryExecute a prompt via Claude Code CLI with optional file context and session resume. Claude is an AI coding agent that can generate, analyze, refactor, and explain code. Capabilities: code generation and refactoring, code analysis and explanation, file understanding (text and images), multi-turn conversations via sessionId. Cost: Default model is Sonnet (~$0.01-0.10/call). Use effort="low" for simple tasks, effort="high" + model="opus" for complex analysis. Set maxBudgetUsd to cap per-call cost (recommended for effort="max" or model="opus"). Tips: - Set workingDirectory to the target repo for project-aware responses. - Break complex tasks into focused prompts rather than one large request. - Resume multi-turn conversations with sessionId from a previous response's metadata. - Include relevant files via the files parameter for targeted context (text files inlined in prompt, images trigger allowed-tools mode). - Use noSessionPersistence=true for stateless one-shot calls.structuredGenerate JSON conforming to a provided JSON Schema. Uses Claude CLI's native --json-schema flag for validated output (not client-side validation). Use for: data extraction from text/files, classification, entity parsing, or any task needing machine-parseable output. Cost: Similar to query (~$0.01-0.10/call). Schema complexity doesn't significantly affect cost. Tips: - Pass the JSON Schema as a JSON string in the schema parameter. - Schema max size: 20KB. Keep schemas focused for reliable output. - For extraction tasks, include source text via the files parameter or inline in the prompt.searchWeb search via Claude Code CLI using WebSearch and WebFetch tools. Searches the web and synthesizes a comprehensive answer with source URLs. Use for: current information, documentation lookups, API references, comparing libraries, and research questions. Cost: Typically ~$0.02-0.05/search with Sonnet. Tips: - Ask specific, focused questions for best results. - Results include source URLs for verification. - Use maxResponseLength to control response verbosity. - Increase timeout for complex research queries that may require multiple web fetches.listSessionsList active Claude CLI sessions tracked by this server. Returns session metadata (IDs, models, timing, turn counts, cumulative cost) for orchestration. Use to check available sessions before resuming with sessionId. No cost (local lookup only).pingHealth check: verifies Claude CLI is installed and authenticated, reports versions, capabilities, and configuration. No cost (local check only).
Ready-to-paste client configs
Paste either block (or both) into your client config, e.g. claude_desktop_config.json or ~/.cursor/mcp.json. We only show a config when the install command is confirmed.
Codex MCP Bridge
{
"mcpServers": {
"codex-mcp-bridge": {
"command": "npx",
"args": [
"-y",
"codex-mcp-bridge"
],
"env": {
"OPENAI_API_KEY": "YOUR_OPENAI_API_KEY_HERE",
"CODEX_MAX_CONCURRENT": "YOUR_CODEX_MAX_CONCURRENT_HERE"
}
}
}
}
Claude MCP Bridge
{
"mcpServers": {
"hampsterx-claude-mcp-bridge": {
"command": "npx",
"args": [
"-y",
"claude-mcp-bridge"
]
}
}
}
Frequently asked questions
Codex MCP Bridge is categorized under Coding Agents and uses a local stdio subprocess. Claude MCP Bridge belongs to Coding Agents and uses a local stdio subprocess. Pick Codex MCP Bridge for coding agents work and Claude MCP Bridge for coding agents.
Copy the mcpServers block from the config section on this page into your client's config (for example claude_desktop_config.json or ~/.cursor/mcp.json), then fully restart the client.
Codex MCP Bridge is bring-your-own-key: usage is billed by the API provider you supply a key for. Auth: api key required. Claude MCP Bridge is bring-your-own-key: usage is billed by the API provider you supply a key for. Auth: other. If a server needs environment variables such as API keys, define them under the env key in your client's MCP config.
Yes. MCP clients support multiple servers: add codex-mcp-bridge and hampsterx-claude-mcp-bridge as separate keys in the same mcpServers object, and your assistant will call tools from either one.
On AllMCPs, Codex MCP Bridge has a quality signal of 64/100 (Good) with 4 views, 0 installs and 3 GitHub stars. Claude MCP Bridge has 64/100 (Good) with 6 views, 0 installs and 7 GitHub stars.