DexPaprika

Servidor MCP 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. Diseñado específicamente para asistentes de IA como Claude, permite obtener mediante programación datos de tokens, pools y DEX en tiempo real sin 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. No se requieren claves API. Instalación | Configuración | Referencia de API

¿Prefieres configuración cero? Usa el servidor MCP alojado en mcp.dexpaprika.com: sin instalación, sin clave API, las mismas 17 herramientas. Consulta Alternativa Alojada para los endpoints de transporte.

Novedades de la Versión 1.3.0

Nuevas herramientas: getCapabilities (incorporación de agentes con flujos de trabajo, sinónimos, mejores prácticas) y getNetworkPoolsFilter (filtrado de pools del lado del servidor por volumen, transacciones, tiempo de creación).

Cambios importantes: Parámetros renombrados a snake_case (poolAddress → pool_address, tokenAddress → token_address, orderBy → order_by). La paginación ahora está indexada en 1. Consulta CHANGELOG.md para la guía de migración completa.

¿Qué Puedes Construir?

• Herramientas de Análisis de Tokens: Seguimiento de movimientos de precio, cambios en la profundidad de liquidez y patrones de volumen.
• Comparaciones de DEX: Análisis de estructuras de comisiones, volumen y pools disponibles en diferentes DEX.
• Analíticas de Pools de Liquidez: Monitoreo de 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 en tiempo real, análisis de rendimiento histórico, oportunidades de rendimiento.
• Análisis Técnico: Realiza análisis técnico avanzado utilizando 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/cli install @coinpaprika/dexpaprika-mcp --client claude

Instalación Manual

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

# Verify installation
dexpaprika-mcp --version

# Start the server
dexpaprika-mcp

El servidor se ejecuta en el puerto 8010 por defecto. Verás MCP server is running at http://localhost:8010 cuando se inicie correctamente.

Video Tutorial

Mira nuestro tutorial paso a paso sobre cómo configurar y usar el servidor MCP 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.

Alternativa Alojada (Sin Instalación)

Si prefieres configuración cero, 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 Transmisible	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/mcp	JSON-RPC directo

Nota: Estos son endpoints del 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)

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 soportadas (36+)
getStats	Estadísticas del ecosistema de alto nivel (total de redes, DEX, pools, tokens)
search	Busca tokens, pools y DEX en TODAS las redes por nombre, símbolo o dirección

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 — Obtiene los pools de liquidez principales en una red	network
getDexPools	Obtiene pools de un DEX específico	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 por ámbito de red, results + paginación por cursor)	network, token_address
getTokenMultiPrices	Precios por lote 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

Retroalimentación

Herramienta	Descripción	Parámetros Requeridos
submitFeedback	Reporta comportamientos inesperados de herramientas, datos faltantes o lagunas en la documentación directamente al equipo	goal

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

Ejemplos de Prompts para Claude

• "Analiza el token JUP en Solana. Obtén precio, volumen y los pools de liquidez principales."
• "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 pools principales por liquidez en la red Fantom y analiza sus estructuras de comisiones."
• "Obtén las 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 >$100K de volumen en 24h creados en la última semana."
• "Primero obtén todas las redes disponibles, luego muéstrame los pools principales en cada red principal."

Límites de Tasa y Rendimiento

• Límites del Nivel Gratuito: 10,000 solicitudes por día
• Tiempo de Respuesta: 100-500ms para la mayoría de los endpoints (dependiendo de la red)
• Frescura de Datos: Datos de pools y tokens actualizados cada 15-30s
• Manejo de Errores: Errores estructurados con códigos, sugerencias y guía de reintento
• Disponibilidad de Datos OHLCV: Datos históricos típicamente disponibles desde la fecha de creación del token/pool

Solución de Problemas

Problemas Comunes:

• Limitación 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 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 lanzamiento 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 — Alternativa sin configuración
• Especificación del Protocolo de Contexto de Modelo
• DexPaprika - Datos de mercado analíticos onchain completos
• CoinPaprika - Datos de mercado de criptomonedas completos