MCP Crypto Toolkit

Preços de cripto ao vivo, conversão, rastreador de gas, ferramentas de portfólio e calculadoras para agentes de IA — servidor MCP (zero configuração)

GitHubExperimente este MCPPatrocinado

Documentação

mcp-crypto-toolkit

Preços de cripto ao vivo, conversão, rastreador de gas, ferramentas de portfólio e calculadoras para agentes de IA.

Pergunte ao Claude: O que o ETH está fazendo? Top 10 moedas? Gas na Base? Quanto vale meu portfólio?

Hospedado (Conector Personalizado do Claude.ai): https://mcp-crypto-toolkit.nad33mahm3d.workers.dev/mcp
Documentação: DeepWiki · mcpservers.org

Demo

Claude.ai Custom Connector — 10 tools

Recursos

Preços ao vivo com capitalização de mercado, volume, classificação, ATH/ATL (CoinGecko)
Conversão entre cripto e moeda fiduciária (PKR otimizado via Binance P2P quando necessário)
Busca de moedas por nome/símbolo
Top moedas + instantâneo de ganhadores/perdedores
Compare 2–5 moedas lado a lado
Avaliação de portfólio (lote de participações)
Gráficos históricos pontuais e de intervalo (7d/30d/…)
Rastreador de gas EVM com estimativas de transferência em USD
Calculadora de lucro/perda com taxas de exchange e rede
Moedas em alta + Índice de Medo e Ganância (Fear & Greed)
Prompts MCP para fluxos de trabalho comuns
Zero configuração — sem necessidade de chave de API (COINGECKO_API_KEY opcional para limites maiores)
Transportes stdio + HTTP + Cloudflare Workers

Instalação Rápida

npx -y mcp-crypto-toolkit

Instalação

Claude Desktop / Cursor / Windsurf

{
  "mcpServers": {
    "crypto-toolkit": {
      "command": "npx",
      "args": ["-y", "mcp-crypto-toolkit"]
    }
  }
}

Build local:

{
  "mcpServers": {
    "crypto-toolkit": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/mcp-crypto-toolkit/dist/index.js"]
    }
  }
}

Servidor HTTP

npm run build
npm run start:http
# POST http://localhost:3000/mcp

Deploy (Smithery / MCP remoto) — opcional

Você não precisa de hospedagem paga para visibilidade. Este servidor já instala via npx -y mcp-crypto-toolkit (stdio) e está listado no Registro Oficial de MCP. Glama e PulseMCP fazem ingestão a partir daí — sem conta de Fly/Railway necessária.

Só faça deploy HTTP se quiser um endpoint /mcp remoto (ex.: Conector Personalizado do Claude.ai ou publicação de URL no Smithery).

Conector Personalizado do Claude.ai

Endpoint público hospedado (Cloudflare Workers):

https://mcp-crypto-toolkit.nad33mahm3d.workers.dev/mcp

No Claude.ai: Configurações → Conectores → Adicionar conector personalizado
Cole a URL acima (deve incluir /mcp)
Você deve ver 10 ferramentas (obter preço, converter, em alta, …)

Ou faça deploy do seu próprio (Cloudflare / Docker / Render) e use https://YOUR-HOST/mcp. Após atualizar um servidor hospedado, remova e adicione novamente o conector se as ferramentas ainda aparecerem vazias.

Não coloque uma URL remota em claude_desktop_config.json — esse arquivo é apenas stdio. Para uso local no Claude Desktop, prefira:

{
  "mcpServers": {
    "crypto-toolkit": {
      "command": "npx",
      "args": ["-y", "mcp-crypto-toolkit"]
    }
  }
}

Cloudflare Workers (remoto recomendado — plano gratuito)

Usa o transporte MCP padrão da web (src/worker.ts) — sem necessidade de Docker.

Demonstração ao vivo: health · MCP

npm install
npx wrangler login
npm run deploy:cf

Após o deploy: https://mcp-crypto-toolkit.<your-subdomain>.workers.dev/health
URL Claude / Smithery: https://mcp-crypto-toolkit.<your-subdomain>.workers.dev/mcp

Pré-visualização local: npm run dev:cf

Segredos / variáveis opcionais:

npx wrangler secret put COINGECKO_API_KEY
npx wrangler secret put MCP_API_KEY   # optional: require Bearer / x-api-key on /mcp
# Pro keys also need: wrangler.toml [vars] COINGECKO_PRO = "1"
# Optional: RATE_LIMIT_PER_MINUTE = "60" (default)

CI: adicione segredos do repositório CLOUDFLARE_API_TOKEN + CLOUDFLARE_ACCOUNT_ID — o Worker faz auto-deploy no GitHub Release (e via workflow_dispatch).

Render (gratuito — sem cartão de crédito)

Faça fork/conecte o repositório em render.com
Novo → Blueprint → aponte para este repositório (render.yaml usa o plano Free)
Após o deploy: https://YOUR-SERVICE.onrender.com/health
Smithery: publique https://YOUR-SERVICE.onrender.com/mcp

O plano gratuito dorme após ~15 min de inatividade; a primeira solicitação pode levar ~30s para acordar.

Docker (local / seu próprio VPS)

docker build -t mcp-crypto-toolkit .
docker run -p 3000:3000 mcp-crypto-toolkit

PaaS pago (se você superar o plano gratuito): Fly.io e Railway funcionam com o fly.toml / railway.toml incluído, mas não são gratuitos a longo prazo.

Env opcional: COINGECKO_API_KEY, COINGECKO_PRO=1, chaves de oráculo de gas (veja a tabela abaixo).

Ferramentas (10)

Ferramenta	Descrição
`get_price`	Preço ao vivo + capitalização de mercado, volume, classificação, ATH/ATL
`convert`	Conversão cripto ↔ fiduciário/cripto
`search_coin`	Busca por nome ou símbolo
`top_coins`	Top N por capitalização de mercado/volume + ganhadores/perdedores
`compare_coins`	Comparação lado a lado de 2–5 moedas
`portfolio_value`	Avaliar uma lista de participações
`historical_price`	Data pontual ou gráfico de intervalo + instantâneo de investimento
`gas_tracker`	Taxas de gas + custo estimado de transferência (USD)
`profit_calc`	P&L, ROI, ponto de equilíbrio (taxas + taxa de rede)
`trending`	Moedas em alta + Índice de Medo e Ganância

Prompts

Prompt	Finalidade
`market-overview`	Top moedas + em alta + tom do mercado
`whats-trending`	Moedas em alta + Medo e Ganância
`analyze-coin`	Preço + tendência de 7d para uma moeda
`trade-pnl`	Guia passo a passo para cálculo de P&L
`gas-check`	Conselhos sobre gas + custo de transferência

Exemplos de prompts

Qual é o preço atual do Bitcoin e sua capitalização de mercado?
Busque moedas que correspondam a "pepe"
Mostre as top 10 moedas e os ganhadores de hoje
Compare BTC, ETH e SOL
Avalie meu portfólio: 0,5 BTC e 2 ETH em USD
Qual era o preço do ETH em 01-01-2024, e quanto valeriam $1000 daquela época hoje?
Mostre o intervalo de preço de 30 dias do SOL
Qual é o gas na Base agora em USD?
Comprei a 100, vendi a 120, quantidade 10, taxas de 0,1% — lucro?
O que está em alta e qual é o índice de Medo e Ganância?

Desenvolvimento

git clone https://github.com/nad33mahm3d/mcp-crypto-toolkit
cd mcp-crypto-toolkit
npm install
npm test
npm run build
npm run inspector

Env opcional

Variável	Finalidade
`COINGECKO_API_KEY`	Limites de taxa maiores do CoinGecko (ainda opcional)
`COINGECKO_PRO=1`	Usar cabeçalho Pro com sua chave
`MCP_API_KEY`	Somente Worker: exigir Bearer / `x-api-key` em `/mcp`
`RATE_LIMIT_PER_MINUTE`	Somente Worker: `60` padrão
`ETHERSCAN_API_KEY` / `BSCSCAN_API_KEY` / …	Melhores oráculos de gas
`OPTIMISM_API_KEY`	Oráculo de gas da Optimism
`PORT`	Porta do servidor HTTP (padrão 3000)

Sem chaves de API de gas, o gas usa fallback para Blocknative e depois estimativas estáticas.

Contribuindo

Veja CONTRIBUTING.md para configuração, diretrizes de PR e o processo de release.

Código de Conduta
Política de Segurança
Suporte
Changelog
DeepWiki — documentação de arquitetura gerada automaticamente
mcpservers.org

Release (mantenedores)

Uma vez: pacote npm **Configurações → Editor Confiável → GitHub Actions → repositório nad33mahm3d/mcp-crypto-toolkit, workflow publish.yml, ambiente release, permitir npm publish
Atualize CHANGELOG.md
Crie um GitHub Release com a tag vX.Y.Z
Actions publica no npm via OIDC (sem NPM_TOKEN; proveniência automática)

Créditos de API

CoinGecko — preços, mercados, em alta (plano gratuito, sem chave necessária)
Alternative.me — Índice de Medo e Ganância
Binance P2P — USDT/PKR ao converter para PKR
Etherscan e família — oráculos de gas opcionais
Blocknative — fallback de gas

Licença

MIT — veja LICENSE