CoinMarketCap MCP

Acesse dados do mercado de criptomoedas, informações de exchanges e outras métricas relacionadas a blockchain da API do CoinMarketCap.

GitHub

Documentação

CoinMarketCap MCP Server

Uma implementação de servidor Model Context Protocol (MCP) para a API do CoinMarketCap, fornecendo uma interface padronizada para acessar dados de mercado de criptomoedas, informações de exchanges e outras métricas relacionadas a blockchain.

Recursos

Cobertura completa da API do CoinMarketCap
Obtenha dados sobre as últimas tendências de criptomoedas, movimentos de mercado e métricas globais do mercado
Acesso a dados detalhados de OHLCV com assinatura Standard ou superior
Validação de parâmetros com segurança de tipos usando Zod

Pré-requisitos

Se você não tiver uma chave de API, primeiro cadastre-se para receber uma chave Basic gratuita aqui.

Configuração do Cliente

Existem várias opções para configurar seu cliente MCP com o servidor. Para configuração de servidor hospedado/remoto, use a CLI do Smithery com uma Chave de API do Smithery. Para instalação local, use npx ou compile a partir do código-fonte. Cada uma dessas opções é explicada abaixo.

Servidor Remoto Smithery (Recomendado)

Para adicionar um servidor remoto ao seu cliente MCP config.json, execute o seguinte comando da CLI do Smithery:

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

Informe seu COINMARKETCAP_API_KEY e SUBSCRIPTION_LEVEL (veja as opções abaixo) quando solicitado.

Smithery SDK

Se você está desenvolvendo sua própria aplicação de agente, pode usar o código boilerplate aqui.

Instalação Local via NPX

Para instalar o servidor localmente com npx, adicione o seguinte ao seu 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 a partir do Código-Fonte

Baixe o repositório:

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

Instale os pacotes (dentro do repositório clonado):

pnpm i

Adicione o seguinte ao seu 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
      }
    }
  }
}

Variáveis de Configuração

Variável	Descrição	Obrigatório?	Padrão
`COINMARKETCAP_API_KEY`	Chave de API do CoinMarketCap.com	Sim
`SUBSCRIPTION_LEVEL`	`Basic`, `Hobbyist`, `Startup`, `Standard`, `Professional` ou `Enterprise`	Não	`Basic`
`PORT`	Porta para o método de transporte HTTP Streamable	Não	`3000`
`TELEMETRY_ENABLED`	Habilitar telemetria	Não	`true`

Ferramentas Suportadas

Nível de Assinatura: Basic (e superior)

Criptomoedas

cryptoCurrencyMap: Obter mapeamento de todas as criptomoedas
getCryptoMetadata: Obter metadados de uma ou mais criptomoedas
allCryptocurrencyListings: Obter cotação de mercado mais recente para 1-5000 criptomoedas
cryptoQuotesLatest: Obter cotação de mercado mais recente para 1 ou mais criptomoedas
cryptoCategories: Obter lista de todas as categorias de criptomoedas
cryptoCategory: Obter metadados sobre uma categoria de criptomoedas

Exchange

exchangeMap: Obter mapeamento de todas as exchanges
exchangeInfo: Obter metadados de uma ou mais exchanges
exchangeAssets: Obter lista de todos os ativos disponíveis em uma exchange

DEX

dexInfo: Obter metadados de uma ou mais exchanges descentralizadas
dexListingsLatest: Obter dados de mercado mais recentes para todas as DEXs
dexNetworksList: Obter lista de todas as redes com IDs exclusivos
dexSpotPairsLatest: Obter dados de mercado mais recentes para todos os pares spot DEX ativos
dexPairsQuotesLatest: Obter cotações de mercado mais recentes para pares spot
dexPairsOhlcvLatest: Obter dados OHLCV mais recentes para pares spot
dexPairsOhlcvHistorical: Obter dados OHLCV históricos para pares spot
dexPairsTradeLatest: Obter negociações mais recentes para pares spot

Métricas Globais

globalMetricsLatest: Obter métricas globais mais recentes de criptomoedas

Índice

cmc100IndexLatest: Obter valor e constituintes mais recentes do Índice CoinMarketCap 100
cmc100IndexHistorical: Obter valores históricos do Índice CoinMarketCap 100

Ferramentas

priceConversion: Converter um valor de uma criptomoeda ou moeda fiduciária em outra
getPostmanCollection: Obter coleção Postman para a API

Outros

fiatMap: Obter mapeamento de todas as moedas fiduciárias
keyInfo: Obter uso e status da chave de API
fearAndGreedLatest: Obter Índice de Medo e Ganância mais recente
fearAndGreedHistorical: Obter valores históricos do Índice de Medo e Ganância

Nível de Assinatura: Hobbyist (e superior)

Criptomoedas

cryptoAirdrops: Obter lista de todos os airdrops de criptomoedas
cryptoAirdrop: Obter metadados sobre um airdrop específico
historicalCryptocurrencyListings: Obter cotações históricas de mercado para qualquer criptomoeda
cryptoQuotesHistorical: Obter cotações históricas de mercado para qualquer criptomoeda
cryptoQuotesHistoricalV3: Obter cotações históricas de mercado com intervalos avançados baseados em tempo

Exchange

exchangeQuotesHistorical: Obter cotações históricas para qualquer exchange

Métricas Globais

globalMetricsHistorical: Obter métricas globais históricas de criptomoedas

Nível de Assinatura: Startup (e superior)

Criptomoedas

newCryptocurrencyListings: Obter lista de criptomoedas adicionadas mais recentemente
cryptoTrendingGainersLosers: Obter maiores altas e baixas em um determinado período
cryptoTrendingLatest: Obter principais criptomoedas por volume de busca
cryptoTrendingMostVisited: Obter criptomoedas mais visitadas
cryptoOhlcvLatest: Obter dados de mercado OHLCV mais recentes para qualquer criptomoeda
cryptoOhlcvHistorical: Obter dados de mercado OHLCV históricos para qualquer criptomoeda
cryptoPricePerformanceStatsLatest: Obter estatísticas de desempenho de preço para qualquer criptomoeda

Nível de Assinatura: Standard (e superior)

Criptomoedas

cryptoMarketPairsLatest: Obter pares de mercado mais recentes para qualquer criptomoeda

Exchange

exchangeListingsLatest: Obter dados de mercado mais recentes para todas as exchanges
exchangeMarketPairsLatest: Obter pares de mercado mais recentes para qualquer exchange
exchangeQuotesLatest: Obter cotações de mercado mais recentes para uma ou mais exchanges

Conteúdo

contentLatest: Obter notícias e conteúdo mais recentes sobre criptomoedas
contentPostsTop: Obter principais publicações sobre criptomoedas
contentPostsLatest: Obter publicações mais recentes sobre criptomoedas
contentPostsComments: Obter comentários de uma publicação específica

Comunidade

communityTrendingTopic: Obter tópicos em alta na comunidade de criptomoedas
communityTrendingToken: Obter tokens em alta na comunidade de criptomoedas

Nível de Assinatura: Enterprise (e superior)

Blockchain

blockchainStatisticsLatest: Obter estatísticas mais recentes para uma ou mais blockchains

Contribuindo

Contribuições são bem-vindas e incentivadas! Leia CONTRIBUTING.md para diretrizes sobre issues, contribuições e informações de contato.

Coleta de Dados e Privacidade

A Shinzo Labs coleta telemetria anônima limitada deste servidor para ajudar a melhorar nossos produtos e serviços. Nenhuma informação pessoalmente identificável é coletada como parte desse processo. Revise a Política de Privacidade para mais detalhes sobre os tipos de dados coletados e como optar por não participar dessa telemetria.

Licença

MIT