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 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
Exchange
exchangeMap: Get mapping of all exchangesexchangeInfo: Get metadata for one or more exchangesexchangeAssets: Get list of all assets available on an exchange
DEX
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
Global Metrics
globalMetricsLatest: Get latest global cryptocurrency metrics
Index
cmc100IndexLatest: Get latest CoinMarketCap 100 Index value and constituentscmc100IndexHistorical: Get historical CoinMarketCap 100 Index values
Tools
priceConversion: Convert an amount of one cryptocurrency or fiat currency into anothergetPostmanCollection: Get Postman collection for the API
Other
fiatMap: Get mapping of all fiat currencieskeyInfo: Get API key usage and statusfearAndGreedLatest: Get latest Fear & Greed IndexfearAndGreedHistorical: Get historical Fear & Greed Index values
Subscription Level: Hobbyist (and above)
Cryptocurrency
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
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 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
Subscription Level: Standard (and above)
Cryptocurrency
cryptoMarketPairsLatest: Get latest market pairs for any cryptocurrency
Exchange
exchangeListingsLatest: Get latest market data for all exchangesexchangeMarketPairsLatest: Get latest market pairs for any exchangeexchangeQuotesLatest: Get latest market quotes for one or more exchanges
Content
contentLatest: Get latest cryptocurrency news and contentcontentPostsTop: Get top cryptocurrency postscontentPostsLatest: Get latest cryptocurrency postscontentPostsComments: Get comments for a specific post
Community
communityTrendingTopic: Get trending topics in the cryptocurrency communitycommunityTrendingToken: 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. Contact [email protected] with any questions, comments or concerns.
