Codex.io Docs MCP Server

oficial

MCP 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 MCPCodex Skills
Como funcionaPesquisa a documentação sob demanda via protocolo MCPConhecimento pré-carregado da API — operações, autenticação, modelos
Ideal paraBuscar campos, tipos ou guias específicosInteragir diretamente com a API da 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 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.