CoinMarketCap MCP Server

An MCP (Model Context Protocol) server for querying cryptocurrency data from CoinMarketCap. Enables AI assistants like Claude to search tokens, validate metadata, and retrieve market data through natural language.

Features

• Progressive Search - Find tokens by name, symbol, or homepage URL with fuzzy matching
• Symbol Variation Handling - Automatically handles rebrands (RNDR→RENDER, MATIC→POL)
• Homepage Verification - Verify token identity by matching website URLs
• Market Data - Get latest prices, volume, market cap, and price changes
• Token Metadata - Retrieve descriptions, logos, social links, and platform info
• Exchange Info - Look up exchange metadata and trading data

Quick Start

Step 1: Get CoinMarketCap API Key

1. Go to CoinMarketCap API
2. Sign up for a free account
3. Copy your API key from the dashboard

Step 2: Store API Key

Add to your ~/.env.local:

COINMARKETCAP_API_KEY=your-api-key-here
# Or alternatively:
CMC_API_KEY=your-api-key-here

Step 3: Configure Claude Code

Add to your ~/.claude.json under mcpServers:

{
  "coinmarketcap": {
    "command": "uvx",
    "args": ["coinmarketcap-mcp"],
    "env": {
      "COINMARKETCAP_API_KEY": "${COINMARKETCAP_API_KEY}"
    }
  }
}

Step 4: Restart Claude Code

Restart Claude Code to load the MCP server. You should now have access to CoinMarketCap tools.

Available Tools

Search & Discovery

Token Data

Exchange Data

Market Overview

Progressive Search

The search_cryptocurrency tool uses multiple strategies to find tokens:

1. Exact symbol match (high confidence)
2. Symbol variations - handles rebrands like RNDR→RENDER (medium confidence)
3. Slug matching - matches by name slug (medium confidence)
4. Fuzzy name search - searches 5000+ tokens by similarity (low confidence)
5. Homepage verification - boosts confidence by matching website URLs

Example

Query: name="Render Token", symbol="RNDR", homepage="https://rendernetwork.com"

Search log:
- exact_symbol(RNDR): failed (symbol was renamed)
- symbol_variation(RENDER): 1 found
- homepage_verification: exact match

Result: Render (RENDER) - id=5690, confidence=verified

Example Queries

"Search for a token named 'Uniswap' with homepage 'https://uniswap.org'"

"Is RENDER listed on CoinMarketCap?"

"Get the profile and description for Chainlink"

"What's the current price and market cap of BTC and ETH?"

"Check my API usage"

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json under mcpServers:

{
  "coinmarketcap": {
    "command": "uvx",
    "args": ["coinmarketcap-mcp"],
    "env": {
      "COINMARKETCAP_API_KEY": "${COINMARKETCAP_API_KEY}"
    }
  }
}

Development

# Clone the repo
git clone https://github.com/YimingYAN/coinmarketcap-mcp
cd coinmarketcap-mcp

# Install dependencies
uv sync

# Run the server locally
COINMARKETCAP_API_KEY=your-key uv run coinmarketcap-mcp

License

MIT License - see LICENSE for details.