Crypto Data MCP

Servidor MCP gratuito para datos de criptomonedas en tiempo real. 5 herramientas: get_price, get_market_overview, get_token_info, get_historical_prices, get_trending. Más de 70 tokens compatibles a través de la API de CoinGecko.

Documentación

crypto-data-mcp

CI PyPI License: MIT

Datos de criptomonedas en tiempo real para herramientas de codificación con IA. Un servidor MCP que brinda a Claude Code, Cursor y otras herramientas compatibles con MCP acceso a precios en vivo, datos de mercado, información de tokens y gráficos históricos, impulsado por CoinGecko.

Creado por Whoff Agents.

Instalación

Más rápido: una línea con uvx (sin instalación necesaria)

uvx crypto-data-mcp

Instalar desde PyPI

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

Desde el código fuente

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

Uso con Claude Code

Agrégalo a tu configuración de MCP de Claude Code en ~/.claude/claude_desktop_config.json:

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

O si lo instalaste vía pip/uv:

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

Luego, en Claude Code, puedes hacer preguntas como:

  • "¿Cuál es el precio actual de Bitcoin?"
  • "Compara los precios de ETH, SOL y AVAX"
  • "Muéstrame el panorama general del mercado de criptomonedas"
  • "Dame 30 días del historial de precios de BTC"
  • "¿Cuál es el máximo histórico de Ethereum?"

Herramientas Disponibles

get_price

Obtén el precio actual de un solo token.

Parámetros:

ParámetroTipoPredeterminadoDescripción
symbolstringobligatorioSímbolo del token (BTC, ETH, SOL) o ID de CoinGecko
currencystring"usd"Moneda de cotización (usd, eur, gbp, etc.)

Ejemplo de respuesta:

{
  "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

Obtén precios de múltiples tokens en una sola llamada. Más eficiente que llamar a get_price repetidamente.

Parámetros:

ParámetroTipoPredeterminadoDescripción
symbolslist[string]obligatorioLista de símbolos (máx. 50)
currencystring"usd"Moneda de cotización

Ejemplo de respuesta:

[
  { "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

Obtén un panorama general del mercado de criptomonedas con los mayores movimientos, capitalización de mercado y sentimiento.

Parámetros: No se requieren.

Ejemplo de respuesta:

{
  "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

Obtén información detallada sobre un token, incluyendo descripción, suministro, máximo/mínimo histórico y cambios de precio en múltiples marcos temporales.

Parámetros:

ParámetroTipoPredeterminadoDescripción
symbolstringobligatorioSímbolo del token o ID de CoinGecko

Ejemplo de respuesta:

{
  "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

Obtén datos históricos de precios como pares de marca de tiempo/precio para gráficos y análisis.

Parámetros:

ParámetroTipoPredeterminadoDescripción
symbolstringobligatorioSímbolo del token o ID de CoinGecko
daysint7Días de historial (1-365)
currencystring"usd"Moneda de cotización

Granularidad: 5 minutos para 1 día, por hora para 1-90 días, diaria para más de 90 días.

Ejemplo de respuesta:

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

Tokens Compatibles

El servidor incluye un mapeo integrado para más de 70 tokens populares (BTC, ETH, SOL, USDT, USDC, BNB, XRP, ADA, DOGE, AVAX y muchos más). Para tokens que no están en el mapeo integrado, busca automáticamente en CoinGecko para resolver el símbolo.

Fuente de Datos

Todos los datos provienen de la API de CoinGecko (nivel gratuito). El servidor incluye:

  • Caché de 60 segundos para reducir las llamadas a la API
  • Reintento automático con retroceso en límites de tasa
  • Manejo elegante de errores para problemas de red y entradas inválidas

El nivel gratuito de CoinGecko permite aproximadamente 10-30 solicitudes por minuto.

Desarrollo

# 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

Precios

Nivel gratuito — Este servidor MCP de código abierto con datos de CoinGecko es gratuito.

Nivel Pro — Próximamente a $19/mes con:

  • Fuentes de precios en tiempo real vía WebSocket
  • Datos DEX (Uniswap, Raydium, Jupiter)
  • Análisis en cadena
  • Seguimiento de carteras y billeteras
  • Límites de tasa más altos
  • Soporte prioritario

Visita whoffagents.com para actualizaciones.

Obtén el Próximo Antes de que Llegue a GitHub

Publicamos una nueva herramienta MCP o patrón de agente casi todas las semanas. Los suscriptores obtienen acceso anticipado + las notas de desarrollo que no llegan al README. → Suscríbete gratis en whoffagents.com

Del Equipo que Publica en Público

Construimos en abierto y documentamos lo que falla:

Licencia

MIT

Relacionado

  • whoff-agents — habilidades gratuitas de Claude Code para flujos de trabajo multiagente, del mismo equipo. Incluye la habilidad de anclaje de contexto + Atlas Starter Kit.