DexPaprika

Serveur MCP DexPaprika

Un serveur Model Context Protocol (MCP) qui fournit un accès à la demande à l'API de données cryptographiques et DEX de DexPaprika. Conçu spécifiquement pour les assistants IA comme Claude afin de récupérer programmatiquement les données actuelles de tokens, de pools et de DEX sans aucune configuration.

TL;DR

# Install globally
npm install -g dexpaprika-mcp

# Start the server
dexpaprika-mcp

# Or run directly without installation
npx dexpaprika-mcp@latest

DexPaprika MCP connecte Claude aux données DEX en direct sur plusieurs blockchains. Le niveau gratuit ne nécessite pas de clé API pour démarrer. Installation | Configuration | Référence API

Vous préférez une configuration zéro ? Utilisez le serveur MCP hébergé sur mcp.dexpaprika.com : aucune installation, aucune clé pour démarrer, les mêmes outils de données plus submitFeedback. Voir Serveur hébergé pour les points de terminaison de transport.

Dernière version

Consultez CHANGELOG.md pour les notes de version et les guides de migration.

Que Pouvez-Vous Construire ?

• Outils d'Analyse de Tokens : Suivez les mouvements de prix, les changements de profondeur de liquidité et les modèles de volume
• Comparaisons de DEX : Analysez les structures de frais, le volume et les pools disponibles sur différents DEX
• Analytique des Pools de Liquidité : Surveillez les changements de TVL, les calculs de perte impermanente et les évaluations d'impact sur les prix
• Analyse de Marché : Comparaisons de tokens inter-chaînes, tendances de volume et métriques d'activité de trading
• Suivi de Portefeuille : Suivi de la valeur actuelle, analyse de performance historique, opportunités de rendement
• Analyse Technique : Effectuez une analyse technique avancée en utilisant les données historiques OHLCV, y compris l'identification de tendances, la reconnaissance de modèles et les calculs d'indicateurs

Installation

Installation via Smithery

Pour installer DexPaprika pour Claude Desktop automatiquement via Smithery :

npx -y smithery mcp add coinpaprika/dexpaprika

Installation Manuelle

# Install globally (recommended for regular use)
npm install -g dexpaprika-mcp

# Start the server
dexpaprika-mcp

Ceci est un serveur stdio : il parle MCP via stdin et stdout et ne lie aucun port. Au démarrage, il écrit DexPaprika MCP server v<version> (tool contract v<contract>) is running... sur stderr puis attend un client. Exécutez-le depuis un client MCP (Claude Desktop, Cursor, Claude Code) plutôt que d'attendre une URL dans un navigateur.

Tutoriel Vidéo

Regardez notre tutoriel étape par étape sur la configuration et l'utilisation du serveur MCP DexPaprika :

Intégration Claude Desktop

Ajoutez ce qui suit à votre fichier de configuration Claude Desktop :

macOS : ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows : %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "dexpaprika": {
      "command": "npx",
      "args": ["dexpaprika-mcp@latest"]
    }
  }
}

Après avoir redémarré Claude Desktop, les outils DexPaprika seront automatiquement disponibles pour Claude.

Optionnel : utilisation d'une clé API

Cela fonctionne sans clé et fonctionnera toujours. Pas d'inscription, pas de carte, rien à configurer. Tout ce qui précède est la manière prise en charge de l'exécuter.

Une clé gratuite augmente le quota mensuel et ouvre le streaming sur n'importe quel token plutôt que sur l'ensemble de démonstration public. Elle n'augmente pas la limite de requêtes par minute, qui est la même sur les deux niveaux. Obtenez-en une sur console.dexpaprika.com ; les limites actuelles sont sur la page des limites de débit.

{
  "mcpServers": {
    "dexpaprika": {
      "command": "npx",
      "args": ["dexpaprika-mcp@latest"],
      "env": {
        "DEXPAPRIKA_API_KEY": "your_key_here"
      }
    }
  }
}

La clé se place toute seule. Il n'y a pas de préfixe Bearer, ni aucun autre mot de schéma. Collez la clé exactement telle qu'elle a été émise. Presque toutes les autres API veulent le contraire, c'est donc la raison la plus courante pour laquelle une clé fonctionnelle semble cassée.

Deux choses à savoir :

• Une clé que nous ne pouvons pas lire ne produit pas d'erreur. Les points de terminaison de données ignorent une clé illisible et vous servent en tant qu'appelant anonyme, avec un 200 normal et de vraies données, donc une faute de frappe ressemble exactement à un succès. Demandez à l'assistant d'exécuter getKeyStatus après en avoir défini une : il indique quel plan l'API voit réellement et nomme la cause probable lorsque la clé n'atterrit pas.
• Les clients Pro définissent en plus DEXPAPRIKA_API_BASE_URL sur https://api-pro.dexpaprika.com. L'hôte ne change pas automatiquement, car envoyer une clé gratuite à cet hôte renvoie 403.

Serveur hébergé (sans installation)

Si vous préférez une configuration zéro, pointez n'importe quel client compatible MCP directement vers le serveur hébergé sur mcp.dexpaprika.com. La page d'accueil fournit des instructions de configuration et de la documentation. Les points de terminaison de transport suivants sont disponibles :

Transport	Point de terminaison	Cas d'utilisation
HTTP streamable	https://mcp.dexpaprika.com/streamable-http	Recommandé pour la plupart des clients
SSE	https://mcp.dexpaprika.com/sse	Transport SSE hérité
JSON-RPC	https://mcp.dexpaprika.com/json-rpc	JSON-RPC direct

Remarque : Ce sont des points de terminaison de protocole MCP. Ils n'afficheront rien dans un navigateur. Visitez mcp.dexpaprika.com pour la page d'accueil.

{
  "mcpServers": {
    "dexpaprika": {
      "type": "streamable-http",
      "url": "https://mcp.dexpaprika.com/streamable-http"
    }
  }
}

Outils Disponibles (17)

Cette build auto-hébergée enregistre 17 outils de lecture : 16 outils de données de marché plus getKeyStatus. Le serveur hébergé sur mcp.dexpaprika.com enregistre son propre ensemble incluant submitFeedback. Vérifiez l'un ou l'autre avec un tools/list en direct.

Découverte

Outil	Description
getCapabilities	Capacités du serveur, modèles de flux de travail, synonymes de réseau et meilleures pratiques. Commencez ici.
getNetworks	Listez chaque réseau blockchain pris en charge (36)
getStats	Statistiques d'écosystème de haut niveau (réseaux totaux, DEX, pools, tokens)
search	Recherchez des tokens, des pools et des DEX sur TOUS les réseaux par nom, symbole ou adresse
getKeyStatus	Indique si une clé est envoyée et quel plan l'API voit. Ne lit aucune donnée de marché.

Opérations DEX

Outil	Description	Paramètres Requis
getNetworkDexes	Listez les DEX sur un réseau spécifique	network

Opérations de Pool

Outil	Description	Paramètres Requis
getNetworkPools	PRINCIPAL. Obtenez les principaux pools de liquidité sur un réseau	network
getDexPools	Obtenez les pools d'un DEX spécifique (lignes sous results, pagination par curseur)	network, dex
getNetworkPoolsFilter	Filtrez les pools par volume, transactions, heure de création	network
getPoolDetails	Informations détaillées sur le pool (prix, volume, TVL, tokens)	network, pool_address
getPoolOHLCV	Données historiques de chandeliers OHLCV	network, pool_address, start
getPoolTransactions	Transactions/échanges récents pour un pool	network, pool_address

Opérations de Tokens

Outil	Description	Paramètres Requis
getTokenDetails	Informations détaillées sur le token	network, token_address
getTokenPools	Pools de liquidité contenant un token (filtre limité au réseau, results + pagination par curseur)	network, token_address
getTokenMultiPrices	Prix par lots pour jusqu'à 10 tokens	network, tokens[]
getTopTokens	Principaux tokens sur un réseau classés par volume, liquidité, FDV ou variation de prix sur 24h	network
filterNetworkTokens	Filtrez les tokens par volume, liquidité, FDV, transactions et heure de création	network

Exemple d'Utilisation

// Start by getting capabilities for workflow guidance:
const caps = await getCapabilities();

// Get details about a specific token:
const solanaJupToken = await getTokenDetails({
  network: "solana",
  token_address: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN"
});

// Find pools containing a token (returns `results` with cursor pagination;
// the token filter only works network-scoped):
const jupiterPools = await getTokenPools({
  network: "solana",
  token_address: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
  order_by: "volume_usd_24h",
  limit: 5
});

// Get top pools on Ethereum (returns `results` with cursor pagination):
const ethereumPools = await getNetworkPools({
  network: "ethereum",
  order_by: "volume_usd_24h",
  limit: 10
});

// Filter pools by volume and creation time:
const filteredPools = await getNetworkPoolsFilter({
  network: "ethereum",
  volume_24h_min: 100000,
  created_after: "-7d", // also Unix seconds, RFC3339 or YYYY-MM-DD
  sort_by: "volume_usd_24h",
  limit: 20
});

// Get historical price data:
const ohlcvData = await getPoolOHLCV({
  network: "ethereum",
  pool_address: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
  start: "-24h",     // last 24 hours; works without a key
  interval: "1h",
  limit: 24
});

// Batch prices for multiple tokens (max 10):
const prices = await getTokenMultiPrices({
  network: "ethereum",
  tokens: [
    "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
    "0xdac17f958d2ee523a2206206994597c13d831ec7"
  ]
});

Exemples de Prompts pour Claude

• "Analysez le token JUP sur Solana. Récupérez le prix, le volume et les principaux pools de liquidité."
• "Comparez le volume de trading entre Uniswap V3 et SushiSwap sur Ethereum."
• "Obtenez l'OHLCV horaire pour le dernier jour pour SOL/USDC sur Raydium et tracez un graphique de prix."
• "Trouvez les 5 principaux pools par liquidité sur le réseau Fantom et analysez leurs structures de frais."
• "Obtenez les transactions récentes pour le pool ETH/USDT sur Uniswap et analysez la pression d'achat par rapport à la pression de vente."
• "Montrez-moi les 10 principaux pools sur Ethereum par volume sur 24h."
• "Recherchez tous les pools contenant le token ARB et classez-les par volume."
• "Filtrez les pools Ethereum avec un volume sur 24h > 100 000 $ créés la semaine dernière."
• "Obtenez d'abord tous les réseaux disponibles, puis montrez-moi les principaux pools sur chaque réseau majeur."

Limites de Débit et Performance

• Niveau gratuit : sans clé, sans inscription, à 15 requêtes par minute. Une clé API gratuite augmente cela à 30 requêtes par minute, augmente le quota mensuel et débloque le streaming : inscrivez-vous sur https://console.dexpaprika.com. Pro coûte 99 $/mois à 500 requêtes par minute, et il existe un plan Dev à 30 $ à 120. Une requête coûte un crédit ; les points de terminaison par lots coûtent un crédit par élément. Documentation complète sur https://docs.dexpaprika.com. Les quotas mensuels changent, alors lisez-les ici plutôt que sur cette page : https://dexpaprika.com/api/pricing
• Délai des données : jusqu'à 60 secondes sur le niveau gratuit, en temps réel sur les plans payants
• Temps de réponse : 100-500 ms pour la plupart des points de terminaison (dépend du réseau)
• Gestion des erreurs : Erreurs structurées avec codes, suggestions et conseils de nouvelle tentative
• Disponibilité des données OHLCV : Les données historiques sont généralement disponibles à partir de la date de création du token/pool

Dépannage

Problèmes courants :

• Limitation de débit : Si vous recevez des erreurs DP429_RATE_LIMIT, implémentez un backoff exponentiel
• Données manquantes : Certains tokens/pools plus récents peuvent avoir des données historiques incomplètes
• Erreurs de délai d'attente : Les demandes de données volumineuses peuvent prendre plus de temps, envisagez la pagination
• Erreurs réseau : Vérifiez la connectivité réseau, le service nécessite un accès Internet
• Limitations OHLCV : Une requête renvoie jusqu'à 1000 chandeliers (limit) ; pour une période plus longue, avancez start et demandez à nouveau. Sans clé, l'OHLCV couvre les dernières 24 heures à 1h et plus (start: "-24h") ; une clé gratuite ouvre 7 jours à 10m et plus. Voir Limites OHLCV par plan
• OHLCV vide : Le pool est peut-être trop récent. Utilisez getPoolTransactions à la place

Développement

# Clone the repository
git clone https://github.com/coinpaprika/dexpaprika-mcp.git
cd dexpaprika-mcp

# Install dependencies
npm install

# Run with auto-restart on code changes
npm run watch

# Build for production
npm run build

# Run tests
npm test

Journal des modifications

Consultez CHANGELOG.md pour les notes de version détaillées et les guides de migration.

Licence

Ce projet est sous licence MIT - voir le fichier LICENSE pour plus de détails.

Ressources Supplémentaires

• Documentation API DexPaprika
• Serveur MCP hébergé, option sans configuration
• Spécification du protocole Model Context
• DexPaprika - Données de marché analytiques onchain complètes
• CoinPaprika - Données complètes du marché des cryptomonnaies