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

Prerequisites

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

Client Configuration

NPX Local Install

To install the server locally with npx, add the following to your MCP client config.json:

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

Build from Source

1. Download the repo:

git clone https://github.com/gcharang/coinmarketcap-mcp.git

2. Install packages (inside cloned repo):

pnpm i

3. Add the following to your MCP client 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
      }
    }
  }
}

Config Variables

| Variable | Description | Required? | Default | |-------------------------|-----------------------------------------------------------------------------|-----------|---------| | COINMARKETCAP_API_KEY | API Key from CoinMarketCap.com | Yes | | | SUBSCRIPTION_LEVEL | Basic, Hobbyist, Startup, Standard, Professional, or Enterprise | No | Basic | | PORT | Port for Streamable HTTP transport method | No | 3000 |

Supported Tools

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

Subscription Level: Standard (and above)

Cryptocurrency

• cryptoMarketPairsLatest: Get latest market pairs for any cryptocurrency

Exchange

• exchangeListingsLatest: Get latest market data for all exchanges
• exchangeMarketPairsLatest: Get latest market pairs for any exchange
• exchangeQuotesLatest: Get latest market quotes for one or more exchanges

Content

• contentLatest: Get latest cryptocurrency news and content
• contentPostsTop: Get top cryptocurrency posts
• contentPostsLatest: Get latest cryptocurrency posts
• contentPostsComments: Get comments for a specific post

Community

• communityTrendingTopic: Get trending topics in the cryptocurrency community
• communityTrendingToken: Get trending tokens in the cryptocurrency community

Subscription Level: Enterprise (and above)

Blockchain

• blockchainStatisticsLatest: Get latest statistics for one or more blockchains

Contributing

Contributions are welcomed and encouraged! Please read CONTRIBUTING.md for guidelines on issues, contributions, and contact information.