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 programmatisch aktuelle Token-, Pool- und DEX-Daten ohne Konfiguration 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. Die kostenlose Stufe benötigt keinen API-Schlüssel zum Start. Installation | Konfiguration | API-Referenz

Bevorzugen Sie keine Einrichtung? Nutzen Sie den gehosteten MCP-Server unter mcp.dexpaprika.com: keine Installation, kein Schlüssel zum Start, 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 erstellen?

• Token-Analysetools: 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 Preiseffektbewertungen
• Marktanalyse: Kettenübergreifende Token-Vergleiche, Volumentrends und Handelsaktivitätskennzahlen
• Portfolio-Tracker: Aktuelle Wertverfolgung, historische Leistungsanalyse, Ertragsmöglichkeiten
• Technische Analyse: Fortgeschrittene technische Analyse mit historischen OHLCV-Daten, einschließlich Trendidentifikation, Mustereckennung 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 MCP ü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, statt 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 dem 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. 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 jedes Token statt des öffentlichen Schaukasten-Sets. Er erhöht nicht das Anfragenlimit pro Minute, das in beiden Stufen 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 sind wissenswert:

• Ein Schlüssel, den wir nicht lesen können, erzeugt keinen Fehler. Die Daten-Endpunkte ignorieren einen unlesbaren Schlüssel und behandeln Sie als anonymen Aufrufer, mit einem normalen 200 und echten Daten, sodass ein Tippfehler exakt wie Erfolg aussieht. Bitten Sie den Assistenten, nach dem Einrichten getKeyStatus auszuführen: Es meldet, welchen Plan die API tatsächlich sieht, und nennt die wahrscheinlichste 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 jeden MCP-kompatiblen Client direkt auf den gehosteten Server unter mcp.dexpaprika.com. Die Landingpage enthält 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 Lesetools: 16 Marktdatentools plus getKeyStatus. Der gehostete Server unter mcp.dexpaprika.com registriert seine eigene Auswahl, einschließlich submitFeedback. Überprüfen Sie beide mit einem Live-tools/list.

Erkennung

Tool	Beschreibung
getCapabilities	Server-Fähigkeiten, Workflow-Muster, Netzwerk-Synonyme und Best Practices. Beginnen Sie hier.
getNetworks	Alle unterstützten Blockchain-Netzwerke auflisten (36)
getStats	Hochrangige Ökosystem-Statistiken (Gesamtzahl Netzwerke, DEXes, Pools, Tokens)
search	Suche nach Tokens, Pools und DEXes über ALLE Netzwerke hinweg nach Name, Symbol oder Adresse
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, Tokens)	network, pool_address
getPoolOHLCV	Historische OHLCV-Kerzendaten	network, pool_address, start
getPoolTransactions	Aktuelle Transaktionen/Handels für einen Pool	network, pool_address

Token-Operationen

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

Beispiele zur Verwendung

// 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: 1710806400,
  sort_by: "volume_usd_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"
  ]
});

Beispiel-Prompts für Claude

• „Analysiere das JUP-Token auf Solana. Rufe Preis, Volumen und die wichtigsten Liquiditätspools ab."
• „Vergleiche das Handelsvolumen zwischen Uniswap V3 und SushiSwap auf Ethereum."
• „Hole die 7-Tage-OHLCV-Daten 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- gegen Verkaufsdruck."
• „Zeig mir die Top-10-Pools auf Ethereum nach 24-Stunden-Volumen."
• „Suche nach allen Pools, die das ARB-Token enthalten, und sortiere sie nach Volumen."
• „Filtere Ethereum-Pools mit einem 24-Stunden-Volumen über 100.000 $, die in der letzten Woche erstellt wurden."
• „Hole zuerst alle verfügbaren Netzwerke und zeige mir dann die Top-Pools auf jedem Hauptnetzwerk."

Rate-Limits und Leistung

• Kostenlose Stufe: ohne Schlüssel, ohne Anmeldung, bei 30 Anfragen pro Minute. Ein kostenloser API-Schlüssel erhöht das monatliche Kontingent und entsperrt Streaming. Pro kostet 99 $/Monat bei 300 Anfragen pro Minute. Eine Anfrage kostet ein Guthaben; Batch-Endpunkte kosten ein Guthaben pro Element. Monatliche Kontingente ändern sich. Lesen Sie sie daher hier statt von dieser Seite: https://dexpaprika.com/api/pricing
• Datenverzögerung: bis zu 15 Sekunden in der kostenlosen Stufe, in Echtzeit auf Pro
• Antwortzeit: 100–500 ms für die meisten Endpunkte (netzwerkabhängig)
• Fehlerbehandlung: Strukturierte Fehler mit Codes, Vorschlägen und Wiederholungsanleitung
• OHLCV-Datenverfügbarkeit: Historische Daten sind in der Regel ab dem Erstellungsdatum des Tokens/Pools verfügbar

Fehlerbehebung

Häufige Probleme:

• Rate-Limit überschritten: Wenn Sie DP429_RATE_LIMIT-Fehler erhalten, implementieren Sie exponentielles Backoff
• Fehlende Daten: Einige neuere Tokens/Pools können unvollständige historische Daten aufweisen
• Timeout-Fehler: Große Datenanfragen können länger dauern; erwägen Sie Paginierung
• Netzwerkfehler: Überprüfen Sie die Netzwerkverbindung; der Dienst benötigt Internetzugang
• OHLCV-Einschränkungen: Maximaler Bereich zwischen Start- und Enddatum beträgt 1 Jahr; verwenden Sie für längere Zeiträume Paginierung
• 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 Datei LICENSE für Details.

Zusätzliche Ressourcen

• DexPaprika-API-Dokumentation
• Gehosteter MCP-Server, Option ohne Einrichtung
• Modell-Kontext-Protokoll-Spezifikation
• DexPaprika – Umfassende On-Chain-Analysen-Marktdaten
• CoinPaprika – Umfassende Kryptowährungs-Marktdaten