MCP.Market

Codex Bridge MCP server

by hampsterx·io.github.hampsterx/codex-mcp-bridge·v0.9.1·3 stars
No reviews yet

Wraps Codex CLI as MCP tools: codex, review, query, search, structured, ping, listSessions.

A92/100grade A
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
A92/100

full report

Adoption
Growing

3 stars39 downloads/wk

Reviews

Write one

Nobody has reviewed Codex Bridge yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Codex Bridge tools (7, 1 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • codex
  • listSessions

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

  • ping

    Health check: verifies Codex CLI is installed and authenticated, reports versions and capabilities.

  • query

    Lightweight 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 th

  • reviewwrite action

    Run 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 "uncommitte

  • search

    Web 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 co

  • structured

    Generate a JSON response conforming to a provided JSON Schema. Use for data extraction, classification, or any task needing machine-parseable output.

Public scan report

scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it

no findings
  • Code scan49 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 26 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 92/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Codex Bridge compares

Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
92/100
higher than 90% of 3,470 Web search servers
Tools
7
the typical Web search server has 5
Tools that change things
14%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
3
more than 73% of 1,786 Web search servers
Downloads a week
39
more than 25% of 827 Web search servers with a package

What its tools let an agent do: 6 read · 1 change

Install Codex Bridge in Claude Code, Cursor or VS Code

Runs npx -y codex-mcp-bridge on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add codex-mcp-bridge -- npx -y codex-mcp-bridge
Add to Cursor

What the publisher says

From the Codex Bridge repository's README, as published. We do not edit it. Read it on GitHub

codex-mcp-bridge

MCP server that wraps Codex CLI as a subprocess, exposing code execution, web search, and structured output as Model Context Protocol tools.

Works with any MCP client: Claude Code, Gemini CLI, Cursor, Windsurf, VS Code, or any tool that speaks MCP.

Do you need this?

If you're in a terminal agent (Claude Code, Codex CLI, Gemini CLI) with shell access, call Codex CLI directly. It's faster, cheaper, and zero overhead:

# Review current branch vs main
codex review --base main

# Review uncommitted changes
codex review --uncommitted

# Review with custom focus
codex review --base main "Focus on security and error handling"

# From a worktree (run inside the worktree; `-C` is broken for `review`)
cd /path/to/worktree && codex review --base main

# General analysis
codex exec "Analyze src/utils/parse.ts for edge cases"

Use this MCP bridge instead when:

quota exhaustion

  • Your client has no shell access (Cursor, Windsurf, Claude Desktop, VS Code)
  • You need structured output with JSON Schema validation (Codex CLI's --json has known bugs)
  • You need partial response capture on timeout and automatic model fallback on

secret redaction on output, FIFO-queued concurrency (max 3 parallel spawns, configurable via CODEXMAXCONCURRENT)

  • You want subprocess isolation: explicit env allowlist, no shell escape,

resetSession, inspected via listSessions)

  • You need multi-turn conversations via session resume (sessionId /

Worktree note: Codex CLI issue #9084 breaks codex -C /path review .... Run codex review from inside the worktree to avoid it.

Quick Start

npx codex-mcp-bridge

Prerequisites

  • Codex CLI installed (npm i -g @openai/codex)
  • OPENAIAPIKEY environment variable set, or codex auth login completed

Claude Code

claude mcp add codex-bridge -- npx -y codex-mcp-bridge

Gemini CLI

Add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "codex-bridge": {
      "command": "npx",
      "args": ["-y", "codex-mcp-bridge"]
    }
  }
}

Cursor / Windsurf / VS Code

Add to your MCP settings:

{
  "codex-bridge": {
    "command": "npx",
    "args": ["-y", "codex-mcp-bridge"],
    "env": {
      "OPENAI_API_KEY": "sk-..."
    }
  }
}

Tools

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Codex Bridge: common questions

Is Codex Bridge MCP server safe?
Yes, by our scan: it is graded A (92/100). Read the Codex Bridge safety report
How do I install Codex Bridge?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Codex Bridge need an API key?
No secret keys are declared. It reads 5 settings from the environment.
Is Codex Bridge maintained?
The last commit was 67 days ago (2026-08-29). The latest release is v0.9.1.
What can I use instead of Codex Bridge?
Servers from other publishers that do the same job: HasData Yelp MCP server, Claude Code Explorer MCP server and webclaw MCP server.
How does Codex Bridge compare with other Web search MCP servers?
safety score 92/100 (higher than 90% of 3,470 Web search servers); tools 7 (the typical Web search server has 5); tools that change things 14% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Codex Bridge

Same job from other publishers: the closest match first, then the best rated.

  • HasData Yelp
    Yelp business search, place details and the full review feed, as structured JSON.
    More from hasdata.com →
    A
  • Claude Code Explorer MCP
    Explore the Claude Code CLI source — browse tools, commands, search code, and more.
    A
  • webclaw
    Web scraping, search, crawling, structured extraction and research for AI agents.
    A
  • Claude Code Explorer MCP
    Explore the Claude Code CLI source — browse tools, commands, search code, and more.
    A
  • Crg
    Token-efficient code review knowledge graph: semantic search and call-graph resolution.
    B