Codex.io Docs MCP

officiel

MCP pour lire l'API de données crypto Codex afin que les agents puissent écrire des requêtes GraphQL.

Que pouvez-vous faire avec Codex Io Docs MCP ?

  • Rechercher dans la documentation de l’API Codex — Demandez à votre assistant de rechercher des requêtes, des abonnements, des types et des guides dans la documentation de Codex pendant que vous codez.
  • Écrire des requêtes GraphQL — Décrivez les données que vous souhaitez obtenir et demandez à l’assistant de consulter la documentation pour rédiger la requête GraphQL Codex correspondante.
  • Rechercher des champs et des types — Demandez à l’assistant de trouver des champs, des arguments ou des définitions de types spécifiques dans la documentation de l’API Codex.
  • Consulter des guides à la demande — Demandez à l’assistant d’extraire de la documentation les guides ou exemples Codex pertinents pendant une tâche.

Documentation

Codex Docs MCP

Ajoutez le serveur MCP de la documentation Codex à Claude Code, Cursor et à d’autres outils de programmation IA pour qu’ils puissent rechercher dans la documentation de l’API Codex pendant que vous développez.

La documentation Codex est disponible sous la forme d’un serveur Model Context Protocol (MCP). En l’ajoutant à votre outil de programmation IA, vous lui permettez de rechercher et de consulter directement la documentation de l’API Codex, afin d’obtenir des réponses précises sans quitter votre éditeur.

https://docs.codex.io/mcp

Fonctionnement

Une fois connecté, votre outil IA peut rechercher dans l’ensemble de la documentation de l’API Codex, y compris les requêtes, les abonnements, les types et les guides. Il consultera automatiquement la documentation lorsque vous poserez des questions sur l’API Codex ou aurez besoin d’aide pour rédiger des requêtes.

[!NOTE]

Ce serveur MCP sert à rechercher dans la documentation et à aider votre IA à rédiger des requêtes. Il n’interagit pas directement avec l’API Codex : vous devrez toujours exécuter les requêtes à l’aide de votre clé API via le point de terminaison GraphQL ou le SDK.

Docs MCP et Codex Skills

Codex Skills fournit à votre agent IA des connaissances préchargées sur l’API, afin qu’il puisse interagir directement avec celle-ci. Docs MCP lui permet de rechercher dans la documentation, ce qui peut l’aider à rédiger des requêtes GraphQL.

Docs MCPCodex Skills
FonctionnementRecherche dans la documentation à la demande via le protocole MCPConnaissances préchargées de l’API — opérations, authentification, modèles
Idéal pourRechercher des champs, des types ou des guides spécifiquesInteragir directement avec l’API Codex
Connexion réseau requise ?Oui — interroge le serveur MCPFonctionne hors ligne pour rédiger des requêtes (une connexion reste nécessaire pour appeler l’API)

Utilisez les deux ensemble pour une expérience optimale : le skill se charge de générer les requêtes et le MCP apporte des précisions au besoin.

Configuration

[!NOTE]

Codex (codex.io) est une API de données blockchain. Il ne s’agit pas d’OpenAI Codex, l’agent de programmation. Vous pouvez tout de même ajouter ce serveur MCP à OpenAI Codex, comme indiqué ci-dessous.

[tab] Cursor

Ouvrez les paramètres MCP avec Cmd+Shift+P (Mac) ou Ctrl+Shift+P (Windows/Linux), puis sélectionnez Cursor Settings: Open MCP Settings. Ajoutez ce qui suit :

{
  "mcpServers": {
    "codex-docs": {
      "url": "https://docs.codex.io/mcp"
    }
  }
}

[tab] VS Code

Créez un fichier .vscode/mcp.json à la racine de votre projet :

{
  "servers": {
    "codex-docs": {
      "type": "http",
      "url": "https://docs.codex.io/mcp"
    }
  }
}

[tab] Windsurf

Ouvrez le fichier de configuration MCP à l’emplacement ~/.codeium/windsurf/mcp_config.json et ajoutez ce qui suit :

{
  "mcpServers": {
    "codex-docs": {
      "serverUrl": "https://docs.codex.io/mcp"
    }
  }
}

[tab] Claude Desktop

Accédez à Settings > Connectors, sélectionnez Add custom connector, puis saisissez :

  • Name: Codex Docs
  • URL: https://docs.codex.io/mcp

[tab] Claude Code

Exécutez la commande suivante :

claude mcp add --transport http codex-docs https://docs.codex.io/mcp

[tab] OpenAI Codex

Exécutez :

codex mcp add codex-docs --url https://docs.codex.io/mcp

Ou ajoutez ceci à ~/.codex/config.toml :

[mcp_servers.codex-docs]
url = "https://docs.codex.io/mcp"

Exemples de requêtes

Une fois le MCP connecté, vous pouvez demander à votre assistant IA de créer des fonctionnalités à l’aide de l’API Codex. Voici quelques exemples pour commencer.

Obtenir le prix d’un jeton

« Utilise l’API Codex pour récupérer le prix actuel en USD de WETH sur Ethereum. »

Votre assistant recherchera la requête getTokenPrices et rédigera quelque chose comme :

query {
  getTokenPrices(
    inputs: [
      {
        address: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
        networkId: 1
      }
    ]
  ) {
    address
    priceUsd
  }
}

Créer un flux de jetons tendance

« Montre-moi comment récupérer les 10 jetons tendance les plus populaires sur Base, triés par volume sur 24 h. »

query {
  filterTokens(
    filters: { network: [8453] }
    rankings: [{ attribute: volume24, direction: DESC }]
    limit: 10
  ) {
    results {
      token {
        name
        symbol
        address
      }
      volume24
      priceUSD
      change24
    }
  }
}

Afficher un graphique de prix

« Récupère les bougies OHLCV sur 1 heure des dernières 24 heures pour ce jeton sur Solana : So11111111111111111111111111111111111111112. »

query {
  getBars(
    symbol: "So11111111111111111111111111111111111111112:1399811149"
    from: 1719792000
    to: 1719878400
    resolution: "60"
  ) {
    o
    h
    l
    c
    volume
    t
  }
}

Diffuser les transactions en direct

« Configure un abonnement WebSocket pour diffuser les événements de swap en temps réel d’un jeton sur Ethereum. »

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

Suivre les avoirs d’un portefeuille

« Récupère tous les soldes de jetons d’un portefeuille sur Base. »

query {
  balances(
    input: {
      walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      networks: [8453]
    }
  ) {
    items {
      tokenAddress
      balance
      shiftedBalance
      token {
        name
        symbol
      }
    }
  }
}

Découvrir les nouveaux lancements

« Trouve les jetons lancés au cours de la dernière heure sur Solana avec au moins 10 k$ de liquidité. »

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]

Pas besoin de mémoriser tout cela : décrivez simplement ce que vous voulez et votre assistant IA recherchera la requête appropriée dans la documentation. Les exemples ci-dessus montrent simplement ce qui est possible.

Cette documentation est créée et hébergée sur Mintlify, une plateforme de documentation pour développeurs.