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 — Pide a tu asistente que consulte consultas, suscripciones, tipos y guías de la documentación de Codex mientras programas.
  • Escribir consultas GraphQL — Describe los datos que quieres y pídele al asistente que consulte la documentación para redactar la consulta GraphQL de Codex correspondiente.
  • Consultar campos y tipos — Pide al asistente que encuentre campos, argumentos o definiciones de tipos específicos en la documentación de la API de Codex.
  • Consultar guías cuando las necesites — Pide que se busquen en la documentación guías o ejemplos relevantes durante una tarea.

Documentación

Codex Docs MCP

Añade el servidor MCP de documentación de Codex a Claude Code, Cursor y otras herramientas de programación con IA para que puedan buscar en la documentación de la API de Codex mientras desarrollas.

La documentación de Codex está disponible como servidor de Model Context Protocol (MCP). Al añadirlo a tu herramienta de programación con IA, esta podrá buscar y consultar directamente la documentación de la API de Codex, para que obtengas respuestas precisas sin salir del editor.

https://docs.codex.io/mcp

Qué hace

Una vez conectado, tu herramienta de IA podrá buscar en toda la documentación de la API de Codex, incluidas las consultas, las suscripciones, los tipos y las guías. Consultará la documentación automáticamente cuando hagas preguntas sobre la API de Codex o necesites ayuda para escribir consultas.

[!NOTE]

Este servidor MCP sirve para buscar en la documentación y ayudar a tu IA a escribir consultas. No se conecta directamente a la API de Codex: tendrás que ejecutar las consultas con tu clave de API a través del endpoint de GraphQL o del SDK.

MCP de documentación frente a Codex Skills

Codex Skills proporciona a tu agente de IA conocimientos precargados de la API para que pueda interactuar directamente con ella. El MCP de documentación le permite buscar en la documentación, lo que puede ayudarle a escribir consultas de GraphQL.

MCP de documentaciónCodex Skills
Cómo funcionaBusca en la documentación cuando se le solicita mediante el protocolo MCPConocimientos precargados de la API: operaciones, autenticación y plantillas
Ideal paraConsultar campos, tipos o guías específicosInteractuar directamente con la API de Codex
¿Necesita conexión a la red?Sí: consulta el servidor MCPFunciona sin conexión para escribir consultas (pero sigue necesitando conexión para llamar a la API)

Para disfrutar de la mejor experiencia, usa ambos a la vez: la skill se encarga de generar consultas y el MCP aporta detalles cuando hace falta.

Configuración

[!NOTE]

Codex (codex.io) es una API de datos de blockchain. No es OpenAI Codex, el agente de programación. Aun así, puedes añadir este servidor MCP a OpenAI Codex, como se muestra a continuación.

[tab] Cursor

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:

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

[tab] VS Code

Crea un archivo .vscode/mcp.json en la raíz del proyecto:

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

[tab] Windsurf

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

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

[tab] Claude Desktop

Ve a Settings > Connectors, selecciona Add custom connector y, a continuación, introduce:

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

[tab] Claude Code

Ejecuta el siguiente comando:

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

[tab] OpenAI Codex

Ejecuta:

codex mcp add codex-docs --url https://docs.codex.io/mcp

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

[mcp_servers.codex-docs]
url = "https://docs.codex.io/mcp"

Ejemplos de instrucciones

Una vez conectado el MCP, puedes pedirle a tu asistente de IA que cree funciones con 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 parecido a esto:

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

Crear un feed de tokens en tendencia

«Muéstrame cómo obtener los 10 tokens más populares de Base, ordenados por volumen de 24 h».

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

Mostrar 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 directo

«Configura una suscripción WebSocket para transmitir eventos de intercambio en tiempo real de un token en Ethereum».

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

Consultar las tenencias de una cartera

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

[!TIP]

No hace falta que memorices nada de esto: solo describe lo que quieres y tu asistente de IA buscará la consulta adecuada en la documentación. Los ejemplos anteriores solo muestran lo que puedes hacer.

Esta documentación se crea y aloja en Mintlify, una plataforma de documentación para desarrolladores.