Skip to main content
Glama
CoinMarketCap MCP
by shinzo-labs

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

Related MCP server: CoinMarketCap Universal MCP Server

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.

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
  1. Install packages (inside cloned repo):

pnpm i
  1. 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 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.

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

Available Tools

26 tools
allCryptocurrencyListingsC

Returns a paginated list of all active cryptocurrencies with latest market data.

Inputs: start, limit, price_min, price_max, +15 more.

cmc100IndexHistoricalC

Returns an interval of historic CoinMarketCap 100 Index values based on the interval parameter.

Inputs: time_start, time_end, count, interval.

cmc100IndexLatestA

Returns the lastest CoinMarketCap 100 Index value, constituents, and constituent weights.

Inputs: no named parameters.

cryptoCategoriesC

Returns information about all coin categories available on CoinMarketCap.

Inputs: start, limit, id, slug, +1 more.

cryptoCategoryC

Returns information about a single coin category on CoinMarketCap.

Inputs: id (required), start, limit, convert, +1 more.

cryptoCurrencyMapC

Returns a mapping of all cryptocurrencies to unique CoinMarketCap IDs.

Inputs: listing_status, start, limit, sort, +2 more.

cryptoQuotesLatestD

Returns the latest market quote for one or more cryptocurrencies.

Inputs: id, slug, symbol, convert, +3 more.

dexInfoC

Returns all static metadata for one or more decentralised exchanges.

Inputs: id, aux.

dexListingsLatestC

Returns a paginated list of all decentralised cryptocurrency exchanges including the latest aggregate market data.

Inputs: start, limit, sort, sort_dir, +3 more.

dexNetworksListC

Returns a list of all networks to unique CoinMarketCap ids.

Inputs: start, limit, sort, sort_dir, +1 more.

dexPairsOhlcvHistoricalC

Returns historical OHLCV data along with market cap for any spot pairs using time interval parameters.

Inputs: contract_address, network_id, network_slug, time_period, +8 more.

dexPairsOhlcvLatestC

Returns the latest OHLCV market values for one or more spot pairs for the current UTC day.

Inputs: contract_address, network_id, network_slug, aux, +3 more.

dexPairsQuotesLatestC

Returns the latest market quote for 1 or more spot pairs.

Inputs: contract_address, network_id, network_slug, aux, +3 more.

dexPairsTradeLatestC

Returns up to the latest 100 trades for 1 spot pair.

Inputs: contract_address, network_id, network_slug, aux, +3 more.

dexSpotPairsLatestC

Returns a paginated list of all active dex spot pairs with latest market data.

Inputs: network_id, network_slug, dex_id, dex_slug, +23 more.

exchangeAssetsC

Returns the assets/token holdings of an exchange.

Inputs: id, slug.

exchangeInfoC

Returns metadata for one or more exchanges.

Inputs: id, slug, aux.

exchangeMapC

Returns a mapping of all exchanges to unique CoinMarketCap IDs.

Inputs: listing_status, slug, start, limit, +1 more.

fearAndGreedHistoricalB

Returns historical CMC Crypto Fear and Greed Index values.

Inputs: start, limit.

fearAndGreedLatestA

Returns the latest CMC Crypto Fear and Greed Index value.

Inputs: no named parameters.

fiatMapC

Returns a mapping of all supported fiat currencies to unique CoinMarketCap IDs.

Inputs: start, limit, sort, include_metals.

getCryptoMetadataC

Returns all static metadata for one or more cryptocurrencies including logo, description, and website URLs.

Inputs: symbol, id, slug, address, +2 more.

getPostmanCollectionA

Returns a Postman collection for the CoinMarketCap API.

Inputs: no named parameters.

globalMetricsLatestC

Returns the latest global cryptocurrency market metrics.

Inputs: convert, convert_id.

keyInfoA

Returns API key details and usage stats.

Inputs: no named parameters.

priceConversionB

Convert an amount of one cryptocurrency or fiat currency into one or more different currencies.

Inputs: amount (required), id, symbol, time, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.9/5.0

    Scored across 26 tools

    Disambiguation5/5

    Each tool targets a distinct resource or operation (e.g., listings vs quotes vs metadata, DEX-specific endpoints grouped by purpose). No two tools appear to serve the same purpose, even within similar domains like DEX pairs.

    Naming Consistency4/5

    Most tools follow camelCase and start with a lowercase letter. However, there is a mix of verb styles (e.g., 'getCryptoMetadata' vs 'cryptoQuotesLatest') and some tools are short noun phrases ('keyInfo'). Overall, the pattern is clear but not perfectly uniform.

    Tool Count4/5

    26 tools is on the higher side but appropriate for a comprehensive market data API covering cryptocurrencies, exchanges, DEX, and indices. The inclusion of utility tools (keyInfo, getPostmanCollection) is justified.

    Completeness4/5

    The set covers most major areas: listings, quotes, metadata, categories, conversions, global metrics, exchange info, and DEX data. A notable gap is the lack of historical OHLCV for centralized exchanges, but DEX historical data is present. Otherwise, it's well-rounded.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers