DexPaprika

DexPaprika MCP-Server: Echtzeit-DEX- und Kryptodaten für KI-Agenten

Ein Model Context Protocol (MCP)-Server, der bedarfsgesteuerten Zugriff auf die Kryptowährungs- und DEX-Daten-API von DexPaprika bietet. Speziell für KI-Assistenten wie Claude entwickelt, damit sie aktuelle Token-, Pool- und DEX-Daten ohne Konfiguration programmgesteuert abrufen können.

Kurzfassung

# Install globally
npm install -g dexpaprika-mcp

# Start the server
dexpaprika-mcp

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

DexPaprika MCP verbindet Claude mit Live-DEX-Daten aus mehreren Blockchains. Für den Einstieg in den kostenlosen Tarif ist kein API-Schlüssel erforderlich. Installation | Konfiguration | API-Referenz

Lieber ohne Einrichtung? Verwende den gehosteten MCP-Server unter mcp.dexpaprika.com: keine Installation, kein Schlüssel für den Einstieg, dieselben Datentools plus submitFeedback. Unter Gehosteter Server findest du die Transport-Endpunkte.

Neueste Version

Versionshinweise und Migrationsleitfäden findest du in CHANGELOG.md.

Was kannst du damit entwickeln?

• Tools zur Token-Analyse: Kursbewegungen, Änderungen der Liquiditätstiefe und Volumenmuster verfolgen
• DEX-Vergleiche: Gebührenstrukturen, Volumen und verfügbare Pools auf verschiedenen DEXes analysieren
• Analysen von Liquiditätspools: TVL-Änderungen, Berechnungen des impermanenten Verlusts und Einschätzungen der Kursauswirkungen überwachen
• Marktanalysen: Chain-übergreifende Token-Vergleiche, Volumentrends und Kennzahlen zur Handelsaktivität
• Portfolio-Tracker: Aktuellen Wert verfolgen, historische Performance analysieren und Renditechancen erkennen
• Technische Analyse: Mithilfe historischer OHLCV-Daten fortgeschrittene technische Analysen durchführen, einschließlich Trenderkennung, Mustererkennung und Indikatorberechnungen

Installation

Installation über Smithery

So installierst du DexPaprika automatisch für Claude Desktop über Smithery:

npx -y smithery mcp add coinpaprika/dexpaprika

Manuelle Installation

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

# Start the server
dexpaprika-mcp

Dies ist ein stdio-Server: Er kommuniziert über stdin und stdout mit MCP und bindet keinen Port. Beim Start schreibt er DexPaprika MCP server v<version> (tool contract v<contract>) is running... nach stderr und wartet anschließend auf einen Client. Starte ihn über einen MCP-Client (Claude Desktop, Cursor, Claude Code), statt eine URL im Browser zu erwarten.

Videoanleitung

Sieh dir unsere Schritt-für-Schritt-Anleitung zur Einrichtung und Verwendung des DexPaprika MCP-Servers an:

Integration mit Claude Desktop

Füge Folgendes zur Konfigurationsdatei von Claude Desktop hinzu:

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

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

Nach dem Neustart von Claude Desktop stehen Claude die DexPaprika-Tools automatisch zur Verfügung.

Optional: API-Schlüssel verwenden

Das funktioniert ohne Schlüssel und wird auch weiterhin funktionieren. Keine Registrierung, keine Karte, nichts zu konfigurieren. Die oben beschriebene Vorgehensweise ist die unterstützte Methode.

Mit einem kostenlosen Schlüssel erhöht sich das monatliche Kontingent, und Streaming ist für beliebige Token statt nur für die öffentliche Showcase-Auswahl verfügbar. Das Limit für Anfragen pro Minute wird dadurch nicht erhöht; es ist bei beiden Tarifen gleich. Einen Schlüssel erhältst du unter console.dexpaprika.com; die aktuellen Limits findest du auf der Seite zu den Ratenlimits.

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

Der Schlüssel muss allein als vollständiger Wert von Authorization eingetragen werden. Füge ihn genau so ein, wie er ausgegeben wurde, ohne etwas davor. Bei fast allen anderen APIs muss dem Schlüssel etwas vorangestellt werden. Deshalb ist dies der häufigste Grund dafür, dass ein funktionierender Schlüssel scheinbar nicht funktioniert.

Zwei wichtige Hinweise:

• Ein Schlüssel, den wir nicht lesen können, führt nicht zu einem Fehler. Die Daten-Endpunkte ignorieren einen nicht lesbaren Schlüssel und bedienen dich als anonymen Aufrufer mit einem normalen 200 und echten Daten. Ein Tippfehler sieht daher genauso aus wie ein erfolgreicher Aufruf. Bitte den Assistenten nach dem Einrichten eines Schlüssels, getKeyStatus auszuführen: Das Tool meldet, welchen Tarif die API tatsächlich erkennt, und nennt die wahrscheinliche Ursache, wenn der Schlüssel nicht ankommt.
• Dev- und Pro-Kunden setzen zusätzlich DEXPAPRIKA_API_BASE_URL auf https://api-pro.dexpaprika.com, was auch für getTokenOHLCV erforderlich ist. Der Host wird nicht automatisch geändert, da ein kostenloser Schlüssel an diesen Host gesendet einen 403-Fehler zurückgibt.

Gehosteter Server (keine Installation)

Wenn du die Einrichtung ganz vermeiden möchtest, verbinde einen beliebigen MCP-kompatiblen Client direkt mit dem gehosteten Server unter mcp.dexpaprika.com. Die Landingpage enthält Einrichtungsanweisungen und Dokumentation. Folgende Transport-Endpunkte sind verfügbar:

Transport	Endpunkt	Anwendungsfall
Streamable HTTP	https://mcp.dexpaprika.com/streamable-http	Für die meisten Clients empfohlen
SSE	https://mcp.dexpaprika.com/sse	Älterer SSE-Transport
JSON-RPC	https://mcp.dexpaprika.com/json-rpc	Direktes JSON-RPC

Hinweis: Dies sind MCP-Protokoll-Endpunkte. Im Browser wird nichts angezeigt. Die Landingpage findest du unter mcp.dexpaprika.com.

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

Verfügbare Tools (20)

Dieser Self-Host-Build registriert 20 Lese-Tools: 19 Marktdaten-Tools plus getKeyStatus. Der gehostete Server unter mcp.dexpaprika.com registriert einen eigenen Satz, einschließlich submitFeedback. Überprüfe beide mit einem Live-tools/list.

Entdeckung

Tool	Beschreibung
getCapabilities	Serverfunktionen, Workflow-Muster, Synonyme für Netzwerke und Best Practices. Hier starten.
getNetworks	Alle unterstützten Blockchain-Netzwerke auflisten (36)
getStats	Übergeordnete Ökosystemstatistiken (Gesamtzahl der Netzwerke, DEXes, Pools und Token)
search	Token, Pools und DEXes netzwerkübergreifend anhand von Name, Symbol oder Adresse suchen
getKeyStatus	Gibt an, ob ein Schlüssel gesendet wird und welchen Tarif die API erkennt. Ruft keine Marktdaten ab.

DEX-Operationen

Tool	Beschreibung	Erforderliche Parameter
getNetworkDexes	DEXes in einem bestimmten Netzwerk auflisten	network

Pool-Operationen

Tool	Beschreibung	Erforderliche Parameter
getNetworkPools	PRIMÄR. Die größten Liquiditätspools in einem Netzwerk abrufen	network
getDexPools	Pools einer bestimmten DEX abrufen (Zeilen unter results, Cursor-Paginierung; für Seiten nach der ersten ist ein Schlüssel erforderlich)	network, dex
getNetworkPoolsFilter	Pools nach Volumen, Transaktionen und Erstellungszeit filtern	network
getPoolDetails	Detaillierte Pool-Informationen (Kurs, Volumen, TVL, Token)	network, pool_address
getPoolOHLCV	Historische OHLCV-Kerzendaten	network, pool_address, start
getPoolIndicator	RSI, EMA, MACD, Bollinger-Bänder oder VWAP für einen Pool, serverseitig anhand seiner Kerzendaten berechnet. Dieselben Tariflimits für Verlauf und Intervall wie bei getPoolOHLCV	network, pool_address, indicator
getPoolTransactions	Aktuelle Transaktionen/Trades für einen Pool	network, pool_address

Token-Operationen

Tool	Beschreibung	Erforderliche Parameter
getTokenDetails	Detaillierte Token-Informationen	network, token_address
getTokenPools	Liquiditätspools mit einem Token (netzwerkbezogener Filter, results + Cursor-Paginierung; für Seiten nach der ersten ist ein Schlüssel erforderlich)	network, token_address
getTokenOHLCV	Historische USD-OHLCV-Kerzen für einen Token, volumen­gewichtet über alle Pools, in denen er gehandelt wird. Erfordert einen Dev- oder Pro-Tarif auf api-pro.dexpaprika.com; Aufrufe ohne Schlüssel und mit kostenlosen Schlüsseln erhalten 403	network, token_address, start
getTokenIndicator	Dieselben Indikatoren für die USD-Kerzen eines Tokens über alle Pools, in denen er gehandelt wird. Erfordert einen Dev- oder Pro-Tarif auf api-pro.dexpaprika.com; Aufrufe ohne Schlüssel und mit kostenlosen Schlüsseln erhalten 403	network, token_address, indicator
getTokenMultiPrices	Gebündelte Kurse für bis zu 10 Token	network, tokens[]
getTopTokens	Top-Token in einem Netzwerk, sortiert nach Volumen, Liquidität, FDV oder 24-Stunden-Kursänderung	network
filterNetworkTokens	Token nach Volumen, Liquidität, FDV, Transaktionen und Erstellungszeit filtern	network

Anwendungsbeispiel

// 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). This first page works without
// a key; passing the response's next_cursor back as cursor to fetch a later
// page needs an API key (a free key pages without limit):
const jupiterPools = await getTokenPools({
  network: "solana",
  token_address: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
  order_by: "volume_usd_24h",
  limit: 5
});

// Get top pools on Ethereum (first page, 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 for a pool:
const ohlcvData = await getPoolOHLCV({
  network: "ethereum",
  pool_address: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
  start: "-24h",     // last 24 hours; works without a key
  interval: "1h",
  limit: 24
});

// Get historical USD price data for a token, volume-weighted across every
// pool it trades in. Requires a Dev or Pro key in DEXPAPRIKA_API_KEY and
// DEXPAPRIKA_API_BASE_URL=https://api-pro.dexpaprika.com;
// on a keyless or free key this returns 403, so fall back to getPoolOHLCV
// on the token's main pool (found with getTokenPools) instead.
const tokenOhlcvData = await getTokenOHLCV({
  network: "ethereum",
  token_address: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
  start: "-24h",
  interval: "1h",
  limit: 24
});

// RSI for a pool, computed server-side (no need to fetch candles first).
// Send only the parameters of the indicator you ask for: period for rsi, ema,
// bbands and vwap; fast_period, slow_period and signal_period for macd;
// std_dev for bbands. Any other parameter is refused with 400.
const rsi = await getPoolIndicator({
  network: "ethereum",
  pool_address: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
  indicator: "rsi",
  interval: "1h",
  start: "-24h"
});

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

Beispiel-Prompts für Claude

• „Analysiere den JUP-Token auf Solana. Rufe Kurs, Volumen und die größten Liquiditätspools ab.“
• „Vergleiche das Handelsvolumen von Uniswap V3 und SushiSwap auf Ethereum.“
• „Rufe die stündlichen OHLCV-Daten des letzten Tages für SOL/USDC auf Raydium ab und erstelle ein Kursdiagramm.“
• „Finde die 5 größten Pools nach Liquidität im Fantom-Netzwerk und analysiere ihre Gebührenstrukturen.“
• „Rufe aktuelle Transaktionen für den ETH/USDT-Pool auf Uniswap ab und analysiere den Kauf- und Verkaufsdruck.“
• „Zeige mir die 10 größten Pools auf Ethereum nach 24-Stunden-Volumen.“
• „Suche alle Pools mit dem ARB-Token und sortiere sie nach Volumen.“
• „Filtere Ethereum-Pools mit einem 24-Stunden-Volumen von über 100.000 $ heraus, die in der letzten Woche erstellt wurden.“
• „Rufe zuerst alle verfügbaren Netzwerke ab und zeige mir dann die größten Pools in jedem wichtigen Netzwerk.“

Ratenlimits und Leistung

• Kostenloser Tarif: ohne Schlüssel, ohne Registrierung, mit 15 Anfragen pro Minute. Ein kostenloser API-Schlüssel erhöht das Limit auf 30 Anfragen pro Minute, erhöht das monatliche Kontingent und schaltet Streaming frei: registriere dich unter https://console.dexpaprika.com. Pro kostet 99 $ pro Monat und bietet 500 Anfragen pro Minute; außerdem gibt es einen Dev-Tarif für 30 $ mit 120 Anfragen pro Minute. Eine Anfrage kostet ein Guthaben; Batch-Endpunkte kosten ein Guthaben pro Element. Die vollständige Dokumentation findest du unter https://docs.dexpaprika.com. Monatliche Kontingente ändern sich. Informiere dich daher hier darüber, statt dich auf diese Seite zu verlassen: https://dexpaprika.com/api/pricing
• Für die Seitennavigation in Suchergebnissen ist ein Schlüssel erforderlich: Bei getNetworkPools, getDexPools, getNetworkPoolsFilter, getTokenPools, filterNetworkTokens und getTopTokens funktioniert die erste Seite ohne Schlüssel. Für spätere Seiten ist jedoch ein API-Schlüssel erforderlich, wenn du cursor übergibst. Mit einem kostenlosen Schlüssel ist die Seitennavigation unbegrenzt.
• Datenverzögerung: bis zu 60 Sekunden im kostenlosen Tarif, Echtzeit in den kostenpflichtigen Tarifen
• Neue Pools und Token in der Suche: Ohne Dev-Tarif oder höher lassen getNetworkPools, getDexPools, getTokenPools, getNetworkPoolsFilter, getTopTokens und filterNetworkTokens Pools und Token aus, die in der letzten Stunde erstellt wurden. Daher liefern ein created_after-Zeitraum von weniger als einer Stunde oder die Pools eines in der letzten Stunde gestarteten Tokens keine Ergebnisse. getPoolDetails und getTokenDetails liefern unabhängig vom Alter Ergebnisse. Dev-, Pro- und Enterprise-Schlüssel auf api-pro.dexpaprika.com sehen sie, sobald sie indexiert sind. Details: https://docs.dexpaprika.com/knowledge-base/rate-limits#search-freshness
• Antwortzeit: 100–500 ms für die meisten Endpunkte (abhängig vom Netzwerk)
• Fehlerbehandlung: Strukturierte Fehler mit Codes, Vorschlägen und Hinweisen zu Wiederholungsversuchen
• Verfügbarkeit von OHLCV-Daten: Historische Daten sind in der Regel ab dem Erstellungsdatum des Tokens/Pools verfügbar

Fehlerbehebung

Häufige Probleme:

• Ratenbegrenzung: Bei DP429_RATE_LIMIT-Fehlern exponentielles Backoff implementieren
• Fehlende Daten: Für einige neuere Token/Pools sind möglicherweise keine vollständigen historischen Daten verfügbar
• Zeitüberschreitungen: Große Datenabfragen können länger dauern; verwende gegebenenfalls die Paginierung
• Netzwerkfehler: Überprüfe die Netzwerkverbindung; der Dienst benötigt Internetzugriff
• OHLCV-Einschränkungen: Eine Anfrage liefert bis zu 1000 Kerzen (limit). Für einen längeren Zeitraum verschiebe start nach vorne und frage erneut an. Ohne Schlüssel deckt OHLCV die letzten 24 Stunden bei 1h und längere Zeiträume bei start: "-24h" ab; mit einem kostenlosen Schlüssel sind 7 Tage bei 10m und längere Zeiträume verfügbar. Siehe OHLCV-Limits nach Tarif
• Leere OHLCV-Daten: Der Pool ist möglicherweise zu neu. Verwende stattdessen getPoolTransactions

Entwicklung

# 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

Änderungsprotokoll

Ausführliche Versionshinweise und Migrationsleitfäden findest du in CHANGELOG.md.

Lizenz

Dieses Projekt steht unter der MIT-Lizenz. Einzelheiten findest du in der Datei LICENSE.

Weitere Ressourcen

• DexPaprika API-Dokumentation
• Gehosteter MCP-Server, Option ohne Einrichtung
• Model Context Protocol-Spezifikation
• DexPaprika – Umfassende On-Chain-Marktdaten und Analysen
• CoinPaprika – Umfassende Marktdaten zu Kryptowährungen