DexPaprika MCP Server

officiel

Access real-time DEX analytics across 20+ blockchains with DexPaprika API, tracking 5M+ tokens, pools, volumes, and historical market data. Built by CoinPaprika.

Documentation

Serveur MCP DexPaprika

Un serveur Model Context Protocol (MCP) qui fournit un accès à la demande aux données de cryptomonnaies et de DEX de DexPaprika. Conçu spécifiquement pour les assistants IA comme Claude afin de récupérer par programmation des données en temps réel sur les tokens, les pools et les 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

DexPaprika MCP connecte Claude aux données DEX en direct sur plusieurs blockchains. Aucune clé API requise. Installation | Configuration | Référence API

Vous préférez le zéro configuration ? Utilisez le serveur MCP hébergé sur mcp.dexpaprika.com — aucune installation, aucune clé API, les mêmes 14 outils. Voir Alternative hébergée pour les points de terminaison de transport.

Points forts de la version 1.3.0

Nouveaux outils : getCapabilities (intégration d'agent avec flux de travail, synonymes, meilleures pratiques) et getNetworkPoolsFilter (filtrage des pools côté serveur par volume, transactions, date de création).

Rupture : Paramètres renommés en snake_case (poolAddresspool_address, tokenAddresstoken_address, orderByorder_by). La pagination est désormais indexée à partir de 1. Voir CHANGELOG.md pour le guide de migration complet.

Que pouvez-vous construire ?

  • Outils d'analyse de tokens : Suivre les mouvements de prix, les changements de profondeur de liquidité et les schémas de volume
  • Comparaisons de DEX : Analyser les structures de frais, le volume et les pools disponibles sur différents DEX
  • Analyse de pools de liquidité : Surveiller 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 valeur en temps réel, analyse de performance historique, opportunités de rendement
  • Analyse technique : Effectuer une analyse technique avancée en utilisant les données OHLCV historiques, y compris l'identification de tendances, la reconnaissance de motifs et les calculs d'indicateurs

Installation

Installation via Smithery

Pour installer DexPaprika pour Claude Desktop automatiquement via Smithery :

npx -y @smithery/cli install @coinpaprika/dexpaprika-mcp --client claude

Installation manuelle

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

# Verify installation
dexpaprika-mcp --version

# Start the server
dexpaprika-mcp

Le serveur s'exécute sur le port 8010 par défaut. Vous verrez MCP server is running at http://localhost:8010 lorsqu'il aura démarré avec succès.

Tutoriel vidéo

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

DexPaprika MCP Tutorial

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"]
    }
  }
}

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

Alternative hébergée (sans installation)

Si vous préférez le zéro configuration, 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 :

TransportPoint de terminaisonCas d'utilisation
HTTP streamablehttps://mcp.dexpaprika.com/streamable-httpRecommandé pour la plupart des clients
SSEhttps://mcp.dexpaprika.com/sseTransport SSE hérité
JSON-RPChttps://mcp.dexpaprika.com/mcpJSON-RPC direct

Remarque : Ce sont des points de terminaison du 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 (14)

Découverte

OutilDescription
getCapabilitiesCapacités du serveur, schémas de flux de travail, synonymes de réseau et meilleures pratiques. Commencez ici.
getNetworksLister les 33 réseaux blockchain pris en charge
getStatsStatistiques écosystémiques de haut niveau (total réseaux, DEX, pools, tokens)
searchRechercher des tokens, pools et DEX sur TOUS les réseaux par nom, symbole ou adresse

Opérations DEX

OutilDescriptionParamètres requis
getNetworkDexesLister les DEX sur un réseau spécifiquenetwork

Opérations de pool

OutilDescriptionParamètres requis
getNetworkPoolsPRINCIPAL — Obtenir les meilleurs pools de liquidité sur un réseaunetwork
getDexPoolsObtenir les pools d'un DEX spécifiquenetwork, dex
getNetworkPoolsFilterFiltrer les pools par volume, transactions, date de créationnetwork
getPoolDetailsInformations détaillées sur le pool (prix, volume, TVL, tokens)network, pool_address
getPoolOHLCVDonnées historiques OHLCV en chandeliersnetwork, pool_address, start
getPoolTransactionsTransactions/échanges récents pour un poolnetwork, pool_address

Opérations sur les tokens

OutilDescriptionParamètres requis
getTokenDetailsInformations détaillées sur le tokennetwork, token_address
getTokenPoolsPools de liquidité contenant un tokennetwork, token_address
getTokenMultiPricesPrix par lots pour jusqu'à 10 tokensnetwork, tokens[]

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 all pools for a specific token with volume sorting:
const jupiterPools = await getTokenPools({
  network: "solana",
  token_address: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
  order_by: "volume_usd",
  limit: 5
});

// Get top pools on Ethereum:
const ethereumPools = await getNetworkPools({
  network: "ethereum",
  order_by: "volume_usd",
  limit: 10
});

// Filter pools by volume and creation time:
const filteredPools = await getNetworkPoolsFilter({
  network: "ethereum",
  volume_24h_min: 100000,
  created_after: 1710806400,
  sort_by: "volume_24h",
  limit: 20
});

// Get historical price data:
const ohlcvData = await getPoolOHLCV({
  network: "ethereum",
  pool_address: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
  start: "2023-01-01",
  interval: "24h",
  limit: 30
});

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

Exemples de prompts pour Claude

  • "Analyse le token JUP sur Solana. Récupère le prix, le volume et les meilleurs pools de liquidité."
  • "Compare le volume de trading entre Uniswap V3 et SushiSwap sur Ethereum."
  • "Obtiens les données OHLCV sur 7 jours pour SOL/USDC sur Raydium et trace un graphique de prix."
  • "Trouve les 5 meilleurs pools par liquidité sur le réseau Fantom et analyse leurs structures de frais."
  • "Obtiens les transactions récentes pour le pool ETH/USDT sur Uniswap et analyse la pression d'achat vs vente."
  • "Montre-moi les 10 meilleurs pools sur Ethereum par volume sur 24h."
  • "Recherche tous les pools contenant le token ARB et classe-les par volume."
  • "Filtre les pools Ethereum avec un volume 24h > 100 000 $ créés la semaine dernière."
  • "Obtiens d'abord tous les réseaux disponibles, puis montre-moi les meilleurs pools sur chaque réseau majeur."

Limites de débit et performance

  • Limites du niveau gratuit : 10 000 requêtes par jour
  • Temps de réponse : 100-500 ms pour la plupart des points de terminaison (dépendant du réseau)
  • Fraîcheur des données : Données des pools et tokens mises à jour toutes les 15-30 s
  • Gestion des erreurs : Erreurs structurées avec codes, suggestions et conseils de nouvelle tentative
  • Disponibilité des données OHLCV : Données historiques généralement disponibles à partir de la date de création du token/pool

Dépannage

Problèmes courants :

  • Limitation de débit : En cas d'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 requêtes 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 : La plage maximale entre les dates de début et de fin est de 1 an ; utilisez la pagination pour des périodes plus longues
  • 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

Voir 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