Coinmarketcap

By shinzo-labs GitHub

coinmarketcap crypto

Overview

what is CoinMarketCap MCP?

CoinMarketCap MCP is an implementation of the Model Context Protocol (MCP) for the CoinMarketCap API, providing a standardized interface for accessing cryptocurrency market data, exchange information, and blockchain-related metrics.

how to use CoinMarketCap MCP?

To use CoinMarketCap MCP, you need to sign up for a free API key from CoinMarketCap. You can install it via NPX or manually download the repository and configure it in your application.

key features of CoinMarketCap MCP?

Complete coverage of the CoinMarketCap API
Fetch data on the latest crypto trends and market movements
Access detailed OHLCV data with a Standard subscription or higher
Type-safe parameter validation with Zod

use cases of CoinMarketCap MCP?

Accessing real-time cryptocurrency market data
Analyzing historical market trends and performance
Integrating cryptocurrency data into applications and services

FAQ from CoinMarketCap MCP?

What subscription levels are available?

Subscription levels include Basic, Hobbyist, Startup, Standard, Professional, and Enterprise.

How do I get an API key?

You can sign up for a free API key on the CoinMarketCap website.

Can I use CoinMarketCap MCP for commercial purposes?

Yes, depending on the subscription level you choose.

Content

CoinMarketCap MCP

A Model Context Protocol (MCP) implementation for the CoinMarketCap API, providing a standardized interface for accessing cryptocurrency market data, exchange information, and other blockchain-related metrics.

Features

Complete coverage of the CoinMarketCap API
Fetch data on the latest crypto trends, market movements, and global market metrics
Access to detailed OHLCV data with Standard subscription or higher
Type-safe parameter validation with Zod

Installation

If you don't have an API key, first sign up to receive a free Basic key here.

NPX (Recommended)

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "coinmarketcap": {
      "command": "npx",
      "args": [
        "@shinzolabs/coinmarketcap-mcp"
      ],
      "env": {
        "COINMARKETCAP_API_KEY": "your-key-here",
        "SUBSCRIPTION_LEVEL": "Basic" // "Basic", "Hobbyist", "Startup", "Standard", "Professional", or "Enterprise"
      }
    }
  }
}

Manual Download

Download the repo:

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

Install packages (inside cloned repo):

pnpm i

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "coinmarketcap": {
      "command": "node",
      "args": [
        "/path/to/coinmarketcap-mcp/index.js"
      ],
      "env": {
        "COINMARKETCAP_API_KEY": "your-key-here",
        "SUBSCRIPTION_LEVEL": "Basic" // "Basic", "Hobbyist", "Startup", "Standard", "Professional", or "Enterprise"
      }
    }
  }
}

Smithery

To install for Claude Desktop automatically via Smithery:

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

Supported Endpoints

Subscription Level: Basic (and above)

Cryptocurrency

cryptoCurrencyMap: Get mapping of all cryptocurrencies
getCryptoMetadata: Get metadata for one or more cryptocurrencies
allCryptocurrencyListings: Get latest market quote for 1-5000 cryptocurrencies
cryptoQuotesLatest: Get latest market quote for 1 or more cryptocurrencies
cryptoCategories: Get list of all cryptocurrency categories
cryptoCategory: Get metadata about a cryptocurrency category

Exchange

exchangeMap: Get mapping of all exchanges
exchangeInfo: Get metadata for one or more exchanges
exchangeAssets: Get list of all assets available on an exchange

DEX

dexInfo: Get metadata for one or more decentralised exchanges
dexListingsLatest: Get latest market data for all DEXes
dexNetworksList: Get list of all networks with unique IDs
dexSpotPairsLatest: Get latest market data for all active DEX spot pairs
dexPairsQuotesLatest: Get latest market quotes for spot pairs
dexPairsOhlcvLatest: Get latest OHLCV data for spot pairs
dexPairsOhlcvHistorical: Get historical OHLCV data for spot pairs
dexPairsTradeLatest: Get latest trades for spot pairs

Global Metrics

globalMetricsLatest: Get latest global cryptocurrency metrics

Index

cmc100IndexLatest: Get latest CoinMarketCap 100 Index value and constituents
cmc100IndexHistorical: Get historical CoinMarketCap 100 Index values

Tools

priceConversion: Convert an amount of one cryptocurrency or fiat currency into another
getPostmanCollection: Get Postman collection for the API

Other

fiatMap: Get mapping of all fiat currencies
keyInfo: Get API key usage and status
fearAndGreedLatest: Get latest Fear & Greed Index
fearAndGreedHistorical: Get historical Fear & Greed Index values

Subscription Level: Hobbyist (and above)

Cryptocurrency

cryptoAirdrops: Get list of all cryptocurrency airdrops
cryptoAirdrop: Get metadata about a specific airdrop
historicalCryptocurrencyListings: Get historical market quotes for any cryptocurrency
cryptoQuotesHistorical: Get historical market quotes for any cryptocurrency
cryptoQuotesHistoricalV3: Get historical market quotes with advanced time-based intervals

Exchange

exchangeQuotesHistorical: Get historical quotes for any exchange

Global Metrics

globalMetricsHistorical: Get historical global cryptocurrency metrics

Subscription Level: Startup (and above)

Cryptocurrency

newCryptocurrencyListings: Get list of most recently added cryptocurrencies
cryptoTrendingGainersLosers: Get biggest gainers and losers in a given time period
cryptoTrendingLatest: Get top cryptocurrencies by search volume
cryptoTrendingMostVisited: Get most visited cryptocurrencies
cryptoOhlcvLatest: Get latest OHLCV market data for any cryptocurrency
cryptoOhlcvHistorical: Get historical OHLCV market data for any cryptocurrency
cryptoPricePerformanceStatsLatest: Get price performance statistics for any cryptocurrency