Codex.io Docs MCP Server
oficialMCP para ler a API de dados cripto do Codex, permitindo que agentes escrevam consultas GraphQL.
Documentação
Codex Docs MCP
Adicione o servidor MCP de documentação da Codex às suas ferramentas de codificação com IA para acesso instantâneo à documentação da API.
A documentação da Codex está disponível como um servidor Model Context Protocol (MCP). Adicioná-lo à sua ferramenta de codificação com IA permite que ela pesquise e faça referência direta à documentação da API da Codex, para que você obtenha respostas precisas sem sair do seu editor.
https://docs.codex.io/mcp
O que ele faz
Uma vez conectado, sua ferramenta de IA pode pesquisar toda a documentação da API da Codex — incluindo consultas, assinaturas, tipos e guias. Ela fará referência automática à documentação quando você fizer perguntas sobre a API da Codex ou precisar de ajuda para escrever consultas.
Este servidor MCP é para pesquisar a documentação e ajudar sua IA a escrever consultas. Ele não faz interface direta com a API da Codex — você ainda precisará executar consultas usando sua chave de API via [GraphQL endpoint](/learn-graphql) ou o [SDK](/sdk).Docs MCP vs Codex Skills
O Codex Skills fornece ao seu agente de IA conhecimento pré-carregado da API para que ele possa interagir diretamente com a API. O Docs MCP permite que ele pesquise a documentação, o que pode permitir que ele escreva consultas GraphQL.
| Docs MCP | Codex Skills | |
|---|---|---|
| Como funciona | Pesquisa a documentação sob demanda via protocolo MCP | Conhecimento pré-carregado da API — operações, autenticação, modelos |
| Ideal para | Buscar campos, tipos ou guias específicos | Interagir diretamente com a API da 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 a melhor experiência: a skill cuida da geração de consultas e o MCP preenche os detalhes quando necessário.
Configuração
Abra as configurações do MCP com `Cmd+Shift+P` (Mac) ou `Ctrl+Shift+P` (Windows/Linux) e selecione **Cursor Settings: Open MCP Settings**. Adicione o seguinte:```json theme={null}
{
"mcpServers": {
"codex-docs": {
"url": "https://docs.codex.io/mcp"
}
}
}
```
Crie um arquivo `.vscode/mcp.json` na raiz do seu projeto:
```json theme={null}
{
"servers": {
"codex-docs": {
"type": "http",
"url": "https://docs.codex.io/mcp"
}
}
}
```
Abra o arquivo de configuração do MCP em `~/.codeium/windsurf/mcp_config.json` e adicione o seguinte:
```json theme={null}
{
"mcpServers": {
"codex-docs": {
"serverUrl": "https://docs.codex.io/mcp"
}
}
}
```
Vá para **Settings > Connectors**, selecione **Add custom connector** e insira:
* **Name:** Codex Docs
* **URL:** `https://docs.codex.io/mcp`
Execute o seguinte comando:
```bash theme={null}
claude mcp add --transport http codex-docs https://docs.codex.io/mcp
```
Exemplos de prompts
Uma vez que o MCP esteja conectado, você pode pedir ao seu assistente de IA para construir funcionalidades usando a API da Codex. Aqui estão alguns exemplos para começar.
Obter o preço de um token
"Use a API da Codex para buscar o preço atual em USD do WETH na Ethereum."
Seu assistente irá procurar a consulta getTokenPrices e escrever algo como:
query {
getTokenPrices(
inputs: [
{
address: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
networkId: 1
}
]
) {
address
priceUsd
}
}
Construir um feed de tokens em tendência
"Mostre-me como obter os 10 principais tokens em tendência na Base ordenados por volume em 24h."
query {
filterTokens(
filters: { network: [8453] }
rankings: { attribute: volume24, direction: DESC }
limit: 10
) {
results {
token {
name
symbol
address
}
volume24
priceUSD
change24
}
}
}
Renderizar um gráfico de preços
"Busque velas OHLCV de 1 hora para as ú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 para um token na Ethereum."
subscription {
onEventsCreated(
address: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
networkId: 1
) {
address
networkId
events {
eventDisplayType
timestamp
maker
token0SwapValueUsd
token1SwapValueUsd
transactionHash
}
}
}
Rastrear ativos de uma carteira
"Obtenha todos os saldos de tokens para 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
}
}
}
Você não precisa memorizar nada disso — apenas descreva o que deseja e seu assistente de IA irá procurar a consulta certa na documentação. Os exemplos acima são apenas para mostrar o que é possível.