Codex.io Docs MCP

Prediction Market data now in beta with Polymarket data for Growth and Enterprise plans. Get started →

Codex for Agents

Codex Docs MCP

The Codex documentation is available as a Model Context Protocol (MCP) server. Adding it to your AI coding tool lets it search and reference the Codex API docs directly, so you can get accurate answers without leaving your editor.

https://docs.codex.io/mcp

​

What it does

Once connected, your AI tool can search the full Codex API documentation — including queries, subscriptions, types, and guides. It will automatically reference the docs when you ask questions about the Codex API or need help writing queries.

This MCP server is for searching the documentation and helping your AI write queries. It does not interface with the Codex API directly — you’ll still need to execute queries using your API key via the GraphQL endpoint or the SDK.

​

Docs MCP vs Codex Skills

The Codex Skills gives your AI agent preloaded knowledge of the API so it can interface with the API directly. The Docs MCP lets it search the documentation, which can allow it to write GraphQL queries.

Docs MCP	Codex Skills
How it works	Searches docs on demand via MCP protocol	Preloaded API knowledge — operations, auth, templates
Best for	Looking up specific fields, types, or guides	Interacting with the Codex API directly
Needs network?	Yes — queries the MCP server	Works offline to write queries (still needs a connection to call the API)

Use both together for the best experience: the skill handles query generation and the MCP fills in details when needed.

​

Setup

• Cursor
• VS Code
• Windsurf
• Claude Desktop
• Claude Code

Open MCP settings with Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux) and select Cursor Settings: Open MCP Settings. Add the following:

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

​

Example prompts

Once the MCP is connected, you can ask your AI assistant to build features using the Codex API. Here are some examples to get started.

​

Get a token price

“Use the Codex API to fetch the current USD price of WETH on Ethereum.”

Your assistant will look up the getTokenPrices query and write something like:

query {
  getTokenPrices(
    inputs: [
      {
        address: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
        networkId: 1
      }
    ]
  ) {
    address
    priceUsd
  }
}

​

Build a trending tokens feed

“Show me how to get the top 10 trending tokens on Base sorted by 24h volume.”

query {
  filterTokens(
    filters: { network: [8453] }
    rankings: { attribute: volume24, direction: DESC }
    limit: 10
  ) {
    results {
      token {
        name
        symbol
        address
      }
      volume24
      priceUSD
      change24
    }
  }
}

​

Render a price chart

“Fetch 1-hour OHLCV candles for the last 24 hours for this token on Solana: So11111111111111111111111111111111111111112.”

query {
  getBars(
    symbol: "So11111111111111111111111111111111111111112:1399811149"
    from: 1719792000
    to: 1719878400
    resolution: "60"
  ) {
    o
    h
    l
    c
    volume
    t
  }
}

​

Stream live trades

“Set up a WebSocket subscription to stream real-time swap events for a token on Ethereum.”

subscription {
  onEventsCreated(
    address: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
    networkId: 1
  ) {
    address
    networkId
    events {
      eventDisplayType
      timestamp
      maker
      token0SwapValueUsd
      token1SwapValueUsd
      transactionHash
    }
  }
}

​

Track wallet holdings

“Get all token balances for a wallet on Base.”

query {
  balances(
    input: {
      walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      networks: [8453]
    }
  ) {
    items {
      tokenAddress
      balance
      shiftedBalance
      token {
        name
        symbol
      }
    }
  }
}

​

Discover new launches

“Find tokens launched in the last hour on Solana with at least $10k liquidity.”

query {
  filterTokens(
    filters: {
      network: [1399811149]
      liquidity: { gte: 10000 }
      createdAt: { gte: 1719874800 }
    }
    rankings: { attribute: createdAt, direction: DESC }
    limit: 20
  ) {
    results {
      token {
        name
        symbol
        address
      }
      liquidity
      priceUSD
      createdAt
    }
  }
}

You don’t need to memorize any of this — just describe what you want and your AI assistant will look up the right query from the docs. The examples above are just to show what’s possible.

Was this page helpful?

YesNo

Codex Skills