MCP Crypto Toolkit

mcp-crypto-toolkit

Precios de criptomonedas en vivo, conversión, rastreador de gas, herramientas de portafolio y calculadoras para agentes de IA.

Pregúntale a Claude: ¿Qué está haciendo ETH? ¿Top 10 monedas? ¿Gas en Base? ¿Cuánto vale mi portafolio?

Alojado (Conector personalizado de Claude.ai): https://mcp-crypto-toolkit.nad33mahm3d.workers.dev/mcp
Documentación: DeepWiki · mcpservers.org

Características

• Precios en vivo con capitalización de mercado, volumen, ranking, ATH/ATL (CoinGecko)
• Conversión entre cripto y moneda fiduciaria (PKR optimizado vía Binance P2P cuando sea necesario)
• Búsqueda de monedas por nombre/símbolo
• Resumen de monedas principales + ganadoras/perdedoras
• Comparación de 2–5 monedas lado a lado
• Valoración de portafolio (tenencias en lote)
• Gráficos históricos puntuales y de rango (7d/30d/…)
• Rastreador de gas EVM con estimaciones de transferencia en USD
• Calculadora de ganancias/pérdidas con comisiones de exchange y red
• Monedas en tendencia + Índice de Miedo y Avaricia Cripto
• Prompts MCP para flujos de trabajo comunes
• Cero configuración — no se requiere clave API (opcional COINGECKO_API_KEY para límites más altos)
• Transportes stdio + HTTP + Cloudflare Workers

Instalación rápida

npx -y mcp-crypto-toolkit

Instalación

Claude Desktop / Cursor / Windsurf

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

Compilación 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

Despliegue (Smithery / MCP remoto) — opcional

No necesitas hosting de pago para la visibilidad. Este servidor ya se instala vía npx -y mcp-crypto-toolkit (stdio) y está listado en el Registro Oficial de MCP. Glama y PulseMCP se alimentan desde allí — sin factura de Fly/Railway.

Solo despliega HTTP si quieres un endpoint de /mcp remoto (por ejemplo, Conector personalizado de Claude.ai o publicación de URL en Smithery).

Conector personalizado de Claude.ai

Endpoint público alojado (Cloudflare Workers):

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

1. En Claude.ai: Configuración → Conectores → Añadir conector personalizado
2. Pega la URL anterior (debe incluir /mcp)
3. Deberías ver 10 herramientas (obtener precio, convertir, tendencias, …)

O despliega el tuyo propio (Cloudflare / Docker / Render) y usa https://YOUR-HOST/mcp. Después de actualizar un servidor alojado, elimina y vuelve a añadir el conector si las herramientas siguen apareciendo vacías.

No pongas una URL remota en claude_desktop_config.json — ese archivo es solo stdio. Para uso local en Claude Desktop, prefiere:

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

Cloudflare Workers (remoto recomendado — nivel gratuito)

Usa el transporte MCP estándar web (src/worker.ts) — no requiere Docker.

Demo en vivo: salud · MCP

npm install
npx wrangler login
npm run deploy:cf

Después del despliegue: https://mcp-crypto-toolkit.<your-subdomain>.workers.dev/health
URL de Claude / Smithery: https://mcp-crypto-toolkit.<your-subdomain>.workers.dev/mcp

Vista previa local: npm run dev:cf

Secretos / variables opcionales:

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: añade secretos del repositorio CLOUDFLARE_API_TOKEN + CLOUDFLARE_ACCOUNT_ID — el Worker se despliega automáticamente en GitHub Release (y vía workflow_dispatch).

Render (gratuito — sin tarjeta de crédito)

1. Haz fork/conecta el repositorio en render.com
2. Nuevo → Blueprint → apunta a este repositorio (render.yaml usa el plan Gratuito)
3. Después del despliegue: https://YOUR-SERVICE.onrender.com/health
4. Smithery: publica https://YOUR-SERVICE.onrender.com/mcp

El nivel gratuito se suspende después de ~15 min de inactividad; la primera solicitud puede tardar ~30s en reactivarse.

Docker (local / tu propio VPS)

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

PaaS de pago (si superas el nivel gratuito): Fly.io y Railway funcionan con el fly.toml / railway.toml incluido, pero no son gratuitos a largo plazo.

Env opcional: COINGECKO_API_KEY, COINGECKO_PRO=1, claves de oráculo de gas (ver tabla abajo).

Herramientas (10)

Herramienta	Descripción
get_price	Precio en vivo + capitalización de mercado, volumen, ranking, ATH/ATL
convert	Conversión cripto ↔ fiduciario/cripto
search_coin	Búsqueda por nombre o símbolo
top_coins	Top N por capitalización de mercado/volumen + ganadoras/perdedoras
compare_coins	Comparación lado a lado de 2–5 monedas
portfolio_value	Valorar una lista de tenencias
historical_price	Fecha puntual o gráfico de rango + resumen de inversión
gas_tracker	Comisiones de gas + costo estimado de transferencia (USD)
profit_calc	P&L, ROI, punto de equilibrio (comisiones + tarifa de red)
trending	Monedas en tendencia + Índice de Miedo y Avaricia

Prompts

Prompt	Propósito
market-overview	Monedas principales + tendencias + tono del mercado
whats-trending	Monedas en tendencia + Miedo y Avaricia
analyze-coin	Precio + tendencia de 7d para una moneda
trade-pnl	Guía paso a paso para un cálculo de P&L
gas-check	Asesoría sobre gas + costo de transferencia

Ejemplos de prompts

1. ¿Cuál es el precio actual de Bitcoin y su capitalización de mercado?
2. Busca monedas que coincidan con "pepe"
3. Muestra las 10 monedas principales y las ganadoras de hoy
4. Compara BTC, ETH y SOL
5. Valora mi portafolio: 0.5 BTC y 2 ETH en USD
6. ¿Cuál era el precio de ETH el 01-01-2024, y cuánto valdrían $1000 de entonces ahora?
7. Muestra el rango de precios de SOL en 30 días
8. ¿Cuál es el gas en Base ahora mismo en USD?
9. Compré a 100, vendí a 120, cantidad 10, comisiones 0.1% — ¿ganancia?
10. ¿Qué está en tendencia y cuál es el índice de Miedo y Avaricia?

Desarrollo

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

Variable	Propósito
COINGECKO_API_KEY	Límites de tasa más altos de CoinGecko (sigue siendo opcional)
COINGECKO_PRO=1	Usar encabezado Pro con tu clave
MCP_API_KEY	Solo Worker: requerir Bearer / x-api-key en /mcp
RATE_LIMIT_PER_MINUTE	Solo Worker: 60 predeterminado
ETHERSCAN_API_KEY / BSCSCAN_API_KEY / …	Mejores oráculos de gas
OPTIMISM_API_KEY	Oráculo de gas de Optimism
PORT	Puerto del servidor HTTP (predeterminado 3000)

Sin claves de API de gas, el gas recurre a Blocknative y luego a estimaciones estáticas.

Contribuciones

Consulta CONTRIBUTING.md para configuración, pautas de PR y el proceso de lanzamiento.

• Código de Conducta
• Política de Seguridad
• Soporte
• Registro de cambios
• DeepWiki — documentación de arquitectura generada automáticamente
• mcpservers.org

Lanzamiento (mantenedores)

1. Una vez: paquete npm **Configuración → Editor de confianza → GitHub Actions → repositorio nad33mahm3d/mcp-crypto-toolkit, flujo de trabajo publish.yml, entorno release, permitir npm publish
2. Actualiza CHANGELOG.md
3. Crea un GitHub Release con la etiqueta vX.Y.Z
4. Actions publica en npm vía OIDC (sin NPM_TOKEN; procedencia automática)

Créditos de API

• CoinGecko — precios, mercados, tendencias (nivel gratuito, sin clave requerida)
• Alternative.me — Índice de Miedo y Avaricia
• Binance P2P — USDT/PKR al convertir a PKR
• Etherscan y familia — oráculos de gas opcionales
• Blocknative — respaldo de gas

Licencia

MIT — ver LICENSE