DexPaprika MCP Server

oficial

Acesse análises DEX em tempo real em mais de 20 blockchains com a API DexPaprika, rastreando mais de 5 milhões de tokens, pools, volumes e dados históricos de mercado. Criado pela CoinPaprika.

GitHub

Documentação

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 zero configuração.

Resumo

# Install globally
npm install -g dexpaprika-mcp

# Start the server
dexpaprika-mcp

# Or run directly without installation
npx dexpaprika-mcp

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 14 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 lado do servidor por volume, transações, data de criação).

Quebra de compatibilidade: 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 completo de migração.

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 no TVL, cálculos de perda impermanente e avaliações de impacto no 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"]
    }
  }
}

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 (14)

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 33 redes blockchain suportadas
`getStats`	Estatísticas de alto nível do ecossistema (total de redes, DEXes, pools, tokens)
`search`	Busca tokens, pools e DEXes em TODAS as redes por nome, símbolo ou endereço

Operações de DEX

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

Operações de Pool

Ferramenta	Descrição	Parâmetros Obrigató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 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	`network`, `token_address`
`getTokenMultiPrices`	Preços em lote para até 10 tokens	`network`, `tokens[]`

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 all pools for a specific token with volume sorting:
const jupiterPools = await getTokenPools({
  network: "solana",
  token_address: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
  order_by: "volume_usd",
  limit: 5
});

// Get top pools on Ethereum:
const ethereumPools = await getNetworkPools({
  network: "ethereum",
  order_by: "volume_usd",
  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_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."
"Busque todos os pools que contêm 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 tipicamente 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 levar mais tempo, considere paginação
Erros de rede: Verifique a conectividade de rede, o serviço requer acesso à internet
Limitações do 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