DexPaprika

Servidor MCP DexPaprika

Um servidor Model Context Protocol (MCP) que fornece acesso sob demanda à API de dados de criptomoedas e DEX da DexPaprika. Construído especificamente para assistentes de IA como Claude buscarem programaticamente dados de tokens, pools e DEX em tempo real com configuração zero.

Resumo

# Install globally
npm install -g dexpaprika-mcp

# Start the server
dexpaprika-mcp

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

O DexPaprika MCP conecta o Claude a dados DEX ao vivo em múltiplos blockchains. Sem necessidade de chaves de API. Instalação | Configuração | Referência da API

Prefere configuração zero? Use o servidor MCP hospedado em mcp.dexpaprika.com: sem instalação, sem chave de API, mesmas 17 ferramentas. Veja Alternativa Hospedada para endpoints de transporte.

Destaques da Atualização da Versão 1.3.0

Novas ferramentas: getCapabilities (integração de agentes com fluxos de trabalho, sinônimos, melhores práticas) e getNetworkPoolsFilter (filtragem de pools no servidor por volume, transações, data de criação).

Alteração significativa: Parâmetros renomeados para snake_case (poolAddress → pool_address, tokenAddress → token_address, orderBy → order_by). A paginação agora é indexada a partir de 1. Veja CHANGELOG.md para o guia de migração completo.

O Que Você Pode Construir?

• Ferramentas de Análise de Tokens: Acompanhe movimentos de preço, mudanças na profundidade de liquidez e padrões de volume
• Comparações de DEX: Analise estruturas de taxas, volume e pools disponíveis em diferentes DEXes
• Análise de Pools de Liquidez: Monitore mudanças de TVL, cálculos de perda impermanente e avaliações de impacto de preço
• Análise de Mercado: Comparações de tokens entre blockchains, tendências de volume e métricas de atividade de negociação
• Rastreadores de Portfólio: Acompanhamento de valor em tempo real, análise de desempenho histórico, 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

Instalando via Smithery

Para instalar o DexPaprika para o Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @coinpaprika/dexpaprika-mcp --client claude

Instalação Manual

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

# Verify installation
dexpaprika-mcp --version

# Start the server
dexpaprika-mcp

O servidor roda na porta 8010 por padrão. Você verá MCP server is running at http://localhost:8010 quando iniciado com sucesso.

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 seu 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"]
    }
  }
}

Após reiniciar o Claude Desktop, as ferramentas do DexPaprika estarão disponíveis para o Claude automaticamente.

Alternativa Hospedada (Sem Instalação)

Se você prefere configuração zero, aponte qualquer cliente compatível com MCP diretamente para o 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 Transmissível	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/mcp	JSON-RPC direto

Nota: Estes são endpoints do protocolo MCP — eles não exibirão nada em um navegador. Visite mcp.dexpaprika.com para a página inicial.

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

Ferramentas Disponíveis (17)

Descoberta

Ferramenta	Descrição
getCapabilities	Capacidades do servidor, padrões de fluxo de trabalho, sinônimos de rede e melhores práticas. Comece aqui.
getNetworks	Lista todas as redes blockchain suportadas (36+)
getStats	Estatísticas de alto nível do ecossistema (total de redes, DEXes, pools, tokens)
search	Pesquisa tokens, pools e DEXes em TODAS as redes por nome, símbolo ou endereço

Operações de DEX

Ferramenta	Descrição	Parâmetros Necessários
getNetworkDexes	Lista DEXes em uma rede específica	network

Operações de Pool

Ferramenta	Descrição	Parâmetros Necessários
getNetworkPools	PRIMÁRIO — Obtém os principais pools de liquidez em uma rede	network
getDexPools	Obtém pools de uma DEX específica	network, dex
getNetworkPoolsFilter	Filtra pools por volume, transações, data de criação	network
getPoolDetails	Informações detalhadas do pool (preço, volume, TVL, tokens)	network, pool_address
getPoolOHLCV	Dados históricos de velas OHLCV	network, pool_address, start
getPoolTransactions	Transações/trocas recentes para um pool	network, pool_address

Operações de Token

Ferramenta	Descrição	Parâmetros Necessários
getTokenDetails	Informações detalhadas do token	network, token_address
getTokenPools	Pools de liquidez contendo um token (filtro com escopo de rede, results + paginação por cursor)	network, token_address
getTokenMultiPrices	Preços em lote para até 10 tokens	network, tokens[]
getTopTokens	Principais tokens em 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 data de criação	network

Feedback

Ferramenta	Descrição	Parâmetros Necessários
submitFeedback	Reporta comportamentos inesperados da ferramenta, dados ausentes ou lacunas na documentação diretamente para a equipe	goal

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

Exemplos de Prompts para o Claude

• "Analise o token JUP na Solana. Busque preço, volume e os principais pools de liquidez."
• "Compare o volume de negociação entre Uniswap V3 e SushiSwap na Ethereum."
• "Obtenha os dados OHLCV de 7 dias para SOL/USDC na Raydium e plote 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 para o pool ETH/USDT na Uniswap e analise a pressão de compra vs venda."
• "Mostre-me os 10 principais pools na Ethereum por volume em 24h."
• "Pesquise todos os pools contendo o token ARB e classifique-os por volume."
• "Filtre pools da Ethereum com volume em 24h >$100K criados na última semana."
• "Primeiro obtenha todas as redes disponíveis, depois mostre-me os principais pools em cada rede principal."

Limites de Taxa e Desempenho

• Limites do Nível Gratuito: 10.000 requisições por dia
• Tempo de Resposta: 100-500ms para a maioria dos endpoints (dependente da rede)
• Atualização dos Dados: Dados de pool e token atualizados a cada 15-30s
• Tratamento de Erros: Erros estruturados com códigos, sugestões e orientação para nova tentativa
• Disponibilidade de Dados OHLCV: Dados históricos normalmente disponíveis a partir da data de criação do token/pool

Solução de Problemas

Problemas Comuns:

• Limitação de taxa: Se receber erros DP429_RATE_LIMIT, implemente backoff exponencial
• Dados ausentes: Alguns tokens/pools mais novos podem ter dados históricos incompletos
• Erros de timeout: Requisições de dados grandes podem demorar mais, considere paginação
• Erros de rede: Verifique a conectividade de rede, o serviço requer acesso à internet
• Limitações OHLCV: O intervalo máximo entre as datas de início e fim é de 1 ano; use paginação para períodos mais longos
• OHLCV vazio: O pool pode ser muito novo — 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

Changelog

Veja CHANGELOG.md para notas de lançamento detalhadas e guias de migração.

Licença

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

Recursos Adicionais

• Documentação da API DexPaprika
• Servidor MCP Hospedado — Alternativa com configuração zero
• Especificação do Model Context Protocol
• DexPaprika - Dados de mercado abrangentes de análise onchain
• CoinPaprika - Dados de mercado abrangentes de criptomoedas