Codex MCP Server

1# Codex MCP Server
2 
3An [MCP](https://modelcontextprotocol.org/) server that provides enriched blockchain data from [Codex](https://codex.io). This server can be used with any MCP-compatible client like [Claude Desktop](https://www.anthropic.com/news/claude-desktop).
4 
5## Installation
6 
7```bash
8# Clone the repository
9git clone https://github.com/codex-data/codex-mcp.git
10cd codex-mcp
11 
12# Install dependencies
13pnpm install
14 
15# Build the project
16pnpm build
17```
18 
19## Usage
20 
21To use the MCP Codex Server, you need to have a Codex API key. You can get your key from the [Codex Dashboard](https://dashboard.codex.io).
22 
23### Using npx (No Installation Required)
24 
25You can run the MCP Codex Server directly without installation using npx:
26 
27```bash
28# Run the server in stdio mode (for CLI tools)
29npx @codex-data/codex-mcp
30```
31 
32### Running the Server Locally
33 
34Start the server using stdio (for embedding in CLI tools):
35 
36```bash
37pnpm start
38```
39 
40For development with auto-reload:
41 
42```bash
43pnpm dev
44```
45 
46### Integration with Claude Desktop
47 
481. Open Claude Desktop settings
492. Go to the Developer tab and click "Edit Config"
503. Add a new server configuration:
51 
52No installation:
53 
54```json
55{
56  "mcpServers": {
57    "codex-data": {
58      "command": "npx",
59      "args": ["-y", "@codex-data/codex-mcp"],
60      "env": {
61        "CODEX_API_KEY": "<your-codex-api-key>"
62      }
63    }
64  }
65}
66```
67 
68Local installation:
69 
70```json
71{
72  "mcpServers": {
73    "codex-data": {
74      "command": "node",
75      "args": ["/path/to/codex-mcp/build/index.js"],
76      "env": {
77        "CODEX_API_KEY": "<your-codex-api-key>"
78      }
79    }
80  }
81}
82```
83 
844. Replace `/path/to/codex-mcp` with the actual path to your installation
855. Replace `<your-codex-api-key>` with your actual Codex API key
86 
87### Connecting using Claude CLI
88 
89If you're using Claude CLI:
90 
91```bash
92# Add the MCP server
93claude mcp add codex-data -e CODEX_API_KEY=<your-codex-api-key> npx @codex-data/codex-mcp
94 
95# Start Claude with the MCP server enabled
96claude
97```
98 
99## License
100 
101ISC
102