Codex.io Docs MCP
oficialMCP 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ón | Codex Skills | |
|---|---|---|
| Cómo funciona | Busca en la documentación cuando se le solicita mediante el protocolo MCP | Conocimientos precargados de la API: operaciones, autenticación y plantillas |
| Ideal para | Consultar campos, tipos o guías específicos | Interactuar directamente con la API de Codex |
| ¿Necesita conexión a la red? | Sí: consulta el servidor MCP | Funciona 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) oCtrl+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.jsonen 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.jsony 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/mcpO 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.