DexPaprika

Servidor MCP DexPaprika: dados de DEX e criptomoedas em tempo real para agentes de IA

Um servidor Model Context Protocol (MCP) que fornece acesso sob demanda à API de dados de criptomoedas e DEX da DexPaprika. Desenvolvido especificamente para assistentes de IA como o Claude, permite buscar programaticamente dados atuais de tokens, pools e DEXes sem nenhuma configuração.

Resumo

# Install globally
npm install -g dexpaprika-mcp

# Start the server
dexpaprika-mcp

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

O MCP da DexPaprika conecta o Claude a dados de DEX em tempo real em várias blockchains. O plano gratuito não exige chave de API para começar. Instalação | Configuração | Referência da API

Prefere não configurar nada? Use o servidor MCP hospedado em mcp.dexpaprika.com: sem instalação, sem chave para começar, as mesmas ferramentas de dados e mais submitFeedback. Consulte Servidor hospedado para ver os endpoints de transporte.

Versão mais recente

Consulte CHANGELOG.md para ver as notas de versão e os guias de migração.

O que você pode criar?

• Ferramentas de análise de tokens: acompanhe movimentos de preço, alterações na profundidade de liquidez e padrões de volume
• Comparações de DEXes: analise estruturas de taxas, volume e pools disponíveis em diferentes DEXes
• Análises de pools de liquidez: monitore alterações no TVL, cálculos de perda impermanente e avaliações de impacto no preço
• Análise de mercado: comparações de tokens entre redes, tendências de volume e métricas de atividade de negociação
• Rastreadores de portfólio: acompanhamento do valor atual, análise de desempenho histórico e oportunidades de rendimento
• Análise técnica: realize análises técnicas avançadas usando dados históricos OHLCV, incluindo identificação de tendências, reconhecimento de padrões e cálculos de indicadores

Instalação

Instalação via Smithery

Para instalar o DexPaprika automaticamente no Claude Desktop via Smithery:

npx -y smithery mcp add coinpaprika/dexpaprika

Instalação manual

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

# Start the server
dexpaprika-mcp

Este é um servidor stdio: ele se comunica via MCP usando stdin e stdout e não vincula nenhuma porta. Ao iniciar, grava DexPaprika MCP server v<version> (tool contract v<contract>) is running... em stderr e aguarda um cliente. Execute-o a partir de um cliente MCP (Claude Desktop, Cursor, Claude Code), em vez de esperar uma URL para abrir no navegador.

Tutorial em vídeo

Assista ao nosso tutorial passo a passo sobre como configurar e usar o servidor MCP DexPaprika:

Integração com o Claude Desktop

Adicione o seguinte ao arquivo de configuração do 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"]
    }
  }
}

Depois de reiniciar o Claude Desktop, as ferramentas do DexPaprika ficarão disponíveis automaticamente para o Claude.

Opcional: usar uma chave de API

Isso funciona sem uma chave e sempre funcionará. Não é necessário se cadastrar, usar cartão ou configurar nada. Tudo acima é a forma recomendada de executar o servidor.

Uma chave gratuita aumenta a cota mensal e habilita streaming para qualquer token, em vez de apenas para o conjunto público de demonstração. Ela não aumenta o limite de solicitações por minuto, que é igual nos dois planos. Obtenha uma em console.dexpaprika.com; os limites atuais estão na página de limites de taxa.

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

A chave deve ser inserida sozinha, como o valor completo de Authorization. Cole-a exatamente como foi fornecida, sem nada antes dela. Quase todas as outras APIs exigem algo antes da chave, então esse é o motivo mais comum para uma chave válida parecer não funcionar.

Dois pontos importantes:

• Uma chave que não conseguimos ler não gera um erro. Os endpoints de dados ignoram uma chave ilegível e atendem você como um usuário anônimo, com um 200 normal e dados reais; assim, um erro de digitação parece funcionar. Peça ao assistente para executar getKeyStatus depois de configurar a chave: a ferramenta informa qual plano a API realmente reconhece e indica a causa provável quando a chave não está sendo recebida.
• Clientes Dev e Pro também devem definir DEXPAPRIKA_API_BASE_URL como https://api-pro.dexpaprika.com, que é igualmente necessário para getTokenOHLCV. O host não muda automaticamente, pois enviar uma chave gratuita para esse host resulta em 403.

Servidor hospedado (sem instalação)

Se preferir não configurar nada, conecte qualquer cliente compatível com MCP diretamente ao servidor hospedado em mcp.dexpaprika.com. A página inicial fornece instruções de configuração e documentação. Os seguintes endpoints de transporte estão disponíveis:

Transporte	Endpoint	Caso de uso
HTTP com streaming	https://mcp.dexpaprika.com/streamable-http	Recomendado para a maioria dos clientes
SSE	https://mcp.dexpaprika.com/sse	Transporte SSE legado
JSON-RPC	https://mcp.dexpaprika.com/json-rpc	JSON-RPC direto

Observação: estes são endpoints do protocolo MCP. Eles não exibem nada no navegador. Acesse mcp.dexpaprika.com para ver a página inicial.

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

Ferramentas disponíveis (20)

Esta versão auto-hospedada registra 20 ferramentas de leitura: 19 ferramentas de dados de mercado mais getKeyStatus. O servidor hospedado em mcp.dexpaprika.com registra seu próprio conjunto, incluindo submitFeedback. Verifique qualquer um deles com um tools/list em tempo real.

Descoberta

Ferramenta	Descrição
getCapabilities	Recursos do servidor, padrões de fluxo de trabalho, sinônimos de redes e práticas recomendadas. Comece aqui.
getNetworks	Lista todas as redes blockchain compatíveis (36)
getStats	Estatísticas gerais do ecossistema (total de redes, DEXes, pools e tokens)
search	Pesquisa tokens, pools e DEXes em TODAS as redes por nome, símbolo ou endereço
getKeyStatus	Informa se uma chave está sendo enviada e qual plano a API reconhece. Não lê dados de mercado.

Operações de DEX

Ferramenta	Descrição	Parâmetros obrigatórios
getNetworkDexes	Lista as DEXes em uma rede específica	network

Operações de pool

Ferramenta	Descrição	Parâmetros obrigatórios
getNetworkPools	PRINCIPAL. Obtém os pools com maior liquidez em uma rede	network
getDexPools	Obtém pools de uma DEX específica (linhas sob results, paginação por cursor; para avançar além da primeira página é necessária uma chave)	network, dex
getNetworkPoolsFilter	Filtra pools por volume, transações e horário de criação	network
getPoolDetails	Informações detalhadas do pool (preço, volume, TVL e tokens)	network, pool_address
getPoolOHLCV	Dados históricos de candles OHLCV	network, pool_address, start
getPoolIndicator	RSI, EMA, MACD, Bandas de Bollinger ou VWAP para um pool, calculados no servidor a partir dos candles. Os mesmos limites de plano para histórico e intervalo de getPoolOHLCV	network, pool_address, indicator
getPoolTransactions	Transações/negociações recentes de um pool	network, pool_address

Operações de token

Ferramenta	Descrição	Parâmetros obrigatórios
getTokenDetails	Informações detalhadas do token	network, token_address
getTokenPools	Pools de liquidez que contêm um token (filtro por rede, results + paginação por cursor; para avançar além da primeira página é necessária uma chave)	network, token_address
getTokenOHLCV	Candles OHLCV históricos em USD para um token, ponderados por volume em todos os pools em que ele é negociado. Requer um plano Dev ou Pro em api-pro.dexpaprika.com; solicitações sem chave e com chave gratuita recebem 403	network, token_address, start
getTokenIndicator	Os mesmos indicadores aplicados aos candles em USD de um token em todos os pools em que ele é negociado. Requer um plano Dev ou Pro em api-pro.dexpaprika.com; solicitações sem chave e com chave gratuita recebem 403	network, token_address, indicator
getTokenMultiPrices	Preços em lote para até 10 tokens	network, tokens[]
getTopTokens	Principais tokens de uma rede, classificados por volume, liquidez, FDV ou variação de preço em 24h	network
filterNetworkTokens	Filtra tokens por volume, liquidez, FDV, transações e horário de criação	network

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

Exemplos de prompts para o Claude

• "Analise o token JUP na Solana. Busque o preço, o volume e os principais pools de liquidez."
• "Compare o volume de negociação entre Uniswap V3 e SushiSwap na Ethereum."
• "Obtenha o OHLCV por hora do último dia para SOL/USDC na Raydium e crie um gráfico de preços."
• "Encontre os 5 principais pools por liquidez na rede Fantom e analise suas estruturas de taxas."
• "Obtenha transações recentes do pool ETH/USDT na Uniswap e analise a pressão de compra e venda."
• "Mostre os 10 principais pools na Ethereum por volume em 24h."
• "Pesquise todos os pools que contêm o token ARB e classifique-os por volume."
• "Filtre pools da Ethereum com volume acima de US$ 100 mil em 24h, criados na última semana."
• "Primeiro, obtenha todas as redes disponíveis; depois, mostre os principais pools de cada rede importante."

Limites de taxa e desempenho

• Plano gratuito: sem chave, sem cadastro, com limite de 15 solicitações por minuto. Uma chave de API gratuita aumenta esse limite para 30 solicitações por minuto, aumenta a cota mensal e habilita streaming: cadastre-se em https://console.dexpaprika.com. O plano Pro custa US$ 99/mês e permite 500 solicitações por minuto; há também um plano Dev de US$ 30 com limite de 120. Cada solicitação custa um crédito; endpoints em lote custam um crédito por item. Documentação completa em https://docs.dexpaprika.com. As cotas mensais mudam, então consulte-as aqui em vez de usar as informações desta página: https://dexpaprika.com/api/pricing
• A paginação dos resultados de pesquisa exige uma chave: em getNetworkPools, getDexPools, getNetworkPoolsFilter, getTokenPools, filterNetworkTokens e getTopTokens, a primeira página funciona sem chave, mas passar cursor para buscar uma página posterior exige uma chave de API. Com uma chave gratuita, é possível paginar sem limite.
• Atraso dos dados: até 60 segundos no plano gratuito; em tempo real nos planos pagos
• Novos pools e tokens na pesquisa: sem um plano Dev ou superior, getNetworkPools, getDexPools, getTokenPools, getNetworkPoolsFilter, getTopTokens e filterNetworkTokens não incluem pools e tokens criados na última hora. Portanto, uma janela created_after inferior a uma hora, ou os pools de um token lançado na última hora, retorna resultados vazios. getPoolDetails e getTokenDetails respondem independentemente da idade. Chaves Dev, Pro e Enterprise em api-pro.dexpaprika.com os veem assim que são indexados. Detalhes: https://docs.dexpaprika.com/knowledge-base/rate-limits#search-freshness
• Tempo de resposta: 100–500 ms para a maioria dos endpoints (dependendo da rede)
• Tratamento de erros: erros estruturados com códigos, sugestões e orientações para novas tentativas
• Disponibilidade de dados OHLCV: dados históricos geralmente disponíveis desde a criação do token/pool

Solução de problemas

Problemas comuns:

• Limite de taxa: se receber erros DP429_RATE_LIMIT, implemente recuo exponencial
• Dados ausentes: alguns tokens/pools mais recentes podem ter dados históricos incompletos
• Erros de tempo limite: solicitações de grandes volumes de dados podem demorar mais; considere usar paginação
• Erros de rede: verifique a conectividade; o serviço exige acesso à internet
• Limitações de OHLCV: uma solicitação retorna até 1000 candles (limit); para abranger um período maior, avance start e faça outra solicitação. Sem uma chave, o OHLCV cobre as últimas 24 horas em 1h e períodos maiores (start: "-24h"); uma chave gratuita permite consultar 7 dias em 10m e períodos maiores. Consulte Limites de OHLCV por plano
• OHLCV vazio: o pool pode ser recente demais. Use getPoolTransactions em vez disso

Desenvolvimento

# 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 alterações

Consulte CHANGELOG.md para ver notas de versão detalhadas e guias de migração.

Licença

Este projeto está licenciado sob a Licença MIT. Consulte o arquivo LICENSE para obter detalhes.

Recursos adicionais

• Documentação da API DexPaprika
• Servidor MCP hospedado, opção sem configuração
• Especificação do Model Context Protocol
• DexPaprika - Dados abrangentes de mercado para análises on-chain
• CoinPaprika - Dados abrangentes do mercado de criptomoedas