Codex.io Docs MCP

oficial

MCP para leer la API de datos cripto de Codex para que los agentes puedan escribir consultas GraphQL.

¿Qué puedes hacer con Codex Io Docs MCP?

  • Buscar en la documentación de la API de Codex — Pídele a tu asistente que consulte consultas, suscripciones, tipos o guías de toda la documentación de Codex a través de https://docs.codex.io/mcp.
  • Generar consultas GraphQL — Haz que tu asistente escriba consultas como obtener precios de tokens, tokens en tendencia o saldos de billeteras describiendo lo que necesitas en lenguaje sencillo.
  • Crear funciones de datos en tiempo real — Solicita suscripciones WebSocket para transmitir eventos de swaps en vivo o rastrear gráficos de precios de tokens con datos de velas OHLCV.
  • Descubrir nuevos tokens — Solicita listas de tokens filtradas según criterios como tiempo de lanzamiento, liquidez o volumen de negociación directamente desde la documentación.

Documentación

Codex Docs MCP

Añade el servidor MCP de documentación de Codex a tus herramientas de codificación con IA para acceso instantáneo a la documentación de la API.

La documentación de Codex está disponible como un servidor Model Context Protocol (MCP). Añadirlo a tu herramienta de codificación con IA le permite buscar y consultar la documentación de la API de Codex directamente, 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ática a la documentación cuando hagas preguntas sobre la API de Codex o necesites ayuda para escribir consultas.

Información

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 de API a través del endpoint GraphQL o el SDK.

Docs MCP vs Codex Skills

Codex Skills le da 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 MCPCodex Skills
Cómo funcionaBusca en la documentación bajo demanda mediante el protocolo MCPConocimiento precargado de la API: operaciones, autenticación, plantillas
Ideal paraConsultar campos, tipos o guías específicosInteractuar directamente con la API de Codex
¿Necesita red?Sí: consulta el servidor MCPFunciona 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 gestiona la generación de consultas y el MCP completa los detalles cuando sea necesario.

Configuración

Nota

Codex (codex.io) es una API de datos blockchain. No es OpenAI Codex, el agente de codificación. Aún puedes añadir este servidor MCP a OpenAI Codex, como se muestra a continuació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** y luego introduce:
* **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
```
Ejecuta:
```bash theme={null}
codex mcp add codex-docs --url https://docs.codex.io/mcp
```

O añade esto a `~/.codex/config.toml`:

```toml theme={null}
[mcp_servers.codex-docs]
url = "https://docs.codex.io/mcp"
```

Ejemplos de prompts

Una vez que el MCP esté conectado, puedes pedirle a tu asistente de IA que cree funciones usando la API de Codex. Aquí tienes 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
  }
}

Crear un feed de tokens en tendencia

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

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 de 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 carteras

"Obtén todos los saldos de tokens de una cartera 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
    }
  }
}

Consejo

No necesitas memorizar nada de esto: solo describe lo que quieres y tu asistente de IA buscará la consulta correcta en la documentación. Los ejemplos anteriores solo muestran lo que es posible.

Esta documentación está construida y alojada en Mintlify, una plataforma de documentación para desarrolladores.