playbooks

home / mcp / coinmarketcap mcp server

CoinMarketCap MCP Server

MCP Implementation for CoinMarketCap

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "alexander-herranz-coinmarketcap-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@shinzolabs/coinmarketcap-mcp"
      ],
      "env": {
        "PORT": "3000",
        "TELEMETRY_ENABLED": "true",
        "SUBSCRIPTION_LEVEL": "Basic",
        "COINMARKETCAP_API_KEY": "your-key-here"
      }
    }
  }
}

You can run a CoinMarketCap MCP Server to access a standardized, type-safe interface for CoinMarketCap data from your MCP client. It lets you fetch market data, metadata, OHLCV data, and more through a configurable server that you host locally or run remotely. This guide shows practical steps to install, configure, and use the MCP server so you can integrate CoinMarketCap data into your workflows and agents.

How to use

Install the MCP server locally or run it remotely, then connect your MCP client to the server using the provided configuration snippets. You can run the server via NPX for a quick local setup or run it from source after building. Your MCP client will access CoinMarketCap data through the server's endpoints, using your API key and chosen subscription level.

How to install

Prerequisites you need before installation:

  • Node.js installed (LTS version recommended)
  • npm or pnpm installed
  • Access to a CoinMarketCap API key

Option A: NPX Local Install (fastest setup for local development)

{
  "mcpServers": {
    "coinmarketcap": {
      "command": "npx",
      "args": [
        "@shinzolabs/coinmarketcap-mcp"
      ],
      "env": {
        "COINMARKETCAP_API_KEY": "your-key-here",
        "SUBSCRIPTION_LEVEL": "Basic" // See options below
      }
    }
  }
}

Option B: Build from Source (requires cloning the repository and building)

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

```bash
pnpm i
```

```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
      }
    }
  }
}

Additional installation notes

If you want to run a remote MCP server, you can use a CLI-based setup workflow to register a remote server with your MCP client. The remote setup uses your Smithery API key to connect to the hosted MCP server. The remote setup is recommended for quick, centralized access when you already use the Smithery tooling.

Configuration and runtime options

Configure your MCP client to point at the CoinMarketCap MCP server by adding one or more server configurations. The common settings you will provide are the API key and the subscription level. You can also control whether telemetry is enabled and the port used for transport, depending on your environment.

{
  "mcpServers": {
    "coinmarketcap": {
      "command": "npx",
      "args": [
        "@shinzolabs/coinmarketcap-mcp"
      ],
      "env": {
        "COINMARKETCAP_API_KEY": "your-key-here",
        "SUBSCRIPTION_LEVEL": "Basic" // See options below
      }
    }
  }
}
{
  "mcpServers": {
    "coinmarketcap": {
      "command": "node",
      "args": [
        "/path/to/coinmarketcap-mcp/index.js"
      ],
      "env": {
        "COINMARKETCAP_API_KEY": "your-key-here",
        "SUBSCRIPTION_LEVEL": "Basic" // See options below
      }
    }
  }
}

Security and best practices

Keep your API key secret and do not commit it to source control. Use environment variables to inject secrets at runtime. If you are deploying in a shared environment, restrict access to the MCP server and rotate API keys periodically.

Troubleshooting

If the server fails to start, verify that Node.js is installed, the API key is valid, and the environment variables are correctly set. Check that the selected subscription level supports the endpoints you intend to use. Review logs for any authentication or network errors and adjust your configuration as needed.

Notes

The MCP server exposes a wide range of cryptocurrency data endpoints, including market data, metadata, OHLCV data, and global metrics. Ensure your subscription level matches the endpoints you plan to query.

Available tools

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

exchangeMap

Get mapping of all exchanges

exchangeInfo

Get metadata for one or more exchanges

exchangeAssets

Get list of all assets available on an exchange

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

globalMetricsLatest

Get latest global cryptocurrency metrics

cmc100IndexLatest

Get latest CoinMarketCap 100 Index value and constituents

cmc100IndexHistorical

Get historical CoinMarketCap 100 Index values

priceConversion

Convert an amount of one cryptocurrency or fiat currency into another

getPostmanCollection

Get Postman collection for the API

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

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

exchangeQuotesHistorical

Get historical quotes for any exchange

globalMetricsHistorical

Get historical global cryptocurrency metrics

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

cryptoMarketPairsLatest

Get latest market pairs for any cryptocurrency

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

contentLatest

Get latest cryptocurrency news and content

contentPostsTop

Get top cryptocurrency posts

contentPostsLatest

Get latest cryptocurrency posts

contentPostsComments

Get comments for a specific post

communityTrendingTopic

Get trending topics in the cryptocurrency community

communityTrendingToken

Get trending tokens in the cryptocurrency community

blockchainStatisticsLatest

Get latest statistics for one or more blockchains