Codex.io Docs MCP

oficial

MCP 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çãoHabilidades do Codex
Como funcionaPesquisa os documentos sob demanda pelo protocolo MCPConhecimento da API pré-carregado — operações, autenticação, modelos
Ideal paraConsultar campos, tipos ou guias específicosInteragir diretamente com a API do Codex
Precisa de rede?Sim — consulta o servidor MCPFunciona 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) ou Ctrl+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.json na 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.json e 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/mcp

Ou 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.