CoinMarketCap

What is CoinMarketCap MCP?

CoinMarketCap MCP (Model Context Protocol) is an implementation that provides a standardized interface for accessing the CoinMarketCap API. It allows developers to easily retrieve cryptocurrency market data, exchange information, and other blockchain-related metrics.

How to use CoinMarketCap MCP?

To use CoinMarketCap MCP, you first need a CoinMarketCap API key. You can obtain a free Basic key by signing up on the CoinMarketCap website. Once you have an API key, you can configure your MCP client in several ways:

• Smithery Remote Server (Recommended): Use the Smithery CLI to install the MCP and configure it remotely.
• Smithery SDK: If you are developing an agent application, you can use the boilerplate code provided by Smithery SDK.
• NPX Local Install: Install the server locally using npx and configure it in your MCP client config.json.
• Build from Source: Clone the repository, install dependencies, and configure the server in your MCP client config.json.

Configuration involves setting your COINMARKETCAP_API_KEY and SUBSCRIPTION_LEVEL (e.g., Basic, Standard).

Key Features of CoinMarketCap MCP

• Comprehensive API Coverage: Provides complete access to the CoinMarketCap API.
• Market Data Access: Fetch data on the latest crypto trends, market movements, and global market metrics.
• OHLCV Data: Access detailed OHLCV (Open, High, Low, Close, Volume) data with a Standard subscription or higher.
• Type-safe Parameter Validation: Utilizes Zod for robust type-safe parameter validation.
• Various Data Endpoints: Supports a wide range of data endpoints including cryptocurrency maps, metadata, listings, quotes, categories, exchange information, DEX data, global metrics, and index data.
• Tools: Includes tools for price conversion and obtaining Postman collections.
• Subscription Level Support: Different features are available based on your CoinMarketCap API subscription level (Basic, Hobbyist, Startup, Standard, Enterprise).

Use Cases of CoinMarketCap MCP

• Cryptocurrency Tracking Applications: Develop applications that display real-time or historical cryptocurrency prices and market data.
• Portfolio Management Tools: Build tools that track cryptocurrency portfolios and provide insights into their performance.
• Market Analysis Platforms: Create platforms for in-depth analysis of cryptocurrency market trends and movements.
• Decentralized Exchange (DEX) Data Integration: Integrate DEX data into applications for trading or analysis.
• Blockchain Research: Access blockchain statistics for research and development.
• News and Content Aggregation: Retrieve the latest cryptocurrency news and content for display in applications.

FAQ from CoinMarketCap MCP

Q: Do I need an API key to use CoinMarketCap MCP? A: Yes, you need a CoinMarketCap API key. You can get a free Basic key by signing up on the CoinMarketCap website.

Q: What are the different subscription levels and their features? A: CoinMarketCap MCP supports various subscription levels (Basic, Hobbyist, Startup, Standard, Enterprise), with each level unlocking more advanced features and data endpoints. For example, OHLCV data requires a Standard subscription or higher.

Q: How can I configure the SUBSCRIPTION_LEVEL? A: You can set the SUBSCRIPTION_LEVEL in your MCP client config.json or as an environment variable when installing via Smithery CLI or NPX.

Q: Can I build CoinMarketCap MCP from source? A: Yes, you can clone the repository, install dependencies, and configure the server locally.

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

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

1. Download the repo:

git clone https://github.com/shinzo-labs/coinmarketcap-mcp.git

2. Install packages (inside cloned repo):

pnpm i

3. 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

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 for guidelines on issues, contributions, and contact information.