CoinMarketCap MCP Server
by
Provides standardized access to CoinMarketCap data through a Model Context Protocol server, enabling retrieval of cryptocurrency market metrics, exchange information, OHLCV data, and related blockchain statistics.
CoinMarketCap MCP Server Overview
CoinMarketCap MCP Server
What is CoinMarketCap MCP Server about?
Provides a complete MCP interface to the CoinMarketCap API, allowing agents and applications to query cryptocurrency market data, exchange details, decentralized exchange (DEX) information, global metrics, and various content feeds without handling raw HTTP requests.
How to use CoinMarketCap MCP Server?
- Obtain a CoinMarketCap API key from the CoinMarketCap portal.
- Configure the MCP client by adding a server entry to
config.json:
{
"mcpServers": {
"coinmarketcap": {
"command": "npx",
"args": ["@shinzolabs/coinmarketcap-mcp"],
"env": {
"COINMARKETCAP_API_KEY": "<YOUR_API_KEY>",
"SUBSCRIPTION_LEVEL": "Basic"
}
}
}
}
- Run the MCP client; the server will start on the default port
3000(or a customPORTif set). - Invoke supported methods (e.g.,
cryptoQuotesLatest,globalMetricsLatest,dexPairsOhlcvHistorical) via the MCP client interface.
Key Features
- Full coverage of CoinMarketCap endpoints across subscription tiers.
- Type‑safe request validation using Zod.
- Easy local installation via
npxwith minimal setup. - Configurable subscription level (
Basic,Hobbyist,Startup,Standard,Professional,Enterprise). - Optional telemetry to help improve the service (can be disabled via
TELEMETRY_ENABLED).
Use Cases
- Building trading bots that need real‑time price quotes and historical OHLCV data.
- Developing dashboards that monitor global crypto market health.
- Integrating cryptocurrency price conversion into finance applications.
- Aggregating exchange and DEX metadata for analytics platforms.
- Providing content feeds (news, posts) for crypto community apps.
FAQ
Q: Which environment variables are required?
A: COINMARKETCAP_API_KEY is mandatory; SUBSCRIPTION_LEVEL, PORT, and TELEMETRY_ENABLED are optional.
Q: Can I run the server on a custom port?
A: Yes, set the PORT variable in the environment; default is 3000.
Q: How do I upgrade my subscription level?
A: Change the SUBSCRIPTION_LEVEL environment variable to one of the supported tiers (Hobbyist, Startup, Standard, Professional, Enterprise).
Q: Is telemetry required?
A: Telemetry is enabled by default (true). Set TELEMETRY_ENABLED=false to opt‑out.
Q: Do I need to install any additional packages?
A: No. The server runs directly with npx @shinzolabs/coinmarketcap-mcp after providing the required environment variables.
CoinMarketCap MCP Server's README
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
CoinMarketCap MCP Server Reviews
Login Required
Please log in to share your review and rating for this MCP.
Actions
CoinMarketCap MCP Server's Information
- Author
- shinzo-labs
- Category
- Finance & Payments
- Language
- JavaScript
- License
- MIT License
- Version
- v1.4.5
- Stars
- 32
- Updated
- 21 days ago
Configuration
{
"mcpServers": {
"coinmarketcap-mcp": {
"command": "npx",
"args": [
"@shinzolabs/coinmarketcap-mcp"
],
"env": {
"COINMARKETCAP_API_KEY": "<YOUR_API_KEY>",
"SUBSCRIPTION_LEVEL": "Basic"
}
}
}
}Configure Clients
Similar MCP Servers like CoinMarketCap MCP Server
Explore related MCPs that share similar capabilities and solve comparable challenges
Goat
by goat-sdk
Enables AI agents to send and receive payments, purchase goods and services, execute investment strategies, tokenize assets, and obtain financial insights by leveraging blockchains, stablecoins, and wallets.
Financial Datasets MCP Server
by financial-datasets
Provides access to income statements, balance sheets, cash flow statements, stock prices, market news, and cryptocurrency data through MCP tools for AI assistants.
Alpaca MCP Server
Officialby alpacahq
Enables large language models to trade stocks and options, retrieve real‑time and historical market data, and manage portfolios using plain English commands through a local or remote MCP server.
Xero MCP Server
by XeroAPI
Provides a bridge between the Model Context Protocol and Xero's API, enabling standardized access to Xero accounting and business features.
Sec Edgar Mcp
by stefanoamorelli
Provides an MCP server that connects AI models to SEC EDGAR filings, enabling real‑time retrieval of company filings, financial statements, and insider‑trading data with exact XBRL precision and verifiable filing references.
MetaTrader MCP Server
by ariadng
Enables AI LLMs to execute trades on the MetaTrader 5 platform through the Model Context Protocol.
Alpha Vantage MCP Server
Officialby calvernaz
Provides access to Alpha Vantage stock market data via an MCP server, supporting stdio and HTTP streaming modes with optional OAuth 2.1 authentication.
Freqtrade Mcp
by kukapay
Integrates the Freqtrade cryptocurrency trading bot with MCP, exposing its REST API as tools for AI agents to perform automated trading operations.
Crypto Indicators MCP Server
by kukapay
Provides a comprehensive set of cryptocurrency technical analysis indicators and ready‑to‑use trading strategies through an MCP interface, enabling AI agents and applications to generate buy, hold, or sell signals.