Codex.io Docs MCP
officielMCP 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 des requêtes et champs API — Demandez à votre agent de parcourir la documentation Codex pour une requête, un type ou un champ spécifique afin qu'il puisse écrire du GraphQL précis.
- Générer des demandes de prix de tokens — Décrivez un token et un réseau, et l'agent peut trouver
getTokenPricesdans la documentation pour produire la requête correcte. - Créer des flux de tokens tendance — Demandez une liste classée de tokens par volume ou autres attributs, et l'agent peut référencer
filterTokensdepuis la documentation. - Récupérer des données de bougies OHLCV — Demandez des barres de prix historiques pour un token, et l'agent peut consulter les paramètres de
getBarscomme la résolution et la plage temporelle. - Diffuser des événements d'échange en direct — Donnez pour instruction à l'agent de configurer un abonnement WebSocket en utilisant
onEventsCreateden extrayant la structure d'abonnement de la documentation.
Documentation
Codex Docs MCP
Ajoutez le serveur MCP de documentation Codex à vos outils de codage IA pour un accès instantané aux docs API.
La documentation Codex est disponible en tant que serveur Model Context Protocol (MCP). L'ajouter à votre outil de codage IA lui permet de rechercher et de référencer directement les docs de l'API Codex, afin que vous puissiez obtenir des réponses précises sans quitter votre éditeur.
https://docs.codex.io/mcp
Ce qu'il fait
Une fois connecté, votre outil IA peut rechercher l'intégralité de la documentation de l'API Codex — y compris les requêtes, abonnements, types et guides. Il référencera automatiquement les docs lorsque vous poserez des questions sur l'API Codex ou aurez besoin d'aide pour écrire des requêtes.
Ce serveur MCP sert à rechercher la documentation et à aider votre IA à écrire des requêtes. Il ne s'interface pas directement avec l'API Codex — vous devrez toujours exécuter les requêtes en utilisant votre clé API via le [point de terminaison GraphQL](/learn-graphql) ou le [SDK](/sdk).Docs MCP vs Codex Skills
Le Codex Skills donne à votre agent IA une connaissance préchargée de l'API afin qu'il puisse s'interfacer directement avec l'API. Le Docs MCP lui permet de rechercher la documentation, ce qui peut lui permettre d'écrire des requêtes GraphQL.
| Docs MCP | Codex Skills | |
|---|---|---|
| Fonctionnement | Recherche les docs à la demande via le protocole MCP | Connaissance préchargée de l'API — opérations, auth, modèles |
| Idéal pour | Rechercher des champs, types ou guides spécifiques | Interagir directement avec l'API Codex |
| Nécessite réseau ? | Oui — interroge le serveur MCP | Fonctionne hors ligne pour écrire des requêtes (nécessite toujours une connexion pour appeler l'API) |
Utilisez les deux ensemble pour une expérience optimale : le skill gère la génération de requêtes et le MCP complète les détails si nécessaire.
Configuration
Ouvrez les paramètres MCP avec `Cmd+Shift+P` (Mac) ou `Ctrl+Shift+P` (Windows/Linux) et sélectionnez **Cursor Settings: Open MCP Settings**. Ajoutez ce qui suit :```json theme={null}
{
"mcpServers": {
"codex-docs": {
"url": "https://docs.codex.io/mcp"
}
}
}
```
Créez un fichier `.vscode/mcp.json` à la racine de votre projet :
```json theme={null}
{
"servers": {
"codex-docs": {
"type": "http",
"url": "https://docs.codex.io/mcp"
}
}
}
```
Ouvrez le fichier de configuration MCP à l'emplacement `~/.codeium/windsurf/mcp_config.json` et ajoutez ce qui suit :
```json theme={null}
{
"mcpServers": {
"codex-docs": {
"serverUrl": "https://docs.codex.io/mcp"
}
}
}
```
Allez dans **Paramètres > Connecteurs**, sélectionnez **Ajouter un connecteur personnalisé**, puis entrez :
* **Nom :** Codex Docs
* **URL :** `https://docs.codex.io/mcp`
Exécutez la commande suivante :
```bash theme={null}
claude mcp add --transport http codex-docs https://docs.codex.io/mcp
```
Exemples de prompts
Une fois le MCP connecté, vous pouvez demander à votre assistant IA de construire des fonctionnalités en utilisant l'API Codex. Voici quelques exemples pour commencer.
Obtenir le prix d'un token
"Utilise l'API Codex pour récupérer le prix actuel en USD du WETH sur Ethereum."
Votre assistant recherchera la requête getTokenPrices et écrira quelque chose comme :
query {
getTokenPrices(
inputs: [
{
address: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
networkId: 1
}
]
) {
address
priceUsd
}
}
Construire un flux de tokens tendance
"Montre-moi comment obtenir les 10 tokens les plus tendance sur Base triés par volume sur 24h."
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 d'1 heure pour les dernières 24 heures pour ce token sur Solana :
So11111111111111111111111111111111111111112."
query {
getBars(
symbol: "So11111111111111111111111111111111111111112:1399811149"
from: 1719792000
to: 1719878400
resolution: "60"
) {
o
h
l
c
volume
t
}
}
Diffuser des transactions en direct
"Configure un abonnement WebSocket pour diffuser en temps réel les événements de swap pour un token sur Ethereum."
subscription {
onEventsCreated(
address: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
networkId: 1
) {
address
networkId
events {
eventDisplayType
timestamp
maker
token0SwapValueUsd
token1SwapValueUsd
transactionHash
}
}
}
Suivre les avoirs d'un portefeuille
"Obtiens tous les soldes de tokens pour 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 tokens lancés dans la dernière heure sur Solana avec au moins 10k$ 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
}
}
}
Vous n'avez pas besoin de mémoriser tout cela — décrivez simplement ce que vous voulez et votre assistant IA recherchera la bonne requête dans les docs. Les exemples ci-dessus ne sont là que pour montrer ce qui est possible.