Archestra Logo
Star us on GitHub ⭐
Back to Catalog

Codex

Codex-Data/codex-mcp
🕒 Updated:Sep 9, 2025, 01:06 PM
TypeScript
AI Tools

A Model Context Protocol server for the Codex API

MCP Trust Score
Based on our comprehensive evaluation criteria
🤖 Evaluated by gemini-2.5-flashFix
Trust Score42/100
GitHub Metrics
Repository statistics and activity
⭐ GitHub Stars:16
👥 Contributors:0
📋 Total Issues:0
📦 Has Releases:No
🔧 Has CI/CD Pipeline:Yes
Configuration
Configuration example extracted from README.md for Claude Desktop and other clients.
🤖 Evaluated by gemini-2.5-flashFix
{
  "codex-data-codex-mcp-stdio": {
    "command": "npx",
    "args": [
      "@codex-data/codex-mcp"
    ],
    "env": {}
  },
  "codex-data-codex-mcp-configured": {
    "command": "npx",
    "args": [
      "-y",
      "@codex-data/codex-mcp"
    ],
    "env": {
      "CODEX_API_KEY": "<your-codex-api-key>"
    }
  },
  "codex-data-codex-mcp-local-configured": {
    "command": "node",
    "args": [
      "/path/to/codex-mcp/build/index.js"
    ],
    "env": {
      "CODEX_API_KEY": "<your-codex-api-key>"
    }
  },
  "codex-data-codex-mcp-cli-configured": {
    "command": "npx",
    "args": [
      "@codex-data/codex-mcp"
    ],
    "env": {
      "CODEX_API_KEY": "<your-codex-api-key>"
    }
  }
}
MCP Protocol Support
Implemented MCP protocol features
🤖 Evaluated by gemini-2.5-flashFix
Tools:✗
Prompts:✗
Resources:✗
Sampling:✗
Roots:✗
Logging:✗
STDIO Transport:✓
HTTP Transport:✗
OAuth2 Auth:✗
Dependencies
3 dependencies
Libraries and frameworks used by this MCP server
🤖 Evaluated by gemini-2.5-flashFix
Resources
GitHub Repository
Add Quality Badge
Show your MCP trust score in your README
Trust Score Badge
[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/Codex-Data/codex-mcp)](https://archestra.ai/mcp-catalog/codex-data__codex-mcp)
Edit This ServerAdd New MCP ServerReport an Issue
README.md

Codex MCP Server

An MCP server that provides enriched blockchain data from Codex. This server can be used with any MCP-compatible client like Claude Desktop.

Installation

# Clone the repository
git clone https://github.com/codex-data/codex-mcp.git
cd codex-mcp

# Install dependencies
pnpm install

# Build the project
pnpm build

Usage

To use the MCP Codex Server, you need to have a Codex API key. You can get your key from the Codex Dashboard.

Using npx (No Installation Required)

You can run the MCP Codex Server directly without installation using npx:

# Run the server in stdio mode (for CLI tools)
npx @codex-data/codex-mcp

Running the Server Locally

Start the server using stdio (for embedding in CLI tools):

pnpm start

For development with auto-reload:

pnpm dev

Integration with Claude Desktop

  1. Open Claude Desktop settings
  2. Go to the Developer tab and click "Edit Config"
  3. Add a new server configuration:

No installation:

{
  "mcpServers": {
    "codex-data": {
      "command": "npx",
      "args": ["-y", "@codex-data/codex-mcp"],
      "env": {
        "CODEX_API_KEY": "<your-codex-api-key>"
      }
    }
  }
}

Local installation:

{
  "mcpServers": {
    "codex-data": {
      "command": "node",
      "args": ["/path/to/codex-mcp/build/index.js"],
      "env": {
        "CODEX_API_KEY": "<your-codex-api-key>"
      }
    }
  }
}
  1. Replace /path/to/codex-mcp with the actual path to your installation
  2. Replace <your-codex-api-key> with your actual Codex API key

Connecting using Claude CLI

If you're using Claude CLI:

# Add the MCP server
claude mcp add codex-data -e CODEX_API_KEY=<your-codex-api-key> npx @codex-data/codex-mcp

# Start Claude with the MCP server enabled
claude

License

ISC

Codex MCP Server | Documentation & Integration | Archestra