DexPaprika

Servidor MCP de DexPaprika: datos de DEX y criptomonedas en tiempo real para agentes de IA

Un servidor del Model Context Protocol (MCP) que proporciona acceso bajo demanda a la API de datos de criptomonedas y DEX de DexPaprika. Diseñado específicamente para asistentes de IA como Claude, permite obtener mediante programación datos actuales de tokens, pools y DEX sin necesidad de configuración.

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 conecta Claude con datos de DEX en tiempo real de varias cadenas de bloques. El nivel gratuito no requiere una clave de API para empezar. Instalación | Configuración | Referencia de la API

¿Prefieres no configurar nada? Usa el servidor MCP alojado en mcp.dexpaprika.com: sin instalación ni clave para empezar, con las mismas herramientas de datos y submitFeedback. Consulta Servidor alojado para ver los endpoints de transporte.

Última versión

Consulta CHANGELOG.md para ver las notas de la versión y las guías de migración.

¿Qué puedes crear?

• Herramientas de análisis de tokens: sigue los movimientos de precios, los cambios en la profundidad de liquidez y los patrones de volumen
• Comparaciones de DEX: analiza las estructuras de comisiones, el volumen y los pools disponibles en distintos DEX
• Análisis de pools de liquidez: supervisa los cambios en el TVL, calcula las pérdidas impermanentes y evalúa el impacto en los precios
• Análisis de mercado: compara tokens entre cadenas, tendencias de volumen y métricas de actividad de trading
• Seguimiento de carteras: seguimiento del valor actual, análisis del rendimiento histórico y oportunidades de rendimiento
• Análisis técnico: realiza análisis técnicos avanzados con datos históricos OHLCV, incluida la identificación de tendencias, el reconocimiento de patrones y el cálculo de indicadores

Instalación

Instalación mediante Smithery

Para instalar DexPaprika automáticamente en Claude Desktop mediante Smithery:

npx -y smithery mcp add coinpaprika/dexpaprika

Instalación manual

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

# Start the server
dexpaprika-mcp

Este es un servidor stdio: se comunica mediante MCP a través de stdin y stdout, y no abre ningún puerto. Al iniciarse, escribe DexPaprika MCP server v<version> (tool contract v<contract>) is running... en stderr y espera a un cliente. Ejecútalo desde un cliente MCP (Claude Desktop, Cursor, Claude Code), en lugar de esperar una URL para abrir en un navegador.

Tutorial en video

Mira nuestro tutorial paso a paso para configurar y usar el servidor MCP de DexPaprika:

Integración con Claude Desktop

Añade lo siguiente al archivo de configuración de 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"]
    }
  }
}

Después de reiniciar Claude Desktop, Claude tendrá acceso automáticamente a las herramientas de DexPaprika.

Opcional: usar una clave de API

Funciona sin clave y siempre será así. No hace falta registrarse, usar una tarjeta ni configurar nada. Todo lo anterior es la forma recomendada de ejecutarlo.

Una clave gratuita aumenta la cuota mensual y habilita el streaming para cualquier token, en lugar de limitarlo al conjunto público de muestra. No aumenta el límite de solicitudes por minuto, que es el mismo en ambos niveles. Consigue una en console.dexpaprika.com; consulta los límites actuales en la página de límites de solicitudes.

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

La clave se introduce sola, como valor completo de Authorization. Pégala exactamente como se emitió, sin anteponerle nada. Casi todas las demás API requieren anteponer algo a la clave, por lo que este es el motivo más común por el que una clave válida parece no funcionar.

Dos cosas que conviene saber:

• Si no podemos leer una clave, no se produce ningún error. Los endpoints de datos ignoran las claves ilegibles y te atienden como usuario anónimo, con un 200 normal y datos reales, así que un error tipográfico parece funcionar. Después de configurarla, pide al asistente que ejecute getKeyStatus: indica qué plan detecta la API y señala la causa probable si la clave no se está aplicando.
• Los clientes Dev y Pro también deben establecer DEXPAPRIKA_API_BASE_URL en https://api-pro.dexpaprika.com, que es también lo que necesita getTokenOHLCV. El host no cambia automáticamente, porque enviar una clave gratuita a ese host devuelve 403.

Servidor alojado (sin instalación)

Si prefieres no configurar nada, conecta cualquier cliente compatible con MCP directamente al servidor alojado en mcp.dexpaprika.com. La página de inicio incluye instrucciones de configuración y documentación. Están disponibles los siguientes endpoints de transporte:

Transporte	Endpoint	Caso de uso
HTTP con streaming	https://mcp.dexpaprika.com/streamable-http	Recomendado para la mayoría de los clientes
SSE	https://mcp.dexpaprika.com/sse	Transporte SSE heredado
JSON-RPC	https://mcp.dexpaprika.com/json-rpc	JSON-RPC directo

Nota: Estos son endpoints del protocolo MCP. No mostrarán nada en un navegador. Visita mcp.dexpaprika.com para acceder a la página de inicio.

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

Herramientas disponibles (20)

Esta compilación autohospedada registra 20 herramientas de solo lectura: 19 herramientas de datos de mercado y getKeyStatus. El servidor alojado en mcp.dexpaprika.com registra su propio conjunto, que incluye submitFeedback. Comprueba cualquiera de los dos con un tools/list en vivo.

Descubrimiento

Herramienta	Descripción
getCapabilities	Capacidades del servidor, patrones de flujo de trabajo, sinónimos de redes y prácticas recomendadas. Empieza aquí.
getNetworks	Lista todas las redes de cadena de bloques compatibles (36)
getStats	Estadísticas generales del ecosistema (total de redes, DEX, pools y tokens)
search	Busca tokens, pools y DEX en TODAS las redes por nombre, símbolo o dirección
getKeyStatus	Indica si se está enviando una clave y qué plan detecta la API. No consulta datos de mercado.

Operaciones de DEX

Herramienta	Descripción	Parámetros obligatorios
getNetworkDexes	Lista los DEX de una red específica	network

Operaciones de pools

Herramienta	Descripción	Parámetros obligatorios
getNetworkPools	PRINCIPAL. Obtiene los pools con mayor liquidez de una red	network
getDexPools	Obtiene los pools de un DEX específico (filas bajo results, paginación con cursor; para avanzar más allá de la primera página se necesita una clave)	network, dex
getNetworkPoolsFilter	Filtra pools por volumen, transacciones y fecha de creación	network
getPoolDetails	Información detallada del pool (precio, volumen, TVL y tokens)	network, pool_address
getPoolOHLCV	Datos históricos de velas OHLCV	network, pool_address, start
getPoolIndicator	RSI, EMA, MACD, bandas de Bollinger o VWAP para un pool, calculados en el servidor a partir de sus velas. Se aplican los mismos límites de plan para el historial y el intervalo que en getPoolOHLCV	network, pool_address, indicator
getPoolTransactions	Transacciones/operaciones recientes de un pool	network, pool_address

Operaciones de tokens

Herramienta	Descripción	Parámetros obligatorios
getTokenDetails	Información detallada del token	network, token_address
getTokenPools	Pools de liquidez que contienen un token (filtro limitado a la red, results + paginación con cursor; para avanzar más allá de la primera página se necesita una clave)	network, token_address
getTokenOHLCV	Velas OHLCV históricas en USD para un token, ponderadas por volumen entre todos los pools en los que se negocia. Requiere un plan Dev o Pro en api-pro.dexpaprika.com; las solicitudes sin clave y con claves gratuitas reciben 403	network, token_address, start
getTokenIndicator	Los mismos indicadores sobre las velas en USD de un token, entre todos los pools en los que se negocia. Requiere un plan Dev o Pro en api-pro.dexpaprika.com; las solicitudes sin clave y con claves gratuitas reciben 403	network, token_address, indicator
getTokenMultiPrices	Precios agrupados de hasta 10 tokens	network, tokens[]
getTopTokens	Tokens principales de una red, clasificados por volumen, liquidez, FDV o variación de precio en 24 h	network
filterNetworkTokens	Filtra tokens por volumen, liquidez, FDV, transacciones y fecha de creación	network

Ejemplo de uso

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

Ejemplos de prompts para Claude

• "Analiza el token JUP en Solana. Obtén el precio, el volumen y los principales pools de liquidez."
• "Compara el volumen de trading entre Uniswap V3 y SushiSwap en Ethereum."
• "Obtén el OHLCV por hora del último día para SOL/USDC en Raydium y crea un gráfico de precios."
• "Encuentra los 5 pools con mayor liquidez en la red Fantom y analiza sus estructuras de comisiones."
• "Obtén las transacciones recientes del pool ETH/USDT en Uniswap y analiza la presión compradora frente a la vendedora."
• "Muéstrame los 10 pools principales de Ethereum por volumen en 24 h."
• "Busca todos los pools que contengan el token ARB y ordénalos por volumen."
• "Filtra los pools de Ethereum con un volumen superior a $100K en 24 h creados durante la última semana."
• "Primero obtén todas las redes disponibles y luego muéstrame los pools principales de cada red importante."

Límites de solicitudes y rendimiento

• Nivel gratuito: sin clave ni registro, con 15 solicitudes por minuto. Una clave de API gratuita aumenta el límite a 30 solicitudes por minuto, amplía la cuota mensual y habilita el streaming: regístrate en https://console.dexpaprika.com. Pro cuesta $99 al mes y permite 500 solicitudes por minuto; también hay un plan Dev de $30 con 120. Cada solicitud cuesta un crédito; los endpoints por lotes cuestan un crédito por elemento. Documentación completa en https://docs.dexpaprika.com. Las cuotas mensuales cambian, así que consúltalas aquí en lugar de basarte en esta página: https://dexpaprika.com/api/pricing
• Se necesita una clave para paginar los resultados de búsqueda: en getNetworkPools, getDexPools, getNetworkPoolsFilter, getTokenPools, filterNetworkTokens y getTopTokens, la primera página funciona sin clave, pero se necesita una clave de API para pasar cursor y obtener una página posterior. Con una clave gratuita se puede paginar sin límite.
• Retraso de los datos: hasta 60 segundos en el nivel gratuito; en tiempo real en los planes de pago
• Pools y tokens nuevos en las búsquedas: sin un plan Dev o superior, getNetworkPools, getDexPools, getTokenPools, getNetworkPoolsFilter, getTopTokens y filterNetworkTokens excluyen los pools y tokens creados durante la última hora, por lo que una ventana de created_after inferior a una hora, o los pools de un token lanzado durante la última hora, no devuelve resultados. getPoolDetails y getTokenDetails responden sin importar la antigüedad. Las claves Dev, Pro y Enterprise en api-pro.dexpaprika.com los muestran en cuanto se indexan. Más información: https://docs.dexpaprika.com/knowledge-base/rate-limits#search-freshness
• Tiempo de respuesta: 100-500 ms para la mayoría de los endpoints (según la red)
• Gestión de errores: errores estructurados con códigos, sugerencias e indicaciones para reintentar
• Disponibilidad de datos OHLCV: los datos históricos suelen estar disponibles desde la fecha de creación del token/pool

Solución de problemas

Problemas comunes:

• Límite de solicitudes: si recibes errores DP429_RATE_LIMIT, implementa una espera exponencial
• Faltan datos: algunos tokens/pools más recientes pueden tener datos históricos incompletos
• Errores de tiempo de espera: las solicitudes de grandes volúmenes de datos pueden tardar más; considera usar la paginación
• Errores de red: comprueba la conectividad de red; el servicio requiere acceso a Internet
• Limitaciones de OHLCV: una solicitud devuelve hasta 1000 velas (limit); para abarcar un período más largo, adelanta start y vuelve a solicitar los datos. Sin una clave, OHLCV cubre las últimas 24 horas en 1h y períodos más largos (start: "-24h"); una clave gratuita permite consultar 7 días en 10m y períodos más largos. Consulta Límites de OHLCV por plan
• OHLCV vacío: puede que el pool sea demasiado nuevo. Usa getPoolTransactions en su lugar

Desarrollo

# 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

Registro de cambios

Consulta CHANGELOG.md para ver las notas detalladas de la versión y las guías de migración.

Licencia

Este proyecto está licenciado bajo la licencia MIT. Consulta el archivo LICENSE para obtener más información.

Recursos adicionales

• Documentación de la API de DexPaprika
• Servidor MCP alojado, opción sin configuración
• Especificación del Model Context Protocol
• DexPaprika - Datos de mercado para análisis onchain integral
• CoinPaprika - Datos integrales del mercado de criptomonedas