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.
- 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
If you don't have an API key, first sign up to receive a free Basic key here.
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
}
}
}
}- Download the repo:
git clone https://github.com/gcharang/coinmarketcap-mcp.git- Install packages (inside cloned repo):
pnpm i- 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
}
}
}
}| 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 |
cryptoCurrencyMap: Get mapping of all cryptocurrenciesgetCryptoMetadata: Get metadata for one or more cryptocurrenciesallCryptocurrencyListings: Get latest market quote for 1-5000 cryptocurrenciescryptoQuotesLatest: Get latest market quote for 1 or more cryptocurrenciescryptoCategories: Get list of all cryptocurrency categoriescryptoCategory: Get metadata about a cryptocurrency category
exchangeMap: Get mapping of all exchangesexchangeInfo: Get metadata for one or more exchangesexchangeAssets: Get list of all assets available on an exchange
dexInfo: Get metadata for one or more decentralised exchangesdexListingsLatest: Get latest market data for all DEXesdexNetworksList: Get list of all networks with unique IDsdexSpotPairsLatest: Get latest market data for all active DEX spot pairsdexPairsQuotesLatest: Get latest market quotes for spot pairsdexPairsOhlcvLatest: Get latest OHLCV data for spot pairsdexPairsOhlcvHistorical: Get historical OHLCV data for spot pairsdexPairsTradeLatest: Get latest trades for spot pairs
globalMetricsLatest: Get latest global cryptocurrency metrics
cmc100IndexLatest: Get latest CoinMarketCap 100 Index value and constituentscmc100IndexHistorical: Get historical CoinMarketCap 100 Index values
priceConversion: Convert an amount of one cryptocurrency or fiat currency into anothergetPostmanCollection: Get Postman collection for the API
fiatMap: Get mapping of all fiat currencieskeyInfo: Get API key usage and statusfearAndGreedLatest: Get latest Fear & Greed IndexfearAndGreedHistorical: Get historical Fear & Greed Index values
cryptoAirdrops: Get list of all cryptocurrency airdropscryptoAirdrop: Get metadata about a specific airdrophistoricalCryptocurrencyListings: Get historical market quotes for any cryptocurrencycryptoQuotesHistorical: Get historical market quotes for any cryptocurrencycryptoQuotesHistoricalV3: Get historical market quotes with advanced time-based intervals
exchangeQuotesHistorical: Get historical quotes for any exchange
globalMetricsHistorical: Get historical global cryptocurrency metrics
newCryptocurrencyListings: Get list of most recently added cryptocurrenciescryptoTrendingGainersLosers: Get biggest gainers and losers in a given time periodcryptoTrendingLatest: Get top cryptocurrencies by search volumecryptoTrendingMostVisited: Get most visited cryptocurrenciescryptoOhlcvLatest: Get latest OHLCV market data for any cryptocurrencycryptoOhlcvHistorical: Get historical OHLCV market data for any cryptocurrencycryptoPricePerformanceStatsLatest: Get price performance statistics for any cryptocurrency
cryptoMarketPairsLatest: Get latest market pairs for any cryptocurrency
exchangeListingsLatest: Get latest market data for all exchangesexchangeMarketPairsLatest: Get latest market pairs for any exchangeexchangeQuotesLatest: Get latest market quotes for one or more exchanges
contentLatest: Get latest cryptocurrency news and contentcontentPostsTop: Get top cryptocurrency postscontentPostsLatest: Get latest cryptocurrency postscontentPostsComments: Get comments for a specific post
communityTrendingTopic: Get trending topics in the cryptocurrency communitycommunityTrendingToken: Get trending tokens in the cryptocurrency community
blockchainStatisticsLatest: Get latest statistics for one or more blockchains
Contributions are welcomed and encouraged! Please read CONTRIBUTING.md for guidelines on issues, contributions, and contact information.