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 buildUsage
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-mcpRunning the Server Locally
Start the server using stdio (for embedding in CLI tools):
pnpm startFor development with auto-reload:
pnpm devIntegration 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-mcpwith 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
claudeLicense
ISC
