Codex.io Docs MCP
oficialMCP para ler a API de dados cripto do Codex, permitindo que agentes escrevam consultas GraphQL.
O que você pode fazer com Codex Io Docs MCP?
- Pesquisar na documentação da API Codex — Peça ao seu assistente para consultar queries, subscriptions, tipos e guias da documentação do Codex enquanto você programa.
- Escrever queries GraphQL — Descreva os dados que você quer e peça ao assistente para consultar a documentação e elaborar a query GraphQL correspondente do Codex.
- Consultar campos e tipos — Peça ao assistente para encontrar campos, argumentos ou definições de tipos específicos na documentação da API Codex.
- Consultar guias quando necessário — Peça para buscar guias ou exemplos relevantes do Codex na documentação durante uma tarefa.
Documentação
MCP de documentação do Codex
Adicione o servidor MCP da documentação do Codex ao Claude Code, Cursor e outras ferramentas de programação com IA para que elas possam pesquisar os documentos da API do Codex enquanto você desenvolve.
A documentação do Codex está disponível como um servidor Model Context Protocol (MCP). Ao adicioná-lo à sua ferramenta de programação com IA, ela poderá pesquisar e consultar diretamente os documentos da API do Codex, para que você obtenha respostas precisas sem sair do editor.
https://docs.codex.io/mcp
O que ele faz
Depois de conectado, sua ferramenta de IA poderá pesquisar toda a documentação da API do Codex — incluindo consultas, assinaturas, tipos e guias. Ela consultará os documentos automaticamente quando você fizer perguntas sobre a API do Codex ou precisar de ajuda para escrever consultas.
[!NOTE]
Este servidor MCP serve para pesquisar a documentação e ajudar sua IA a escrever consultas. Ele não se comunica diretamente com a API do Codex — você ainda precisará executar as consultas usando sua chave de API pelo endpoint GraphQL ou pelo SDK.
MCP de documentação vs. habilidades do Codex
As habilidades do Codex fornecem ao seu agente de IA conhecimento pré-carregado da API para que ele possa interagir diretamente com ela. O MCP de documentação permite pesquisar os documentos, o que pode ajudá-lo a escrever consultas GraphQL.
| MCP de documentação | Habilidades do Codex | |
|---|---|---|
| Como funciona | Pesquisa os documentos sob demanda pelo protocolo MCP | Conhecimento da API pré-carregado — operações, autenticação, modelos |
| Ideal para | Consultar campos, tipos ou guias específicos | Interagir diretamente com a API do Codex |
| Precisa de rede? | Sim — consulta o servidor MCP | Funciona offline para escrever consultas (ainda precisa de conexão para chamar a API) |
Use ambos juntos para ter a melhor experiência: a habilidade cuida da geração de consultas, e o MCP complementa com detalhes quando necessário.
Configuração
[!NOTE]
Codex (codex.io) é uma API de dados de blockchain. Não é o OpenAI Codex, o agente de programação. Ainda assim, você pode adicionar este servidor MCP ao OpenAI Codex, conforme mostrado abaixo.
[tab] Cursor
Abra as configurações do MCP com
Cmd+Shift+P(Mac) ouCtrl+Shift+P(Windows/Linux) e selecione Cursor Settings: Open MCP Settings. Adicione o seguinte:{ "mcpServers": { "codex-docs": { "url": "https://docs.codex.io/mcp" } } }
[tab] VS Code
Crie um arquivo
.vscode/mcp.jsonna raiz do projeto:{ "servers": { "codex-docs": { "type": "http", "url": "https://docs.codex.io/mcp" } } }
[tab] Windsurf
Abra o arquivo de configuração do MCP em
~/.codeium/windsurf/mcp_config.jsone adicione o seguinte:{ "mcpServers": { "codex-docs": { "serverUrl": "https://docs.codex.io/mcp" } } }
[tab] Claude Desktop
Acesse Settings > Connectors, selecione Add custom connector e informe:
- Name: Codex Docs
- URL:
https://docs.codex.io/mcp
[tab] Claude Code
Execute o seguinte comando:
claude mcp add --transport http codex-docs https://docs.codex.io/mcp
[tab] OpenAI Codex
Execute:
codex mcp add codex-docs --url https://docs.codex.io/mcpOu adicione isto a
~/.codex/config.toml:[mcp_servers.codex-docs] url = "https://docs.codex.io/mcp"
Exemplos de prompts
Depois que o MCP estiver conectado, você poderá pedir ao seu assistente de IA para criar funcionalidades usando a API do Codex. Veja alguns exemplos para começar.
Obter o preço de um token
"Use a API do Codex para buscar o preço atual em USD de WETH na Ethereum."
Seu assistente consultará a consulta getTokenPrices e escreverá algo como:
query {
getTokenPrices(
inputs: [
{
address: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
networkId: 1
}
]
) {
address
priceUsd
}
}
Criar um feed de tokens em alta
"Mostre como obter os 10 tokens em alta na Base, ordenados pelo volume de 24 horas."
query {
filterTokens(
filters: { network: [8453] }
rankings: [{ attribute: volume24, direction: DESC }]
limit: 10
) {
results {
token {
name
symbol
address
}
volume24
priceUSD
change24
}
}
}
Exibir um gráfico de preços
"Busque candles OHLCV de 1 hora das últimas 24 horas para este token na Solana:
So11111111111111111111111111111111111111112."
query {
getBars(
symbol: "So11111111111111111111111111111111111111112:1399811149"
from: 1719792000
to: 1719878400
resolution: "60"
) {
o
h
l
c
volume
t
}
}
Transmitir negociações ao vivo
"Configure uma assinatura WebSocket para transmitir eventos de swap em tempo real de um token na Ethereum."
subscription {
onEventsCreated(
address: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
networkId: 1
) {
address
networkId
events {
eventDisplayType
timestamp
maker
token0SwapValueUsd
token1SwapValueUsd
transactionHash
}
}
}
Acompanhar saldos de carteira
"Obtenha todos os saldos de tokens de uma carteira na Base."
query {
balances(
input: {
walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
networks: [8453]
}
) {
items {
tokenAddress
balance
shiftedBalance
token {
name
symbol
}
}
}
}
Descobrir novos lançamentos
"Encontre tokens lançados na última hora na Solana com pelo 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]
Você não precisa memorizar nada disso — basta descrever o que deseja, e seu assistente de IA consultará a documentação para encontrar a consulta certa. Os exemplos acima servem apenas para mostrar o que é possível fazer.
Esta documentação é criada e hospedada na Mintlify, uma plataforma de documentação para desenvolvedores.