Codex.io Docs MCP

Codex Docs MCP

Adicione o servidor MCP de documentação do Codex às suas ferramentas de codificação com IA para acesso instantâneo à documentação da API.

A documentação do 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 consulte a documentação da API do Codex diretamente, 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 do Codex — incluindo consultas, assinaturas, tipos e guias. Ela fará referência automática à documentação quando você fizer perguntas sobre a API do Codex ou precisar de ajuda para escrever consultas.

Info

Este servidor MCP serve para pesquisar a documentação e ajudar sua IA a escrever consultas. Ele não interage diretamente com a API do Codex — você ainda precisará executar consultas usando sua chave de API por meio do endpoint GraphQL ou do SDK.

Docs MCP vs Codex Skills

O Codex Skills dá 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 documentos sob demanda via protocolo MCP	Conhecimento pré-carregado da API — operações, autenticação, modelos
Melhor 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 a melhor experiência: a skill cuida da geração de consultas e o MCP preenche os detalhes quando necessário.

Configuração

Nota

Codex (codex.io) é uma API de dados blockchain. Não é o OpenAI Codex, o agente de codificação. Você ainda pode adicionar este servidor MCP ao OpenAI Codex, como mostrado abaixo.

Abra as configurações de 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 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
```

Execute:

```bash theme={null}
codex mcp add codex-docs --url https://docs.codex.io/mcp
```

Ou adicione isso ao `~/.codex/config.toml`:

```toml theme={null}
[mcp_servers.codex-docs]
url = "https://docs.codex.io/mcp"
```

Exemplos de prompts

Uma vez que o MCP esteja conectado, você pode pedir ao seu assistente de IA para criar recursos usando a API do Codex. Aqui estão 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 do 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-me como obter os 10 principais tokens em alta na Base ordenados por volume de 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 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 para um token na Ethereum."

subscription {
  onEventsCreated(
    address: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
    networkId: 1
  ) {
    address
    networkId
    events {
      eventDisplayType
      timestamp
      maker
      token0SwapValueUsd
      token1SwapValueUsd
      transactionHash
    }
  }
}

Rastrear 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
    }
  }
}

Dica

Você não precisa memorizar nada disso — apenas descreva o que deseja e seu assistente de IA consultará a consulta certa na documentação. Os exemplos acima servem apenas para mostrar o que é possível.

Esta documentação é construída e hospedada no Mintlify, uma plataforma de documentação para desenvolvedores.