DexPaprika

DexPaprika MCP Server

Ein Model Context Protocol (MCP)-Server, der bedarfsgesteuerten Zugriff auf die Kryptowährungs- und DEX-Daten-API von DexPaprika bietet. Entwickelt speziell für KI-Assistenten wie Claude, um aktuelle Token-, Pool- und DEX-Daten ohne Konfiguration programmatisch abzurufen.

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 über mehrere Blockchains. Der kostenlose Tarif benötigt keinen API-Schlüssel zum Starten. Installation | Konfiguration | API-Referenz

Bevorzugen Sie null Einrichtung? Nutzen Sie den gehosteten MCP-Server unter mcp.dexpaprika.com: keine Installation, kein Schlüssel zum Starten, dieselben Datentools plus submitFeedback. Siehe Gehosteter Server für Transport-Endpunkte.

Neueste Version

Siehe CHANGELOG.md für Versionshinweise und Migrationsanleitungen.

Was können Sie bauen?

• Token-Analyse-Tools: Preisbewegungen, Liquiditätstiefenänderungen und Volumenmuster verfolgen
• DEX-Vergleiche: Gebührenstrukturen, Volumen und verfügbare Pools über verschiedene DEXes analysieren
• Liquiditätspool-Analysen: TVL-Änderungen überwachen, impermanente Verlustberechnungen und Preiseinflussbewertungen
• Marktanalyse: Kettenübergreifende Token-Vergleiche, Volumentrends und Handelsaktivitätskennzahlen
• Portfolio-Tracker: Aktuelle Wertverfolgung, historische Leistungsanalyse, Renditemöglichkeiten
• Technische Analyse: Fortgeschrittene technische Analyse mit historischen OHLCV-Daten, einschließlich Trendidentifikation, Mustererkennung und Indikatorberechnungen

Installation

Installation über Smithery

Um DexPaprika für Claude Desktop automatisch über Smithery zu installieren:

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 und bindet keinen Port. Beim Start schreibt er DexPaprika MCP server v<version> (tool contract v<contract>) is running... nach stderr und wartet dann auf einen Client. Führen Sie ihn über einen MCP-Client (Claude Desktop, Cursor, Claude Code) aus, anstatt eine URL im Browser zu erwarten.

Video-Tutorial

Sehen Sie sich unser Schritt-für-Schritt-Tutorial zur Einrichtung und Nutzung des DexPaprika MCP-Servers an:

Claude Desktop-Integration

Fügen Sie Folgendes zu Ihrer Claude Desktop-Konfigurationsdatei 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 einem Neustart von Claude Desktop stehen die DexPaprika-Tools Claude automatisch zur Verfügung.

Optional: Verwendung eines API-Schlüssels

Dies funktioniert ohne Schlüssel und wird es immer tun. Keine Anmeldung, keine Karte, nichts zu konfigurieren. Alles oben Genannte ist die unterstützte Art, es auszuführen.

Ein kostenloser Schlüssel erhöht das monatliche Kontingent und ermöglicht Streaming für beliebige Token statt nur für den öffentlichen Schaukasten. Er erhöht nicht das Limit für Anfragen pro Minute, das in beiden Tarifen gleich ist. Erhalten Sie einen unter console.dexpaprika.com; aktuelle Limits finden Sie auf der Rate-Limits-Seite.

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

Der Schlüssel wird allein eingefügt. Es gibt kein Bearer-Präfix und auch kein anderes Schema-Wort. Fügen Sie den Schlüssel genau so ein, wie er ausgestellt wurde. Fast jede andere API verlangt das Gegenteil, daher ist dies der häufigste Grund, warum ein funktionierender Schlüssel defekt aussieht.

Zwei Dinge, die wissenswert sind:

• Ein Schlüssel, den wir nicht lesen können, erzeugt keinen Fehler. Die Daten-Endpunkte ignorieren einen nicht lesbaren Schlüssel und bedienen Sie als anonymen Aufrufer mit einem normalen 200 und echten Daten, sodass ein Tippfehler genau wie ein Erfolg aussieht. Bitten Sie den Assistenten, nach dem Festlegen getKeyStatus auszuführen: Er meldet, welchen Plan die API tatsächlich sieht, und nennt die wahrscheinliche Ursache, wenn der Schlüssel nicht ankommt.
• Pro-Kunden setzen zusätzlich DEXPAPRIKA_API_BASE_URL auf https://api-pro.dexpaprika.com. Der Host ändert sich nicht automatisch, da das Senden eines kostenlosen Schlüssels an diesen Host 403 zurückgibt.

Gehosteter Server (keine Installation)

Wenn Sie null Einrichtung bevorzugen, richten Sie einen beliebigen MCP-kompatiblen Client direkt auf den gehosteten Server unter mcp.dexpaprika.com. Die Landingpage bietet Einrichtungsanweisungen und Dokumentation. Die folgenden Transport-Endpunkte sind verfügbar:

Transport	Endpunkt	Anwendungsfall
Streamable HTTP	https://mcp.dexpaprika.com/streamable-http	Empfohlen für die meisten Clients
SSE	https://mcp.dexpaprika.com/sse	Legacy-SSE-Transport
JSON-RPC	https://mcp.dexpaprika.com/json-rpc	Direktes JSON-RPC

Hinweis: Dies sind MCP-Protokoll-Endpunkte. Sie zeigen im Browser nichts an. Besuchen Sie mcp.dexpaprika.com für die Landingpage.

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

Verfügbare Tools (17)

Dieser Self-Host-Build registriert 17 Lese-Tools: 16 Marktdaten-Tools plus getKeyStatus. Der gehostete Server unter mcp.dexpaprika.com registriert seinen eigenen Satz einschließlich submitFeedback. Überprüfen Sie beides mit einem Live-tools/list.

Entdeckung

Tool	Beschreibung
getCapabilities	Serverfähigkeiten, Workflow-Muster, Netzwerk-Synonyme und Best Practices. Hier beginnen.
getNetworks	Alle unterstützten Blockchain-Netzwerke auflisten (36)
getStats	Hochrangige Ökosystem-Statistiken (Gesamtnetzwerke, DEXes, Pools, Token)
search	Token, Pools und DEXes über ALLE Netzwerke nach Name, Symbol oder Adresse suchen
getKeyStatus	Ob ein Schlüssel gesendet wird und welchen Plan die API sieht. Liest keine Marktdaten.

DEX-Operationen

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

Pool-Operationen

Tool	Beschreibung	Erforderliche Parameter
getNetworkPools	PRIMÄR. Top-Liquiditätspools auf einem Netzwerk abrufen	network
getDexPools	Pools von einem bestimmten DEX abrufen (Zeilen unter results, Cursor-Paginierung)	network, dex
getNetworkPoolsFilter	Pools nach Volumen, Transaktionen, Erstellungszeit filtern	network
getPoolDetails	Detaillierte Pool-Informationen (Preis, Volumen, TVL, Token)	network, pool_address
getPoolOHLCV	Historische OHLCV-Candlestick-Daten	network, pool_address, start
getPoolTransactions	Aktuelle Transaktionen/Handel für einen Pool	network, pool_address

Token-Operationen

Tool	Beschreibung	Erforderliche Parameter
getTokenDetails	Detaillierte Token-Informationen	network, token_address
getTokenPools	Liquiditätspools, die einen Token enthalten (netzwerkbezogener Filter, results + Cursor-Paginierung)	network, token_address
getTokenMultiPrices	Gebündelte Preise für bis zu 10 Token	network, tokens[]
getTopTokens	Top-Token auf einem Netzwerk, sortiert nach Volumen, Liquidität, FDV oder 24h-Preisänderung	network
filterNetworkTokens	Token nach Volumen, Liquidität, FDV, Transaktionen und Erstellungszeit filtern	network

Beispielverwendung

// 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"
  ]
});

Beispiel-Prompts für Claude

• "Analysiere das JUP-Token auf Solana. Rufe Preis, Volumen und Top-Liquiditätspools ab."
• "Vergleiche das Handelsvolumen zwischen Uniswap V3 und SushiSwap auf Ethereum."
• "Hole stündliche OHLCV-Daten für den letzten Tag für SOL/USDC auf Raydium und erstelle ein Preischart."
• "Finde die Top-5-Pools nach Liquidität im Fantom-Netzwerk und analysiere ihre Gebührenstrukturen."
• "Hole aktuelle Transaktionen für den ETH/USDT-Pool auf Uniswap und analysiere Kauf- vs. Verkaufsdruck."
• "Zeige mir die Top-10-Pools auf Ethereum nach 24h-Volumen."
• "Suche nach allen Pools, die das ARB-Token enthalten, und sortiere sie nach Volumen."
• "Filtere Ethereum-Pools mit >100.000 $ 24h-Volumen, die in der letzten Woche erstellt wurden."
• "Hole zuerst alle verfügbaren Netzwerke und zeige mir dann die Top-Pools in jedem Hauptnetzwerk."

Rate-Limits & Leistung

• Kostenloser Tarif: ohne Schlüssel, ohne Anmeldung, bei 15 Anfragen pro Minute. Ein kostenloser API-Schlüssel erhöht das auf 30 Anfragen pro Minute, erhöht das monatliche Kontingent und entsperrt Streaming: Registrieren Sie sich unter https://console.dexpaprika.com. Pro kostet 99 $/Monat bei 500 Anfragen pro Minute, und es gibt einen 30 $-Dev-Plan bei 120. Eine Anfrage kostet ein Guthaben; Batch-Endpunkte kosten ein Guthaben pro Element. Vollständige Dokumentation unter https://docs.dexpaprika.com. Monatliche Kontingente ändern sich, also lesen Sie sie hier statt auf dieser Seite: https://dexpaprika.com/api/pricing
• Datenverzögerung: bis zu 60 Sekunden im kostenlosen Tarif, Echtzeit in den kostenpflichtigen Plänen
• Antwortzeit: 100-500 ms für die meisten Endpunkte (netzwerkabhängig)
• Fehlerbehandlung: Strukturierte Fehler mit Codes, Vorschlägen und Wiederholungsanleitungen
• OHLCV-Datenverfügbarkeit: Historische Daten typischerweise ab dem Erstellungsdatum des Tokens/Pools verfügbar

Fehlerbehebung

Häufige Probleme:

• Rate-Limiting: Wenn Sie DP429_RATE_LIMIT-Fehler erhalten, implementieren Sie exponentielles Backoff
• Fehlende Daten: Einige neuere Token/Pools können unvollständige historische Daten haben
• Timeout-Fehler: Große Datenanfragen können länger dauern, erwägen Sie Paginierung
• Netzwerkfehler: Überprüfen Sie die Netzwerkverbindung, der Dienst erfordert Internetzugang
• OHLCV-Einschränkungen: Eine Anfrage gibt bis zu 1000 Candlesticks zurück (limit); für einen längeren Zeitraum verschieben Sie start vorwärts und fragen Sie erneut. Ohne Schlüssel deckt OHLCV die letzten 24 Stunden bei 1h und länger ab (start: "-24h"); ein kostenloser Schlüssel öffnet 7 Tage bei 10m und länger. Siehe OHLCV-Limits nach Plan
• Leere OHLCV: Der Pool ist möglicherweise zu neu. Verwenden Sie 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

Siehe CHANGELOG.md für detaillierte Versionshinweise und Migrationsanleitungen.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – siehe die LICENSE-Datei für Details.

Zusätzliche Ressourcen

• DexPaprika API-Dokumentation
• Gehosteter MCP-Server, Option ohne Einrichtung
• Model Context Protocol-Spezifikation
• DexPaprika – Umfassende Onchain-Analyse-Marktdaten
• CoinPaprika – Umfassende Kryptowährungs-Marktdaten