shinzo-labs/coinmarketcap-mcp

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:
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:
Build from Source
1. Download the repo:
2. Install packages (inside cloned repo):
3. Add the following to your MCP client config.json:
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 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