Crypto Data MCP

crypto-data-mcp

Dados de criptomoedas em tempo real para ferramentas de codificação com IA. Um servidor MCP que dá ao Claude Code, Cursor e outras ferramentas compatíveis com MCP acesso a preços ao vivo, dados de mercado, informações de tokens e gráficos históricos — alimentado pela CoinGecko.

Construído por Whoff Agents.

Instalação

Mais rápido: comando único com uvx (sem necessidade de instalação)

uvx crypto-data-mcp

Instalar a partir do PyPI

pip install crypto-data-mcp
# or
uv add crypto-data-mcp

A partir do código-fonte

git clone https://github.com/Wh0FF24/crypto-data-mcp.git
cd crypto-data-mcp
uv sync

Uso com Claude Code

Adicione à sua configuração MCP do Claude Code em ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "crypto-data": {
      "command": "uvx",
      "args": ["crypto-data-mcp"]
    }
  }
}

Ou se instalado via pip/uv:

{
  "mcpServers": {
    "crypto-data": {
      "command": "crypto-data-mcp"
    }
  }
}

Depois, no Claude Code, você pode fazer perguntas como:

• "Qual é o preço atual do Bitcoin?"
• "Compare os preços de ETH, SOL e AVAX"
• "Mostre-me a visão geral do mercado de criptomoedas"
• "Me dê 30 dias do histórico de preços do BTC"
• "Qual é o máximo histórico do Ethereum?"

Ferramentas Disponíveis

get_price

Obtenha o preço atual de um único token.

Parâmetros:

Parâmetro	Tipo	Padrão	Descrição
symbol	string	obrigatório	Símbolo do token (BTC, ETH, SOL) ou ID do CoinGecko
currency	string	"usd"	Moeda de cotação (usd, eur, gbp, etc.)

Exemplo de resposta:

{
  "symbol": "BTC",
  "coingecko_id": "bitcoin",
  "currency": "usd",
  "price": 67250.00,
  "price_change_24h_pct": -1.82,
  "market_cap": 1325000000000,
  "volume_24h": 28500000000,
  "last_updated_at": 1712000000
}

get_prices

Obtenha preços de vários tokens em uma única chamada. Mais eficiente do que chamar get_price repetidamente.

Parâmetros:

Parâmetro	Tipo	Padrão	Descrição
symbols	list[string]	obrigatório	Lista de símbolos (máx. 50)
currency	string	"usd"	Moeda de cotação

Exemplo de resposta:

[
  { "symbol": "BTC", "price": 67250.00, "price_change_24h_pct": -1.82 },
  { "symbol": "ETH", "price": 2064.00, "price_change_24h_pct": -2.15 },
  { "symbol": "SOL", "price": 79.00, "price_change_24h_pct": -3.10 }
]

get_market_overview

Obtenha uma visão geral do mercado de criptomoedas com maiores variações, capitalização de mercado e sentimento.

Parâmetros: Nenhum obrigatório.

Exemplo de resposta:

{
  "total_market_cap_usd": 2390000000000,
  "total_volume_24h_usd": 85000000000,
  "btc_dominance_pct": 55.95,
  "eth_dominance_pct": 11.20,
  "active_cryptocurrencies": 17887,
  "fear_greed_index": { "value": 35, "classification": "Fear" },
  "top_gainers_24h": [ "..." ],
  "top_losers_24h": [ "..." ]
}

get_token_info

Obtenha informações detalhadas sobre um token, incluindo descrição, oferta, ATH/ATL e variações de preço em múltiplos períodos.

Parâmetros:

Parâmetro	Tipo	Padrão	Descrição
symbol	string	obrigatório	Símbolo do token ou ID do CoinGecko

Exemplo de resposta:

{
  "symbol": "ETH",
  "name": "Ethereum",
  "description": "Ethereum is a decentralized...",
  "market_cap_rank": 2,
  "website": "https://www.ethereum.org/",
  "current_price_usd": 2064.00,
  "ath_usd": 4946.05,
  "ath_date": "2021-11-10T14:24:19.604Z",
  "atl_usd": 0.432979,
  "circulating_supply": 120500000,
  "total_supply": 120500000,
  "max_supply": null,
  "price_change_24h_pct": -2.15,
  "price_change_7d_pct": -5.30,
  "price_change_30d_pct": -12.40
}

get_historical_prices

Obtenha dados históricos de preços como pares timestamp/preço para gráficos e análises.

Parâmetros:

Parâmetro	Tipo	Padrão	Descrição
symbol	string	obrigatório	Símbolo do token ou ID do CoinGecko
days	int	7	Dias de histórico (1-365)
currency	string	"usd"	Moeda de cotação

Granularidade: 5 minutos para 1 dia, por hora para 1-90 dias, diária para 90+ dias.

Exemplo de resposta:

{
  "symbol": "BTC",
  "currency": "usd",
  "days": 7,
  "data_points": 168,
  "prices": [
    [1711900000000, 67100.00],
    [1711903600000, 67250.00]
  ]
}

Tokens Suportados

O servidor inclui um mapeamento integrado para mais de 70 tokens populares (BTC, ETH, SOL, USDT, USDC, BNB, XRP, ADA, DOGE, AVAX e muitos outros). Para tokens que não estão no mapeamento integrado, ele busca automaticamente no CoinGecko para resolver o símbolo.

Fonte de Dados

Todos os dados vêm da API do CoinGecko (nível gratuito). O servidor inclui:

• Cache de 60 segundos para reduzir chamadas de API
• Tentativa automática com backoff em limites de taxa
• Tratamento de erros elegante para problemas de rede e entradas inválidas

O nível gratuito do CoinGecko permite aproximadamente 10-30 requisições por minuto.

Desenvolvimento

# Install dependencies
uv sync

# Run tests (uses live CoinGecko API -- may hit rate limits)
uv run pytest tests/ -v

# Run the server directly
uv run crypto-data-mcp

Preços

Nível gratuito — Este servidor MCP de código aberto com dados do CoinGecko é gratuito.

Nível Pro — Em breve por $19/mês com:

• Feeds de preços em tempo real via WebSocket
• Dados DEX (Uniswap, Raydium, Jupiter)
• Análises on-chain
• Rastreamento de carteiras e portfólio
• Limites de taxa mais altos
• Suporte prioritário

Visite whoffagents.com para atualizações.

Receba o Próximo Antes de Chegar ao GitHub

Enviamos uma nova ferramenta MCP ou padrão de agente na maioria das semanas. Assinantes têm acesso antecipado + as notas de desenvolvimento que não entram no README. → Assine gratuitamente em whoffagents.com

Da Equipe Que Entrega em Público

Construímos abertamente e escrevemos sobre o que quebra:

• Por que seu servidor MCP trava às 3 da manhã (e 4 correções que funcionam hoje)
• Meu servidor MCP ficou sem memória às 4 da manhã. A correção tinha 12 linhas.

Licença

MIT

Relacionados

• whoff-agents — habilidades gratuitas do Claude Code para fluxos de trabalho multi-agente, da mesma equipe. Inclui habilidade de âncora de contexto + Atlas Starter Kit.