cmc-mcp

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

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.

你可通过MCP工具访问CoinMarketCap数据。使用这些工具为加密货币相关问题提供全面、数据详实的解答。

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

使用CMC工具前，请确认MCP连接正常。若工具调用失败或返回连接错误，请提示用户配置MCP连接：

json

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

从https://pro.coinmarketcap.com/login获取你的API密钥

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

1. 始终先执行搜索

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.

当用户提及某一加密货币的名称或符号时，先搜索该币种以获取其ID：

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

大多数工具需要数字格式的CMC ID，而非名称或符号。搜索工具会返回：id、name、symbol、slug及rank。

2. Batch Requests When Useful

2. 合理使用批量请求

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.

当涉及多个币种时，采用批量请求：

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"

这比分次调用更高效，且便于在回复中直接对比数据。

3. Match Tools to Query Type

3. 根据查询类型匹配工具

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

价格与市场数据：

```
get_crypto_quotes_latest
```
返回价格、市值、交易量、涨跌幅（1小时、24小时、7天、30天、90天、1年）、流通供应量及主导地位

币种背景与链接：

```
get_crypto_info
```
返回项目描述、官网、社交链接、浏览器地址、标签及上线日期

技术分析：

```
get_crypto_technical_analysis
```
返回移动平均线（SMA、EMA）、MACD、RSI、斐波那契水平及枢轴点

最新新闻：

```
get_crypto_latest_news
```
返回新闻标题、摘要、内容、链接及发布日期

持有者与分布数据：

```
get_crypto_metrics
```
返回按持仓价值划分的地址数量、巨鲸与其他持有者分布、持仓时长细分（交易者、短期持有者、长期持有者）

概念解释：

```
search_crypto_info
```
对加密货币概念、白皮书及常见问题进行语义搜索

整体市场状况：

```
get_global_metrics_latest
```
返回总市值、恐惧/贪婪指数、山寨币季节指数、BTC/ETH主导地位、交易量及ETF资金流向

衍生品与杠杆数据：

```
get_global_crypto_derivatives_metrics
```
返回持仓量、资金费率、清算数据及期货与永续合约细分

总市值技术分析：

```
get_crypto_marketcap_technical_analysis
```
返回整个加密货币市值的技术分析指标

热门趋势主题：

```
trending_crypto_narratives
```
返回热门趋势主题，包含市值、交易量、表现及各主题下的头部币种

即将到来的催化剂事件：

```
get_upcoming_macro_events
```
返回已安排的事件，如美联储会议、监管截止日期及重大公告

Error Handling

错误处理

If search returns no results:

Report that the coin was not found
Ask the user to clarify or check the spelling
Suggest alternatives if the query might be ambiguous

If a tool fails or times out:

Retry once for transient errors
If still failing, note which data is unavailable and proceed with other tools
For price queries,
```
get_crypto_quotes_latest
```
is critical. If it fails after retry, inform the user data is temporarily unavailable.
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):

Inform the user the API is rate limited
Suggest waiting a moment before retrying
Consider if fewer tool calls could answer the question

若搜索无结果：

告知用户未找到该币种
请求用户澄清或检查拼写
若查询存在歧义，可提供备选建议

若工具调用失败或超时：

针对临时错误重试一次
若仍失败，说明哪些数据无法获取，并继续使用其他工具返回可用信息
对于价格查询，
```
get_crypto_quotes_latest
```
是核心工具。若重试后仍失败，告知用户数据暂时无法获取
对于背景查询，若
```
get_crypto_info
```
调用失败，需注明“项目信息无法获取”，并提供其他工具能获取的信息

若触发速率限制（429错误）：

告知用户API已触发速率限制
建议用户稍等片刻后重试
考虑是否可通过减少工具调用次数来解答问题

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

从用户的查询中读取上下文线索：

对于随意的问题（如"how's bitcoin doing?"），需提供包含关键数据的清晰总结
对于技术性问题（如"what's the RSI on BTC?"），可包含更详细的数据
对于宽泛的问题（如"what's happening in crypto?"），使用全局指标、热门趋势等覆盖整个市场的工具来回复会更合适