Codex Docs Mcp

Overview

The Codex docs are available as a hosted Model Context Protocol (MCP) server. Add it to Claude, Cursor, ChatGPT, Claude Code, VS Code, Windsurf, or any MCP-compatible client, and your AI assistant can search and reference the full Codex API documentation as it works: every query, subscription, type, and guide behind graph.codex.io.

Ask in plain English. Your assistant looks up the right fields and writes a working GraphQL query, with no schema-hunting, no guessed field names, and no switching tabs to the docs.

Endpoint

https://docs.codex.io/mcp

Authentication

None. The documentation is public, so you add the server and start asking. To run the queries your assistant writes, you'll need a Codex API key, free at codex.io.

What you get

• Full coverage of the Codex GraphQL API: queries, subscriptions, types, enums, and guides, always in sync with the live schema.
• Correct queries on the first try, because your assistant reads real field names and arguments instead of guessing.
• Two ways in: semantic search across every page, plus a virtual filesystem your assistant can grep, read, and traverse like a codebase.
• The whole API surface at hand: real-time prices, OHLCV candles, trending tokens, pair and holder data, wallet balances, token metadata, new-launch feeds, and WebSocket streams.
• Every network Codex indexes, from Solana and Ethereum to Base and beyond.
• Free. It's documentation, so there are no keys to manage and no rate limits to juggle.

Try it

Once connected, ask your assistant things like:

• "Use the Codex API to fetch the current USD price of WETH on Ethereum."
• "Show me how to get the top 10 trending tokens on Base sorted by 24h volume."
• "Fetch 1-hour OHLCV candles for the last 24 hours for this token on Solana."
• "Set up a WebSocket subscription to stream real-time swap events for a token."
• "Get all token balances for a wallet on Base."
• "Find tokens launched in the last hour on Solana with at least $10k liquidity."

Install

Claude Code

claude mcp add --transport http codex-docs https://docs.codex.io/mcp

Claude Desktop / ChatGPT

Add a custom connector with the URL https://docs.codex.io/mcp.

Cursor

{
  "mcpServers": {
    "codex-docs": {
      "url": "https://docs.codex.io/mcp"
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "codex-docs": {
      "type": "http",
      "url": "https://docs.codex.io/mcp"
    }
  }
}

Windsurf (~/.codeium/windsurf/mcp_config.json)

{
  "mcpServers": {
    "codex-docs": {
      "serverUrl": "https://docs.codex.io/mcp"
    }
  }
}

Docs MCP vs Codex Skills

Two ways to put Codex knowledge inside your AI tools:

• Docs MCP searches the documentation on demand, so your assistant can look up any field and write a query. Best for discovery and one-off lookups.
• Codex Skills give your agent preloaded knowledge of the API (operations, auth, query templates) so it interfaces with the API directly, even offline. Best for agents that hit Codex regularly.

Use both: Skills for the common paths, Docs MCP for the long tail.