CoinMarketCap su MCP: prezzi crypto, classifiche, metriche di mercato e Fear and Greed in qualsiasi agente AI

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → CoinMarketCap, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

CoinMarketCap

Dati di mercato crypto dalla CoinMarketCap Pro API: id e metadati di coin ed exchange, prezzi attuali e storici, classifiche e categorie, totali del mercato, indici Fear and Greed, Altcoin Season e CMC100, proof-of-reserves degli exchange e conversione di valute. Sola lettura; il piano Basic gratuito copre la maggior parte dei tool.

Setup

La configurazione richiede circa 2 minuti. Ti serve una API key di CoinMarketCap; il piano Basic gratuito basta per la maggior parte dei tool.

1. Registrati su https://pro.coinmarketcap.com/signup. Il piano Basic offre 10.000 crediti al mese e 30 richieste al minuto.
2. Copia la API key dalla dashboard su https://pro.coinmarketcap.com/account in CMC_PRO_API_KEY. Viene inviata nell'header X-CMC_PRO_API_KEY.
3. Installa il connettore ed esegui coinmarketcap_get_key_info: mostra il piano, il limite di richieste e i crediti rimasti oggi e questo mese, e non consuma crediti.

Prima l'id della coin: i ticker non sono univoci, più coin usano lo stesso simbolo. L'AI risolve un nome o un ticker nell'id numerico CoinMarketCap con coinmarketcap_map_cryptocurrencies (passando symbol) e usa quell'id in tutte le altre chiamate. Id noti: 1 = Bitcoin, 1027 = Ethereum, 825 = Tether, 5426 = Solana. Gli id delle valute fiat per convert_id arrivano da coinmarketcap_map_fiat (2781 = USD), che può elencare anche oro, argento, platino e palladio.

Cosa legge:

• Prezzi attuali: coinmarketcap_get_simple_price per la risposta più rapida, coinmarketcap_get_quotes_latest per la quotazione completa con capitalizzazione, dominanza, volume a 24 ore, variazioni da 1 ora a 90 giorni, offerta e rank.
• Classifiche e filtri: coinmarketcap_list_listings_latest ordina e filtra per prezzo, capitalizzazione, volume, offerta o variazione a 24 ore, coin o token, oppure per tag. coinmarketcap_list_gainers_losers mostra i maggiori rialzi e ribassi su 1h, 24h, 7d o 30d.
• Storico: coinmarketcap_get_quotes_historical per i prezzi a intervalli regolari, coinmarketcap_get_ohlcv_historical per candele giornaliere od orarie, coinmarketcap_get_global_metrics_historical per l'intero mercato nel tempo.
• Profili delle coin: coinmarketcap_get_cryptocurrency_info con descrizione, sito, whitepaper, explorer, link social, tag, data di lancio e indirizzi dei contratti, cercabile anche per indirizzo di contratto. Le categorie (DeFi, Layer 1, Memes, AI e altre) con coinmarketcap_list_categories, le coin di una categoria con coinmarketcap_get_category.
• Sentiment di mercato: coinmarketcap_get_global_metrics (capitalizzazione e volume totali, dominanza di Bitcoin ed Ethereum, dati su DeFi, stablecoin e derivati), coinmarketcap_get_fear_and_greed_latest e coinmarketcap_get_fear_and_greed_historical (0 = paura estrema, 100 = avidità estrema), coinmarketcap_get_altcoin_season_index (sopra 75 altcoin season, sotto 25 Bitcoin season) e coinmarketcap_get_cmc100_index con componenti e pesi.
• Exchange: coinmarketcap_map_exchanges trova l'id (270 = Binance), coinmarketcap_get_exchange_info dà profilo, paesi, valute fiat e commissioni maker e taker, coinmarketcap_get_exchange_assets elenca i wallet di proof-of-reserves con blockchain, token, saldo e valore in USD.
• Conversione: coinmarketcap_convert_price converte un importo di una valuta crypto o fiat in una o più altre.

Sola lettura: ogni tool legge soltanto, quindi nessun tool è disattivato all'installazione.

Formati dei dati: ogni risposta ha un oggetto status (error_code, error_message, credit_count) e il risultato in data. Nei listing e nelle quotazioni più recenti data è una lista e il quote di ogni coin è una lista con una voce per valuta richiesta; altrove quote è un oggetto con la valuta come chiave (quote.USD.price). Prezzi e capitalizzazioni sono nella valuta richiesta, USD per default. Le variazioni sono percentuali (2.5 = +2,5%), le quantità in unità della coin, gli orari ISO 8601 in UTC.

Paginazione: i tool di elenco accettano start (da 1) e limit; la pagina successiva parte da start più limit.

Crediti e piani: ogni chiamata costa almeno un credito. I listing costano un credito ogni 250 coin, le chiamate storiche uno ogni 100 punti, e ogni valuta convert oltre la prima uno in più; lo storico del Fear and Greed costa un credito per chiamata (fino a 500 giorni). I crediti si azzerano ogni giorno e ogni mese, nel piano Basic a mezzanotte UTC. coinmarketcap_get_ohlcv_historical, coinmarketcap_list_gainers_losers e la conversione a un time passato richiedono il piano Startup o superiore. Con Basic le quotazioni storiche arrivano a 1 mese indietro per gli intervalli intraday e a 1 anno per quelli giornalieri.

Errori comuni: 401 indica una key mancante o errata (codici 1001, 1002), 402 un piano non pagato o scaduto, 403 un endpoint non incluso nel tuo piano (1006), 429 il limite al minuto o i crediti giornalieri o mensili esauriti (da 1008 a 1011), 400 un parametro non valido, ad esempio un simbolo sconosciuto; con skip_invalid a true l'AI salta id o simboli sconosciuti invece di far fallire tutta la richiesta.

Il connettore non fa trading, non legge i tuoi conti sugli exchange né i tuoi wallet e non imposta alert sui prezzi. Mostra dati di mercato di CoinMarketCap, non consulenza finanziaria.

Prerequisiti: CMC_PRO_API_KEY

Installazione locale del connettore

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Apri http://localhost:3000/connectors/store, scegli CoinMarketCap e inserisci le variabili elencate nei Prerequisiti.

Tool disponibili

Esempi di prompt

• "Quanto valgono adesso Bitcoin, Ethereum e Solana in EUR, e quanto si sono mossi nelle ultime 24 ore?"
• "Mostrami le prime 20 coin per capitalizzazione con prezzo, variazione a 7 giorni e volume a 24 ore."
• "Com'è andato il Fear and Greed Index negli ultimi 30 giorni, e dove si trova oggi?"
• "Siamo in altcoin season? Dammi anche la dominanza di Bitcoin e la capitalizzazione totale del mercato crypto."
• "Quanto valgono 2,5 ETH in USD e CHF al cambio attuale?"

Prossimi passi

• Collegare a Claude
• Collegare a ChatGPT