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 o Claude buscar programaticamente dados atuais de tokens, pools e DEX 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@latest

O DexPaprika MCP conecta o Claude a dados DEX ao vivo em múltiplas blockchains. O nível gratuito não precisa de chave de API para começar. Instalação | Configuração | Referência da API

Prefere zero configuração? Use o servidor MCP hospedado em mcp.dexpaprika.com: sem instalação, sem chave para começar, as mesmas ferramentas de dados além de submitFeedback. Veja Servidor hospedado para endpoints de transporte.

Última versão

Veja CHANGELOG.md para notas de versão e guias 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 de preço
• Análise de Mercado: Comparações de tokens entre cadeias, tendências de volume e métricas de atividade de negociação
• Rastreadores de Portfólio: Acompanhamento de valor atual, análise de desempenho histórico, oportunidades de rendimento
• Análise Técnica: Realize análise técnica avançada 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 Claude Desktop automaticamente 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 fala MCP via stdin e stdout e não vincula nenhuma porta. Na inicialização, ele escreve DexPaprika MCP server v<version> (tool contract v<contract>) is running... no stderr e então aguarda um cliente. Execute-o a partir de um cliente MCP (Claude Desktop, Cursor, Claude Code) em vez de esperar uma URL 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 Claude Desktop

Adicione o seguinte ao arquivo de configuração do seu 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 DexPaprika estarão disponíveis para o Claude automaticamente.

Opcional: usando uma chave de API

Isso funciona sem chave e sempre funcionará. Sem cadastro, sem cartão, nada para configurar. Tudo acima é a forma suportada de executá-lo.

Uma chave gratuita aumenta o limite mensal e abre streaming em qualquer token, em vez do conjunto público de demonstração. Ela não aumenta o limite de solicitações por minuto, que é o mesmo em ambos os níveis. 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 entra sozinha. Não há prefixo Bearer, nem qualquer outra palavra de esquema. Cole a chave exatamente como foi emitida. Quase todas as outras APIs querem o oposto, então este é o motivo mais comum pelo qual uma chave funcional parece quebrada.

Duas coisas que vale a pena saber:

• Uma chave que não conseguimos ler não gera erro. Os endpoints de dados ignoram uma chave ilegível e atendem você como chamador anônimo, com um 200 normal e dados reais, então um erro de digitação parece exatamente um sucesso. Peça ao assistente para executar getKeyStatus após definir uma: ele informa qual plano a API realmente vê e nomeia a causa provável quando a chave não está chegando.
• Clientes Pro adicionalmente definem DEXPAPRIKA_API_BASE_URL para https://api-pro.dexpaprika.com. O host não muda automaticamente, porque enviar uma chave gratuita para esse host retorna 403.

Servidor hospedado (sem instalação)

Se você prefere zero configuração, 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 Streamable	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

Nota: Estes são endpoints de 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)

Este build auto-hospedado registra 17 ferramentas de leitura: 16 ferramentas de dados de mercado mais getKeyStatus. O servidor hospedado em mcp.dexpaprika.com registra seu próprio conjunto incluindo submitFeedback. Verifique qualquer um com um tools/list ao vivo.

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	Liste todas as redes blockchain suportadas (36)
getStats	Estatísticas de ecossistema de alto nível (total de redes, DEXes, pools, tokens)
search	Pesquise tokens, pools e DEXes em TODAS as redes por nome, símbolo ou endereço
getKeyStatus	Se uma chave está sendo enviada e qual plano a API vê. Não lê dados de mercado.

Operações de DEX

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

Operações de Pool

Ferramenta	Descrição	Parâmetros Obrigatórios
getNetworkPools	PRIMÁRIA. Obtenha os principais pools de liquidez em uma rede	network
getDexPools	Obtenha pools de um DEX específico (linhas sob results, paginação por cursor)	network, dex
getNetworkPoolsFilter	Filtre pools por volume, transações, tempo de criação	network
getPoolDetails	Informações detalhadas do pool (preço, volume, TVL, tokens)	network, pool_address
getPoolOHLCV	Dados históricos de candles OHLCV	network, pool_address, start
getPoolTransactions	Transações/negociações recentes para 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 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 mudança de preço em 24h	network
filterNetworkTokens	Filtre tokens por volume, liquidez, FDV, transações e tempo 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):
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 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 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 os principais pools em cada rede importante."

Limites de Taxa e Desempenho

• Nível gratuito: sem chave, sem cadastro, a 30 solicitações por minuto. Uma chave de API gratuita aumenta a cota mensal e desbloqueia streaming. Pro custa $99/mês a 300 solicitações por minuto. Uma solicitação custa um crédito; endpoints em lote custam um crédito por item. As cotas mensais mudam, então leia-as aqui em vez desta página: https://dexpaprika.com/api/pricing
• Atraso de dados: até 15 segundos no nível gratuito, em tempo real no Pro
• Tempo de Resposta: 100-500ms para a maioria dos endpoints (depende da rede)
• Tratamento de Erros: Erros estruturados com códigos, sugestões e orientação de 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:

• Limite 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: Solicitaçõ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 de OHLCV: O intervalo máximo entre 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 versão detalhadas e guias de migração.

Licença

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

Recursos Adicionais

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