Back to Details

coinmarketcap-mcp-skill

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

CoinMarketCap MCP Skill

CoinMarketCap MCP Skill

Use this skill to run CoinMarketCap MCP operations through 
uxc
.
Reuse the 
uxc
skill for shared protocol discovery, output parsing, and generic auth/binding flows.
使用此Skill通过
uxc
执行CoinMarketCap MCP操作。
复用
uxc
Skill以实现共享协议发现、输出解析以及通用认证/绑定流程。

Prerequisites

前置条件

  • uxc
    is installed and available in 
    PATH
    .
  • Network access to 
    https://mcp.coinmarketcap.com/mcp
    .
  • A CoinMarketCap MCP API key is available.
  • 已安装
    uxc
    且其路径已添加至
    PATH
    环境变量。
  • 可访问
    https://mcp.coinmarketcap.com/mcp
    网络地址。
  • 拥有CoinMarketCap MCP API密钥。

Core Workflow

核心工作流程

  1. Confirm endpoint and protocol with help-first probing: 
    • uxc https://mcp.coinmarketcap.com/mcp -h
    • expected unauthenticated behavior today: 
      401 Unauthorized
      with 
      Token not found
  2. Configure credential/binding for repeatable auth: 
    • uxc auth credential set coinmarketcap-mcp --auth-type api_key --header "X-CMC-MCP-API-KEY={{secret}}" --secret-env COINMARKETCAP_MCP_API_KEY
    • uxc auth credential set coinmarketcap-mcp --auth-type api_key --header "X-CMC-MCP-API-KEY={{secret}}" --secret-op op://Engineering/coinmarketcap/mcp-api-key
    • uxc auth binding add --id coinmarketcap-mcp --host mcp.coinmarketcap.com --path-prefix /mcp --scheme https --credential coinmarketcap-mcp --priority 100
  3. Use fixed link command by default: 
    • command -v coinmarketcap-mcp-cli
    • If missing, create it: 
      uxc link coinmarketcap-mcp-cli https://mcp.coinmarketcap.com/mcp
    • coinmarketcap-mcp-cli -h
  4. Inspect operation schema before execution: 
    • coinmarketcap-mcp-cli get_crypto_quotes_latest -h
    • coinmarketcap-mcp-cli get_global_metrics_latest -h
    • coinmarketcap-mcp-cli trending_crypto_narratives -h
    • coinmarketcap-mcp-cli get_crypto_latest_news -h
  5. Prefer read-only discovery first, then expand into higher-cost or plan-gated endpoints.
  1. 通过优先帮助式探测确认端点和协议： 
    • uxc https://mcp.coinmarketcap.com/mcp -h
    • 当前未认证情况下的预期行为：返回
      401 Unauthorized
      ，提示
      Token not found
  2. 配置凭证/绑定以实现可重复认证： 
    • uxc auth credential set coinmarketcap-mcp --auth-type api_key --header "X-CMC-MCP-API-KEY={{secret}}" --secret-env COINMARKETCAP_MCP_API_KEY
    • uxc auth credential set coinmarketcap-mcp --auth-type api_key --header "X-CMC-MCP-API-KEY={{secret}}" --secret-op op://Engineering/coinmarketcap/mcp-api-key
    • uxc auth binding add --id coinmarketcap-mcp --host mcp.coinmarketcap.com --path-prefix /mcp --scheme https --credential coinmarketcap-mcp --priority 100
  3. 默认使用固定链接命令： 
    • command -v coinmarketcap-mcp-cli
    • 若未安装，创建链接：
      uxc link coinmarketcap-mcp-cli https://mcp.coinmarketcap.com/mcp
    • coinmarketcap-mcp-cli -h
  4. 执行前检查操作架构： 
    • coinmarketcap-mcp-cli get_crypto_quotes_latest -h
    • coinmarketcap-mcp-cli get_global_metrics_latest -h
    • coinmarketcap-mcp-cli trending_crypto_narratives -h
    • coinmarketcap-mcp-cli get_crypto_latest_news -h
  5. 优先进行只读发现，再扩展至更高成本或需特定权限的端点。

Capability Map

功能映射

  • Market data and discovery: 
    • get_crypto_quotes_latest
    • search_cryptos
    • get_crypto_info
  • Technical analysis: 
    • get_crypto_technical_analysis
    • get_crypto_marketcap_technical_analysis
  • On-chain and macro metrics: 
    • get_crypto_metrics
    • get_global_metrics_latest
    • get_global_crypto_derivatives_metrics
    • get_upcoming_macro_events
  • Themes, news, and search: 
    • trending_crypto_narratives
    • get_crypto_latest_news
    • search_crypto_info
Inspect 
coinmarketcap-mcp-cli -h
after auth setup for the current full tool list. CoinMarketCap can revise or expand its MCP tool surface independently of this wrapper skill.
  • 市场数据与发现： 
    • get_crypto_quotes_latest
    • search_cryptos
    • get_crypto_info
  • 技术分析： 
    • get_crypto_technical_analysis
    • get_crypto_marketcap_technical_analysis
  • 链上与宏观指标： 
    • get_crypto_metrics
    • get_global_metrics_latest
    • get_global_crypto_derivatives_metrics
    • get_upcoming_macro_events
  • 主题、新闻与搜索： 
    • trending_crypto_narratives
    • get_crypto_latest_news
    • search_crypto_info
完成认证设置后，可通过
coinmarketcap-mcp-cli -h
查看当前完整工具列表。CoinMarketCap可独立于此包装Skill修改或扩展其MCP工具范围。

Recommended Usage Pattern

推荐使用模式

  1. Start with one focused read goal:
    • current quote and market cap for a coin
    • trend or narrative scan for a sector
    • global market and derivatives snapshot
    • latest news or semantic lookup on a project/topic
  2. Run 
    -h
    on the specific tool before the first real call.
  3. Prefer id-, slug-, or keyword-scoped reads before broad market sweeps.
  4. Parse the JSON envelope first, then inspect 
    data
    .
  1. 从一个明确的只读目标开始：
    • 某一加密货币的当前报价和市值
    • 某一板块的趋势或行业叙事扫描
    • 全球市场与衍生品快照
    • 某一项目/主题的最新新闻或语义查询
  2. 在首次实际调用前，运行对应工具的
    -h
    命令查看帮助。
  3. 优先进行基于ID、别名或关键词的只读查询，再进行广泛的市场扫描。
  4. 先解析JSON信封，再查看
    data
    字段内容。

Guardrails

注意事项

  • Keep automation on JSON output envelope; do not rely on 
    --text
    .
  • Parse stable fields first: 
    ok
    , 
    kind
    , 
    protocol
    , 
    data
    , 
    error
    .
  • Use 
    coinmarketcap-mcp-cli
    as default command path.
  • coinmarketcap-mcp-cli <operation> ...
    is equivalent to 
    uxc https://mcp.coinmarketcap.com/mcp <operation> ...
    .
  • If unauthenticated probe or runtime call returns 
    401 Unauthorized
    or 
    Token not found
    :
    • confirm auth binding matches endpoint with 
      uxc auth binding match https://mcp.coinmarketcap.com/mcp
    • confirm credential shape with 
      uxc auth credential info coinmarketcap-mcp
    • reset credential as API-key header if needed: 
      uxc auth credential set coinmarketcap-mcp --auth-type api_key --header "X-CMC-MCP-API-KEY={{secret}}" --secret-env COINMARKETCAP_MCP_API_KEY
  • CoinMarketCap documents an x402 pay-per-call path, but 
    uxc
    does not implement x402 payment handling today. This skill documents only the API-key route.
  • Higher CoinMarketCap plans unlock additional datasets or request rates. If a tool returns a plan or quota error, verify the current account tier before retrying.
  • CoinMarketCap MCP is read-only. Do not present it as a trading or order-routing integration.
  • Use 
    key=value
    only for simple scalar inputs.
  • Prefer positional JSON when an operation accepts nested objects, arrays, or optional filters that may evolve.
  • Do not assume tool argument names from memory; inspect 
    <operation> -h
    first because CoinMarketCap may revise MCP schemas independently of this skill.
  • 自动化操作仅基于JSON输出信封，不要依赖
    --text
    参数。
  • 优先解析稳定字段：
    ok
    、
    kind
    、
    protocol
    、
    data
    、
    error
    。
  • 使用
    coinmarketcap-mcp-cli
    作为默认命令路径。
  • coinmarketcap-mcp-cli <operation> ...
    等同于 
    uxc https://mcp.coinmarketcap.com/mcp <operation> ...
    。
  • 若未认证探测或运行时调用返回
    401 Unauthorized
    或
    Token not found
    ：
    • 使用
      uxc auth binding match https://mcp.coinmarketcap.com/mcp
      确认认证绑定与端点匹配
    • 使用
      uxc auth credential info coinmarketcap-mcp
      确认凭证格式
    • 若需要，重置凭证为API密钥头：
      uxc auth credential set coinmarketcap-mcp --auth-type api_key --header "X-CMC-MCP-API-KEY={{secret}}" --secret-env COINMARKETCAP_MCP_API_KEY
  • CoinMarketCap提供按次付费的x402路径，但
    uxc
    目前未实现x402支付处理。本Skill仅记录API密钥路由。
  • 更高等级的CoinMarketCap套餐可解锁更多数据集或请求速率。若工具返回套餐或配额错误，请先验证当前账户等级再重试。
  • CoinMarketCap MCP为只读服务，请勿将其作为交易或订单路由集成。
  • 仅对简单标量输入使用
    key=value
    格式。
  • 当操作接受嵌套对象、数组或可能演变的可选筛选器时，优先使用位置JSON格式。
  • 不要凭记忆使用工具参数名称；先查看
    <operation> -h
    ，因为CoinMarketCap可能独立于此Skill修改MCP架构。

References

参考资料

  • Invocation patterns: 
    • references/usage-patterns.md
  • 调用模式： 
    • references/usage-patterns.md