DexPaprika

Servidor MCP de DexPaprika

Un servidor de Model Context Protocol (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.

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 a Claude con datos DEX en vivo a través de múltiples blockchains. El nivel gratuito no necesita clave API para empezar. 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 empezar, 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: Sigue movimientos de precios, cambios en la profundidad de liquidez y patrones de volumen
• Comparaciones de DEX: Analiza estructuras de comisiones, volumen y pools disponibles en diferentes DEXes
• 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 de trading
• 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 mediante Smithery

Para instalar DexPaprika para Claude Desktop automáticamente 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: habla MCP a través de 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.

Tutorial en Video

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

Integración con Claude Desktop

Añade 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: usar una clave API

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

Una clave gratuita aumenta el límite mensual y abre el 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 por sí sola. No hay prefijo Bearer, ni ninguna 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, por lo 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
Streamable HTTP	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 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 todas las redes blockchain compatibles (36)
getStats	Estadísticas de ecosistema de alto nivel (total de redes, DEXes, pools, tokens)
search	Busca tokens, pools y DEXes en TODAS las redes por nombre, símbolo o dirección
getKeyStatus	Si se está enviando una clave y qué plan ve la API. No lee datos de mercado.

Operaciones de DEX

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

Operaciones de Pool

Herramienta	Descripción	Parámetros requeridos
getNetworkPools	PRINCIPAL. Obtén los principales pools de 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 de 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 por red, results + paginación por cursor)	network, token_address
getTokenMultiPrices	Precios por lotes para hasta 10 tokens	network, tokens[]
getTopTokens	Principales tokens 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: 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"
  ]
});

Prompts de Ejemplo para Claude

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

Límites de Tasa y Rendimiento

• Nivel gratuito: sin clave, sin registro, a 30 solicitudes por minuto. Una clave API gratuita aumenta la cuota mensual y desbloquea el streaming. Pro cuesta $99/mes a 300 solicitudes por minuto. Una solicitud cuesta un crédito; los endpoints por lotes cuestan un crédito por elemento. 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 15 segundos en el nivel gratuito, tiempo real en Pro
• Tiempo de respuesta: 100-500ms para la mayoría de los 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 suelen estar 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: El rango máximo entre fechas de inicio y fin es de 1 año; usa paginación para períodos más largos
• 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 Model Context Protocol
• DexPaprika - Datos de mercado completos de analítica onchain
• CoinPaprika - Datos completos del mercado de criptomonedas