codex MCP Server

Use This MCP server To

Provide real-time enriched blockchain data to MCP clients Integrate blockchain context into AI workflows and agents Enable blockchain data querying within MCP-compatible applications Support development of blockchain-aware AI copilots and assistants Facilitate multi-step reasoning with live blockchain context Embed blockchain insights into developer tools and terminals

README

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

Open Claude Desktop settings
Go to the Developer tab and click "Edit Config"
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>"
      }
    }
  }
}

Replace /path/to/codex-mcp with the actual path to your installation
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 FAQ

How do I install the Codex MCP Server?

Clone the GitHub repo, install dependencies with pnpm, then build and start the server.

Can I run the Codex MCP Server without installation?

Yes, you can run it directly using npx without prior installation.

What do I need to use the Codex MCP Server?

You need a Codex API key, which you can obtain from the Codex Dashboard.

How do I start the server for development?

Use 'pnpm dev' to start the server with auto-reload for development.

Which MCP clients can connect to the Codex MCP Server?

Any MCP-compatible client, such as Claude Desktop, can connect to this server.

Does the server support real-time blockchain data updates?

Yes, it provides enriched blockchain data in real-time to connected clients.

Is the Codex MCP Server open source?

Yes, the source code is available on GitHub for review and contributions.

Can I embed the Codex MCP Server in CLI tools?

Yes, it supports stdio mode for embedding in command-line interface tools.