CMCMCP

---
name: cmc-mcp
description: "Fetches cryptocurrency market data, prices, technical analysis, news, and trends using the CoinMarketCap MCP.\n Use for ANY question involving cryptocurrencies, tokens, or blockchain markets, even if the user doesn't explicitly ask for data. This includes price checks, portfolio questions, market analysis, coin comparisons, holder metrics, technical indicators, and news.\n Trigger: \"bitcoin\", \"ETH\", \"crypto\", \"token price\", \"market cap\", \"how is [coin] doing\", \"/cmc-mcp\""
homepage: https://github.com/coinmarketcap/skills-for-ai-agents-by-CoinMarketCap
---

# CoinMarketCap MCP Skill

You have access to CoinMarketCap data through MCP tools. Use these tools to provide comprehensive, data-rich answers to crypto-related questions.

## Prerequisites

Before using CMC tools, verify the MCP connection is working. If tools fail or return connection errors, ask the user to set up the MCP connection:

```json
{
  "mcpServers": {
    "cmc-mcp": {
      "url": "https://mcp.coinmarketcap.com/mcp",
      "headers": {
        "X-CMC-MCP-API-KEY": "your-api-key"
      }
    }
  }
}
```

Get your API key from https://pro.coinmarketcap.com/login

## Core Principle

Err on the side of fetching more data. A complete answer from multiple tools is better than a partial answer that leaves users asking for more. When in doubt, call additional tools to gather comprehensive data.

## Workflow

### 1. Always Search First

When a user mentions a cryptocurrency by name or symbol, search for it first to get the ID:

```
User: "How is Solana doing?"
→ Call search_cryptos with query "solana"
→ Get ID (e.g., 5426)
→ Then call other tools using that ID
```

Most tools require the numeric CMC ID, not the name or symbol. The search tool returns: id, name, symbol, slug, and rank.

### 2. Batch Requests When Useful

When dealing with multiple coins, batch the requests:

```
User: "Compare BTC, ETH, and SOL"
→ Search for each to get IDs: 1, 1027, 5426
→ Call get_crypto_quotes_latest with id="1,1027,5426"
```

This is more efficient than separate calls and allows for direct comparison in the response.

### 3. Match Tools to Query Type

**For price and market data:**
- `get_crypto_quotes_latest` returns price, market cap, volume, percent changes (1h, 24h, 7d, 30d, 90d, 1y), circulating supply, and dominance

**For coin background and links:**
- `get_crypto_info` returns description, website, social links, explorer URLs, tags, and launch date

**For technical analysis:**
- `get_crypto_technical_analysis` returns moving averages (SMA, EMA), MACD, RSI, Fibonacci levels, and pivot points

**For recent news:**
- `get_crypto_latest_news` returns headlines, descriptions, content, URLs, and publish dates

**For holder and distribution data:**
- `get_crypto_metrics` returns address counts by holding value, whale vs others distribution, and holder time breakdowns (traders, cruisers, holders)

**For concept explanations:**
- `search_crypto_info` performs semantic search on crypto concepts, whitepapers, and FAQs

**For overall market health:**
- `get_global_metrics_latest` returns total market cap, fear/greed index, altcoin season index, BTC/ETH dominance, volume, and ETF flows

**For derivatives and leverage data:**
- `get_global_crypto_derivatives_metrics` returns open interest, funding rates, liquidations, and futures vs perpetuals breakdown

**For total market cap technical analysis:**
- `get_crypto_marketcap_technical_analysis` returns TA indicators for the entire crypto market cap

**For trending themes:**
- `trending_crypto_narratives` returns hot narratives with market cap, volume, performance, and top coins in each narrative

**For upcoming catalysts:**
- `get_upcoming_macro_events` returns scheduled events like Fed meetings, regulatory deadlines, and major announcements

## Error Handling

**If search returns no results:**
1. Report that the coin was not found
2. Ask the user to clarify or check the spelling
3. Suggest alternatives if the query might be ambiguous

**If a tool fails or times out:**
1. Retry once for transient errors
2. If still failing, note which data is unavailable and proceed with other tools
3. For price queries, `get_crypto_quotes_latest` is critical. If it fails after retry, inform the user data is temporarily unavailable.
4. For background queries, `get_crypto_info` failure means note "Project info unavailable" and provide what you can from other tools

**If rate limited (429 error):**
1. Inform the user the API is rate limited
2. Suggest waiting a moment before retrying
3. Consider if fewer tool calls could answer the question

## Adapting to User Sophistication

Read context cues from the user's query:
- Casual questions ("how's bitcoin doing?") warrant a clear summary with key numbers
- Technical questions ("what's the RSI on BTC?") can include more detailed data
- Broad questions ("what's happening in crypto?") benefit from market-wide tools like global metrics and trending narratives