DexPaprika

Servidor MCP de DexPaprika

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso bajo demanda a la API de datos de criptomonedas y DEX de DexPaprika. Construido específicamente para asistentes de IA como Claude para obtener programáticamente datos actuales de tokens, pools y DEX con cero configuración.

Resumen

# Install globally
npm install -g dexpaprika-mcp

# Start the server
dexpaprika-mcp

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

DexPaprika MCP conecta a Claude con datos DEX en vivo a través de múltiples blockchains. El nivel gratuito no necesita clave API para comenzar. Instalación | Configuración | Referencia de API

¿Prefieres cero configuración? Usa el servidor MCP alojado en mcp.dexpaprika.com: sin instalación, sin clave para comenzar, las mismas herramientas de datos más submitFeedback. Consulta Servidor alojado para los endpoints de transporte.

Última versión

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

¿Qué Puedes Construir?

• Herramientas de Análisis de Tokens: Rastrea movimientos de precios, cambios en la profundidad de liquidez y patrones de volumen
• Comparaciones de DEX: Analiza estructuras de tarifas, volumen y pools disponibles en diferentes DEX
• Analítica de Pools de Liquidez: Monitorea cambios en TVL, cálculos de pérdida impermanente y evaluaciones de impacto en el precio
• Análisis de Mercado: Comparaciones de tokens entre cadenas, tendencias de volumen y métricas de actividad comercial
• Rastreadores de Portafolio: Seguimiento de valor actual, análisis de rendimiento histórico, oportunidades de rendimiento
• Análisis Técnico: Realiza análisis técnico avanzado usando datos históricos OHLCV, incluyendo identificación de tendencias, reconocimiento de patrones y cálculos de indicadores

Instalación

Instalación vía Smithery

Para instalar DexPaprika para Claude Desktop automáticamente vía 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: habla MCP sobre stdin y stdout y no vincula ningún puerto. Al iniciar, escribe DexPaprika MCP server v<version> (tool contract v<contract>) is running... en stderr y luego espera a un cliente. Ejecútalo desde un cliente MCP (Claude Desktop, Cursor, Claude Code) en lugar de esperar una URL en un navegador.

Video Tutorial

Mira nuestro tutorial paso a paso sobre cómo configurar y usar el servidor MCP de DexPaprika:

Integración con Claude Desktop

Agrega lo siguiente a tu 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, las herramientas de DexPaprika estarán disponibles para Claude automáticamente.

Opcional: usando una clave API

Esto funciona sin una clave y siempre lo hará. Sin registro, sin tarjeta, nada que configurar. Todo lo anterior es la forma compatible de ejecutarlo.

Una clave gratuita aumenta el límite mensual y abre streaming en cualquier token en lugar del conjunto público de demostración. No aumenta el límite de solicitudes por minuto, que es el mismo en ambos niveles. Obtén una en console.dexpaprika.com; los límites actuales están en la página de límites de tasa.

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

La clave se coloca sola. No hay prefijo Bearer, ni tampoco otra palabra de esquema. Pega la clave exactamente como se emitió. Casi todas las demás APIs quieren lo contrario, así que esta es la razón más común por la que una clave funcional parece rota.

Dos cosas que vale la pena saber:

• Una clave que no podemos leer no produce un error. Los endpoints de datos ignoran una clave ilegible y te atienden como llamador anónimo, con un 200 normal y datos reales, así que un error tipográfico parece exactamente un éxito. Pide al asistente que ejecute getKeyStatus después de configurar una: informa qué plan ve realmente la API y nombra la causa probable cuando la clave no llega.
• Los clientes Pro además configuran DEXPAPRIKA_API_BASE_URL a https://api-pro.dexpaprika.com. El host no cambia automáticamente, porque enviar una clave gratuita a ese host devuelve 403.

Servidor alojado (sin instalación)

Si prefieres cero configuración, apunta cualquier cliente compatible con MCP directamente al servidor alojado en mcp.dexpaprika.com. La página de inicio proporciona instrucciones de configuración y documentación. Los siguientes endpoints de transporte están disponibles:

Transporte	Endpoint	Caso de uso
HTTP Streamable	https://mcp.dexpaprika.com/streamable-http	Recomendado para la mayoría de 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 de protocolo MCP. No mostrarán nada en un navegador. Visita mcp.dexpaprika.com para la página de inicio.

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

Herramientas Disponibles (17)

Esta compilación autoalojada registra 17 herramientas de lectura: 16 herramientas de datos de mercado más getKeyStatus. El servidor alojado en mcp.dexpaprika.com registra su propio conjunto incluyendo submitFeedback. Verifica cualquiera con un tools/list en vivo.

Descubrimiento

Herramienta	Descripción
getCapabilities	Capacidades del servidor, patrones de flujo de trabajo, sinónimos de red y mejores prácticas. Empieza aquí.
getNetworks	Lista cada red blockchain compatible (36)
getStats	Estadísticas de ecosistema de alto nivel (redes totales, DEX, pools, tokens)
search	Busca tokens, pools y DEX en TODAS las redes por nombre, símbolo o dirección
getKeyStatus	Si se envía una clave y qué plan ve la API. No lee datos de mercado.

Operaciones de DEX

Herramienta	Descripción	Parámetros Requeridos
getNetworkDexes	Lista DEX en una red específica	network

Operaciones de Pool

Herramienta	Descripción	Parámetros Requeridos
getNetworkPools	PRINCIPAL. Obtén los pools de mayor liquidez en una red	network
getDexPools	Obtén pools de un DEX específico (filas bajo results, paginación por cursor)	network, dex
getNetworkPoolsFilter	Filtra pools por volumen, transacciones, tiempo de creación	network
getPoolDetails	Información detallada del pool (precio, volumen, TVL, tokens)	network, pool_address
getPoolOHLCV	Datos históricos de velas OHLCV	network, pool_address, start
getPoolTransactions	Transacciones/operaciones recientes para un pool	network, pool_address

Operaciones de Token

Herramienta	Descripción	Parámetros Requeridos
getTokenDetails	Información detallada del token	network, token_address
getTokenPools	Pools de liquidez que contienen un token (filtro con alcance de red, results + paginación por cursor)	network, token_address
getTokenMultiPrices	Precios por lotes para hasta 10 tokens	network, tokens[]
getTopTokens	Tokens principales en una red clasificados por volumen, liquidez, FDV o cambio de precio en 24h	network
filterNetworkTokens	Filtra tokens por volumen, liquidez, FDV, transacciones y tiempo 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):
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"
  ]
});

Prompts de Ejemplo para Claude

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

Límites de Tasa y Rendimiento

• Nivel gratuito: sin clave, sin registro, a 15 solicitudes por minuto. Una clave API gratuita aumenta eso a 30 solicitudes por minuto, aumenta la cuota mensual y desbloquea streaming: regístrate en https://console.dexpaprika.com. Pro es $99/mes a 500 solicitudes por minuto, y hay un plan Dev de $30 a 120. Una 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 léelas aquí en lugar de en esta página: https://dexpaprika.com/api/pricing
• Retraso de datos: hasta 60 segundos en el nivel gratuito, tiempo real en los planes de pago
• Tiempo de respuesta: 100-500ms para la mayoría de endpoints (depende de la red)
• Manejo de errores: Errores estructurados con códigos, sugerencias y guía de reintentos
• Disponibilidad de datos OHLCV: Los datos históricos están típicamente disponibles desde la fecha de creación del token/pool

Solución de Problemas

Problemas comunes:

• Límite de tasa: Si recibes errores DP429_RATE_LIMIT, implementa retroceso exponencial
• Datos faltantes: Algunos tokens/pools más nuevos pueden tener datos históricos incompletos
• Errores de tiempo de espera: Las solicitudes de datos grandes pueden tardar más, considera la paginación
• Errores de red: Verifica la conectividad de red, el servicio requiere acceso a internet
• Limitaciones de OHLCV: Una solicitud devuelve hasta 1000 velas (limit); para un período más largo, mueve start hacia adelante y pregunta de nuevo. Sin clave, OHLCV cubre las últimas 24 horas en 1h y más (start: "-24h"); una clave gratuita abre 7 días en 10m y más. Consulta Límites de OHLCV por plan
• OHLCV vacío: El pool puede ser 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 notas de versión detalladas y guías de migración.

Licencia

Este proyecto está licenciado bajo la Licencia MIT: consulta el archivo LICENSE para más detalles.

Recursos Adicionales

• Documentación de la API de DexPaprika
• Servidor MCP Alojado, opción de cero configuración
• Especificación del Protocolo de Contexto de Modelo
• DexPaprika - Datos de mercado analíticos onchain integrales
• CoinPaprika - Datos de mercado de criptomonedas integrales