A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) server implementation for the [CoinMarketCap](https://coinmarketcap.com/) 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](https://zod.dev/) ## Prerequisites If you don't have an API key, first sign up to receive a free \`Basic\` key [here](https://pro.coinmarketcap.com/signup/?plan=0). ## 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](https://smithery.ai/docs/registry#registry-api). 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](https://github.com/smithery-ai/cli?tab=readme-ov-file#smithery-cli--): \`\`\`bash 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](https://smithery.ai/server/@shinzo-labs/coinmarketcap-mcp/api). ### NPX Local Install To install the server locally with \`npx\`, add the following to your MCP client \`config.json\`: \`\`\`javascript \{ "mcpServers": \{ "coinmarketcap": \{ "command": "npx", "args": [ "@shinzolabs/coinmarketcap-mcp" ], "env": \{ "COINMARKETCAP_API_KEY": "your-key-here", "SUBSCRIPTION_LEVEL": "Basic" // See options below \} \} \} \} \`\`\` ### Build from Source 1. Download the repo: \`\`\`bash git clone https://github.com/shinzo-labs/coinmarketcap-mcp.git \`\`\` 2. Install packages (inside cloned repo): \`\`\`bash pnpm i \`\`\` 3. Add the following to your MCP client \`config.json\`: \`\`\`javascript \{ "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 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](./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](./PRIVACY.md) for more details on the types of data collected and how to opt-out of this telemetry. ## License MIT