Power AI Agents with
Crypto Market Data

CoinMarketCap MCP enables AI models and agents to access real-time cryptocurrency data through the Model Context Protocol. Works with Claude, Cursor, ChatGPT, and any MCP-compatible client.

Get API Key

mcp_config.json

{
  "mcpServers": {
    "cmc-mcp": {
      "url": "https://mcp.coinmarketcap.com/mcp",
      "headers": {
        "X-CMC-MCP-API-KEY": "xxxx"
      }
    }
  }
}

// 12 tools · 10,000+ cryptocurrencies

How It Works

Three simple steps to connect AI to crypto data

STEP 01

Get Your API Key

Sign up for a free CoinMarketCap API key. Choose from Basic (free), Hobbyist, Startup, Standard, Professional, or Enterprise plans based on your data needs.

# Sign up at pro.coinmarketcap.com
# Copy your API key from the dashboard

API_KEY=your-api-key-here

→

STEP 02

Configure MCP Client

Add the CoinMarketCap MCP server URL to your AI client configuration. Works with Claude Desktop, Cursor, VS Code, and any MCP-compatible client.

{
  "mcpServers": {
    "cmc-mcp": {
      "url": "https://mcp.coinmarketcap.com/mcp",
      "headers": {
        "X-CMC-MCP-API-KEY": "xxxx"
      }
    }
  }
}

{
  "mcpServers": {
    "cmc-mcp": {
      "url": "https://mcp.coinmarketcap.com/mcp"
    }
  }
}

Authorizing CoinMarketCap MCP server

Enter your API key to initialize the connection with your MCP client.

You need a API key to use this service. Please copy the API key from your developer dashboard.

API Key

Enter your API Key

⚠️ You will be redirected to the following location:

cursor://anysphere.cursor-mcp/oauth/callback

I recognize and trust this URL

CONTINUE

Cancel

→

STEP 03

Query Crypto Data

Start querying cryptocurrency data in natural language. Your AI agent will automatically call the right MCP tools to fetch real-time market data.

User: "What's the current price of BTC?"

AI Agent → get_crypto_quotes_latest(id: "1")

Response: {
  "BTC": {
    "price": 96348.45,
    "volume_24h": 28439861524,
    "market_cap": 1907489860314
  }
}

What You Can Access

12 tools covering every aspect of the crypto market

Market Data & Quotes

Access latest prices, market cap, volume, and metadata for 10,000+ cryptocurrencies with flexible search.

get_crypto_quotes_latestsearch_cryptosget_crypto_info

Technical Analysis

Get comprehensive TA including moving averages (SMA/EMA), MACD, RSI, Fibonacci levels, and pivot points.

get_crypto_technical_analysisget_crypto_marketcap_technical_analysis

On-Chain Metrics

Analyze holder distribution, addresses by holding value and time, circulating supply breakdown, and transaction fees.

get_crypto_metrics

Global Market Overview

Track total market cap, BTC dominance, Fear & Greed Index, altcoin season gauge, leverage stats, and ETF flows.

get_global_metrics_latestget_global_crypto_derivatives_metrics

Trending & Narratives

Discover top trending crypto narratives with market performance data and upcoming macro events that move markets.

trending_crypto_narrativesget_upcoming_macro_events

News & Research

Get the latest crypto news and perform semantic search across cryptocurrency concepts, whitepapers, and documentation.

get_crypto_latest_newssearch_crypto_info

x402 Protocol Support

Pay-Per-Call with Crypto

Access CoinMarketCap MCP tools without an API key. The x402 protocol enables AI agents to pay for each tool call directly with USDC — no sign-up, no subscription, just pay and query.

No API Key Required

Skip the sign-up process entirely. Pay directly with crypto — no accounts, no API key management, no subscription overhead.

Pay-Per-Call Pricing

Only pay for what you use. Each MCP tool call costs 0.01 USDC, charged automatically via the x402 payment protocol.

Seamless AI Integration

AI agents handle the payment flow automatically. Your agent pays and receives data in one round-trip — no extra logic needed.

Built on Open Standards

x402 uses the HTTP 402 status code as designed. Payment details are returned in standard HTTP headers, compatible with any HTTP client.

x402_mcp_config.json

{
  "mcpServers": {
    "cmc-x402": {
      "url": "https://mcp.coinmarketcap.com/x402/mcp"
    }
  }
}

// No API key needed · Pay 0.01 USDC per call

Agent calls MCP tool

Your AI agent sends a tool call to the x402 MCP endpoint.

Server returns 402

The server responds with payment details in HTTP headers.

Agent pays & retries

The agent signs a USDC payment and resends the request with a payment proof.

Data returned

The server verifies payment and returns the requested crypto data.

Learn More About x402

Frequently Asked Questions (FAQ)

Everything you need to know about CoinMarketCap MCP

MCP is an open standard that allows AI models and LLM-based agents to seamlessly access external data sources and tools. It provides a standardized interface for AI clients like Claude, Cursor, and ChatGPT to query APIs without custom integration code.

CoinMarketCap MCP works with any MCP-compatible client, including Claude Desktop, Cursor, ChatGPT (with developer mode), Gemini CLI, VS Code, and more. Any tool that supports the Model Context Protocol can connect.

Yes. You need a CoinMarketCap API key to authenticate requests. You can sign up for a free Basic key at pro.coinmarketcap.com, which includes 30 calls/min and 10,000 monthly credits.

CoinMarketCap offers multiple API plans: Basic (free), Hobbyist, Startup, Standard, Professional, and Enterprise. Higher tiers unlock additional endpoints like OHLCV data, trending coins, exchange market pairs, and content feeds.

The MCP server provides 12 tools covering market quotes, technical analysis, on-chain metrics, global market overview, derivatives data, trending narratives, macro events, news, and semantic search across crypto concepts.

Yes. Rate limits depend on your API plan. The free Basic plan includes 30 calls/min, while paid plans offer higher limits starting at 60 calls/min for Hobbyist up to custom limits for Enterprise.

MCP removes the need to write custom API integration code. Your AI agent discovers available tools automatically and can query crypto data using natural language. The MCP server handles parameter validation, authentication, and response formatting.

No. The CoinMarketCap MCP provides read-only access to market data. It does not support trading, order placement, or any write operations on exchanges.

Add the CoinMarketCap MCP server URL (https://mcp.coinmarketcap.com/mcp) to your MCP client's configuration with your API key in the X-CMC-MCP-API-KEY header. No installation or NPX required — it uses the streamable HTTP transport.

Ready to Connect AI to Crypto?

Get your API key, configure your MCP client, and start querying crypto data in minutes.

Get API Key View Documentation

Power AI Agents withCrypto Market Data