CoinMarketCap MCP Server
A Model Context Protocol (MCP) server 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
There are several options to configure your MCP client with the server. For hosted/remote server setup, use Smithery's CLI with a Smithery API Key. For local installation, use npx or build from source. Each of these options is explained below.
Smithery Remote Server (Recommended)
To add a remote server to your MCP client config.json, run the following command from Smithery CLI:
npx -y @smithery/cli install @shinzo-labs/coinmarketcap-mcp
Enter your COINMARKETCAP_API_KEY and SUBSCRIPTION_LEVEL (see options below) when prompted.
Smithery SDK
If you are developing your own agent application, you can use the boilerplate code here.
NPX Local Install
To install the server locally with npx, add the following to your MCP client config.json:
{
"mcpServers": {
"coinmarketcap": {
"command": "npx",
"args": [
"@shinzolabs/coinmarketcap-mcp"
],
"env": {
"COINMARKETCAP_API_KEY": "your-key-here",
"SUBSCRIPTION_LEVEL": "Basic" // See options below
}
}
}
}
Build from Source
- 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 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 |
TELEMETRY_ENABLED | Enable telemetry | No | true |
Supported Tools
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! Please read CONTRIBUTING.md for guidelines on issues, contributions, and contact information.
Data Collection and Privacy
Shinzo Labs collects limited anonymous telemetry from this server to help improve our products and services. No personally identifiable information is collected as part of this process. Please review the Privacy Policy for more details on the types of data collected and how to opt-out of this telemetry.
License
MIT