CoinMarketCap MCP

Accede a datos del mercado de criptomonedas, información de intercambios y otras métricas relacionadas con blockchain desde la API de CoinMarketCap.

GitHub

Documentación

Servidor MCP de CoinMarketCap

Una implementación de servidor de Model Context Protocol (MCP) para la API de CoinMarketCap, que proporciona una interfaz estandarizada para acceder a datos de mercado de criptomonedas, información de exchanges y otras métricas relacionadas con blockchain.

Características

Cobertura completa de la API de CoinMarketCap
Obtén datos sobre las últimas tendencias cripto, movimientos del mercado y métricas globales del mercado
Acceso a datos detallados de OHLCV con suscripción Standard o superior
Validación de parámetros con seguridad de tipos mediante Zod

Requisitos previos

Si no tienes una clave de API, primero regístrate para recibir una clave Basic gratuita aquí.

Configuración del cliente

Hay varias opciones para configurar tu cliente MCP con el servidor. Para configuración de servidor alojado/remoto, usa la CLI de Smithery con una clave de API de Smithery. Para instalación local, usa npx o compila desde el código fuente. Cada una de estas opciones se explica a continuación.

Servidor remoto de Smithery (recomendado)

Para agregar un servidor remoto a tu cliente MCP config.json, ejecuta el siguiente comando desde la CLI de Smithery:

npx -y @smithery/cli install @shinzo-labs/coinmarketcap-mcp

Ingresa tu COINMARKETCAP_API_KEY y SUBSCRIPTION_LEVEL (consulta las opciones a continuación) cuando se te solicite.

SDK de Smithery

Si estás desarrollando tu propia aplicación de agente, puedes usar el código de plantilla aquí.

Instalación local con NPX

Para instalar el servidor localmente con npx, agrega lo siguiente a tu cliente MCP config.json:

{
  "mcpServers": {
    "coinmarketcap": {
      "command": "npx",
      "args": [
        "@shinzolabs/coinmarketcap-mcp"
      ],
      "env": {
        "COINMARKETCAP_API_KEY": "your-key-here",
        "SUBSCRIPTION_LEVEL": "Basic" // See options below
      }
    }
  }
}

Compilar desde el código fuente

Descarga el repositorio:

git clone https://github.com/shinzo-labs/coinmarketcap-mcp.git

Instala los paquetes (dentro del repositorio clonado):

pnpm i

Agrega lo siguiente a tu cliente MCP config.json:

{
  "mcpServers": {
    "coinmarketcap": {
      "command": "node",
      "args": [
        "/path/to/coinmarketcap-mcp/index.js"
      ],
      "env": {
        "COINMARKETCAP_API_KEY": "your-key-here",
        "SUBSCRIPTION_LEVEL": "Basic" // See options below
      }
    }
  }
}

Variables de configuración

Variable	Descripción	¿Requerida?	Predeterminado
`COINMARKETCAP_API_KEY`	Clave de API de CoinMarketCap.com	Sí
`SUBSCRIPTION_LEVEL`	`Basic`, `Hobbyist`, `Startup`, `Standard`, `Professional`, o `Enterprise`	No	`Basic`
`PORT`	Puerto para el método de transporte HTTP Streamable	No	`3000`
`TELEMETRY_ENABLED`	Habilitar telemetría	No	`true`

Herramientas compatibles

Nivel de suscripción: Basic (y superior)

Criptomonedas

cryptoCurrencyMap: Obtén el mapeo de todas las criptomonedas
getCryptoMetadata: Obtén metadatos de una o más criptomonedas
allCryptocurrencyListings: Obtén la cotización de mercado más reciente para 1-5000 criptomonedas
cryptoQuotesLatest: Obtén la cotización de mercado más reciente para 1 o más criptomonedas
cryptoCategories: Obtén la lista de todas las categorías de criptomonedas
cryptoCategory: Obtén metadatos sobre una categoría de criptomonedas

Exchange

exchangeMap: Obtén el mapeo de todos los exchanges
exchangeInfo: Obtén metadatos de uno o más exchanges
exchangeAssets: Obtén la lista de todos los activos disponibles en un exchange

DEX

dexInfo: Obtén metadatos de uno o más exchanges descentralizados
dexListingsLatest: Obtén los datos de mercado más recientes de todos los DEX
dexNetworksList: Obtén la lista de todas las redes con IDs únicos
dexSpotPairsLatest: Obtén los datos de mercado más recientes de todos los pares spot DEX activos
dexPairsQuotesLatest: Obtén las cotizaciones de mercado más recientes para pares spot
dexPairsOhlcvLatest: Obtén los datos OHLCV más recientes para pares spot
dexPairsOhlcvHistorical: Obtén datos históricos OHLCV para pares spot
dexPairsTradeLatest: Obtén las operaciones más recientes para pares spot

Métricas globales

globalMetricsLatest: Obtén las métricas globales más recientes de criptomonedas

Índice

cmc100IndexLatest: Obtén el valor más reciente del Índice CoinMarketCap 100 y sus constituyentes
cmc100IndexHistorical: Obtén valores históricos del Índice CoinMarketCap 100

Herramientas

priceConversion: Convierte una cantidad de una criptomoneda o moneda fiduciaria a otra
getPostmanCollection: Obtén la colección de Postman para la API

Otros

fiatMap: Obtén el mapeo de todas las monedas fiduciarias
keyInfo: Obtén el uso y estado de la clave de API
fearAndGreedLatest: Obtén el Índice de Miedo y Codicia más reciente
fearAndGreedHistorical: Obtén valores históricos del Índice de Miedo y Codicia

Nivel de suscripción: Hobbyist (y superior)

Criptomonedas

cryptoAirdrops: Obtén la lista de todos los airdrops de criptomonedas
cryptoAirdrop: Obtén metadatos sobre un airdrop específico
historicalCryptocurrencyListings: Obtén cotizaciones históricas de mercado para cualquier criptomoneda
cryptoQuotesHistorical: Obtén cotizaciones históricas de mercado para cualquier criptomoneda
cryptoQuotesHistoricalV3: Obtén cotizaciones históricas de mercado con intervalos avanzados basados en tiempo

Exchange

exchangeQuotesHistorical: Obtén cotizaciones históricas para cualquier exchange

Métricas globales

globalMetricsHistorical: Obtén métricas globales históricas de criptomonedas

Nivel de suscripción: Startup (y superior)

Criptomonedas

newCryptocurrencyListings: Obtén la lista de criptomonedas agregadas más recientemente
cryptoTrendingGainersLosers: Obtén las mayores ganadoras y perdedoras en un período de tiempo determinado
cryptoTrendingLatest: Obtén las principales criptomonedas por volumen de búsqueda
cryptoTrendingMostVisited: Obtén las criptomonedas más visitadas
cryptoOhlcvLatest: Obtén los datos de mercado OHLCV más recientes para cualquier criptomoneda
cryptoOhlcvHistorical: Obtén datos históricos de mercado OHLCV para cualquier criptomoneda
cryptoPricePerformanceStatsLatest: Obtén estadísticas de rendimiento de precios para cualquier criptomoneda

Nivel de suscripción: Standard (y superior)

Criptomonedas

cryptoMarketPairsLatest: Obtén los pares de mercado más recientes para cualquier criptomoneda

Exchange

exchangeListingsLatest: Obtén los datos de mercado más recientes de todos los exchanges
exchangeMarketPairsLatest: Obtén los pares de mercado más recientes para cualquier exchange
exchangeQuotesLatest: Obtén las cotizaciones de mercado más recientes para uno o más exchanges

Contenido

contentLatest: Obtén las noticias y contenido más recientes sobre criptomonedas
contentPostsTop: Obtén las publicaciones principales sobre criptomonedas
contentPostsLatest: Obtén las publicaciones más recientes sobre criptomonedas
contentPostsComments: Obtén comentarios para una publicación específica

Comunidad

communityTrendingTopic: Obtén temas de tendencia en la comunidad de criptomonedas
communityTrendingToken: Obtén tokens de tendencia en la comunidad de criptomonedas

Nivel de suscripción: Enterprise (y superior)

Blockchain

blockchainStatisticsLatest: Obtén las estadísticas más recientes para una o más blockchains

Contribuciones

¡Las contribuciones son bienvenidas y alentadas! Por favor, lee CONTRIBUTING.md para conocer las pautas sobre problemas, contribuciones e información de contacto.

Recopilación de datos y privacidad

Shinzo Labs recopila telemetría anónima limitada de este servidor para ayudar a mejorar nuestros productos y servicios. No se recopila información personal identificable como parte de este proceso. Consulta la Política de privacidad para obtener más detalles sobre los tipos de datos recopilados y cómo excluirte de esta telemetría.

Licencia

MIT