Codex.io Docs MCP Server

oficial

MCP to read the Codex crypto data API so agents can write GraphQL queries.

Documentación

Codex Docs MCP

Añade el servidor MCP de documentación de Codex a tus herramientas de codificación con IA para acceder al instante a los documentos de la API.

La documentación de Codex está disponible como un servidor de Model Context Protocol (MCP). Añadirlo a tu herramienta de codificación con IA le permite buscar y consultar directamente los documentos de la API de Codex, para que puedas obtener respuestas precisas sin salir de tu editor.

https://docs.codex.io/mcp

Qué hace

Una vez conectado, tu herramienta de IA puede buscar en toda la documentación de la API de Codex — incluyendo consultas, suscripciones, tipos y guías. Hará referencia automáticamente a los documentos cuando hagas preguntas sobre la API de Codex o necesites ayuda para escribir consultas.

Este servidor MCP es para buscar en la documentación y ayudar a tu IA a escribir consultas. No interactúa directamente con la API de Codex — aún necesitarás ejecutar consultas usando tu clave API a través del [endpoint GraphQL](/learn-graphql) o el [SDK](/sdk).

Docs MCP vs Codex Skills

Las Codex Skills proporcionan a tu agente de IA conocimiento precargado de la API para que pueda interactuar directamente con ella. El Docs MCP le permite buscar en la documentación, lo que puede permitirle escribir consultas GraphQL.

	Docs MCP	Codex Skills
Cómo funciona	Busca en los documentos bajo demanda mediante el protocolo MCP	Conocimiento precargado de la API — operaciones, autenticación, plantillas
Ideal para	Buscar campos, tipos o guías específicos	Interactuar directamente con la API de Codex
¿Necesita red?	Sí — consulta el servidor MCP	Funciona sin conexión para escribir consultas (aún necesita conexión para llamar a la API)

Usa ambos juntos para la mejor experiencia: la skill maneja la generación de consultas y el MCP completa los detalles cuando sea necesario.

Configuración

Abre la configuración de MCP con `Cmd+Shift+P` (Mac) o `Ctrl+Shift+P` (Windows/Linux) y selecciona **Cursor Settings: Open MCP Settings**. Añade lo siguiente:

```json theme={null}
{
  "mcpServers": {
    "codex-docs": {
      "url": "https://docs.codex.io/mcp"
    }
  }
}
```

Crea un archivo `.vscode/mcp.json` en la raíz de tu proyecto:

```json theme={null}
{
  "servers": {
    "codex-docs": {
      "type": "http",
      "url": "https://docs.codex.io/mcp"
    }
  }
}
```

Abre el archivo de configuración de MCP en `~/.codeium/windsurf/mcp_config.json` y añade lo siguiente:

```json theme={null}
{
  "mcpServers": {
    "codex-docs": {
      "serverUrl": "https://docs.codex.io/mcp"
    }
  }
}
```

Ve a **Settings > Connectors**, selecciona **Add custom connector**, luego ingresa:

* **Name:** Codex Docs
* **URL:** `https://docs.codex.io/mcp`

Ejecuta el siguiente comando:

```bash theme={null}
claude mcp add --transport http codex-docs https://docs.codex.io/mcp
```

Ejemplos de prompts

Una vez que el MCP esté conectado, puedes pedirle a tu asistente de IA que construya funcionalidades usando la API de Codex. Aquí hay algunos ejemplos para empezar.

Obtener el precio de un token

"Usa la API de Codex para obtener el precio actual en USD de WETH en Ethereum."

Tu asistente buscará la consulta getTokenPrices y escribirá algo como:

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

Construir un feed de tokens en tendencia

"Muéstrame cómo obtener los 10 tokens en tendencia principales en Base ordenados por volumen en 24h."

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

Renderizar un gráfico de precios

"Obtén velas OHLCV de 1 hora para las últimas 24 horas para este token en Solana: So11111111111111111111111111111111111111112."

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

Transmitir operaciones en vivo

"Configura una suscripción WebSocket para transmitir eventos de swap en tiempo real para un token en Ethereum."

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

Rastrear tenencias de una billetera

"Obtén todos los saldos de tokens para una billetera en Base."

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

Descubrir nuevos lanzamientos

"Encuentra tokens lanzados en la última hora en Solana con al menos $10k de liquidez."

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
    }
  }
}

No necesitas memorizar nada de esto — solo describe lo que quieres y tu asistente de IA buscará la consulta correcta en los documentos. Los ejemplos anteriores son solo para mostrar lo que es posible.