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 — 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 MCP | Codex Skills | |
|---|---|---|
| Cómo funciona | Busca en la documentación bajo demanda mediante el protocolo MCP | Conocimiento precargado de la API: operaciones, autenticación, plantillas |
| Ideal para | Consultar 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 gestiona 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: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.
```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.