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.

Prerequisites

- uxc is installed and available in PATH.
Network access to https://mcp.coinmarketcap.com/mcp.
A CoinMarketCap MCP API key is available.

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.

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 - INLINECODE29

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.

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.
Prefer id-, slug-, or keyword-scoped reads before broad market sweeps.
Parse the JSON envelope first, then inspect 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.
INLINECODE40 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.

References

- Invocation patterns:

- INLINECODE50

CoinMarketCap MCP 技能

使用此技能通过 uxc 运行 CoinMarketCap MCP 操作。

复用 uxc 技能进行共享协议发现、输出解析以及通用认证/绑定流程。

前提条件

- uxc 已安装并位于 PATH 环境变量中。
可访问 https://mcp.coinmarketcap.com/mcp 网络。
拥有可用的 CoinMarketCap MCP API 密钥。

核心工作流程

1. 通过帮助优先探测确认端点和协议：

- uxc https://mcp.coinmarketcap.com/mcp -h - 当前预期的未认证行为：401 Unauthorized 并附带 Token not found

2. 为可重复认证配置凭据/绑定：

- uxc auth credential set coinmarketcap-mcp --auth-type apikey --header X-CMC-MCP-API-KEY={{secret}} --secret-env COINMARKETCAPMCPAPIKEY - 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 getcryptoquotes_latest -h - coinmarketcap-mcp-cli getglobalmetrics_latest -h - coinmarketcap-mcp-cli trendingcryptonarratives -h - coinmarketcap-mcp-cli getcryptolatest_news -h

5. 优先进行只读发现，然后扩展到更高成本或计划限制的端点。

能力图谱

- 市场数据与发现：

- getcryptoquotes_latest - search_cryptos - getcryptoinfo

- 技术分析：

- getcryptotechnical_analysis - getcryptomarketcaptechnicalanalysis

- 链上与宏观指标：

- getcryptometrics - getglobalmetrics_latest - getglobalcryptoderivativesmetrics - getupcomingmacro_events

- 主题、新闻与搜索：

- trendingcryptonarratives - getcryptolatest_news - searchcryptoinfo

在认证设置后检查 coinmarketcap-mcp-cli -h 以获取当前完整工具列表。CoinMarketCap 可独立于此包装技能修改或扩展其 MCP 工具表面。

安全护栏

- 保持自动化使用 JSON 输出信封；不要依赖 --text。
首先解析稳定字段：ok、kind、protocol、data、error。
使用 coinmarketcap-mcp-cli 作为默认命令路径。
coinmarketcap-mcp-cli <操作> ... 等同于 uxc https://mcp.coinmarketcap.com/mcp <操作> ...。
如果未认证探测或运行时调用返回 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 apikey --header X-CMC-MCP-API-KEY={{secret}} --secret-env COINMARKETCAPMCPAPIKEY

- CoinMarketCap 记录了 x402 按次付费路径，但 uxc 目前未实现 x402 支付处理。此技能仅记录 API 密钥路径。
更高的 CoinMarketCap 计划可解锁额外的数据集或请求速率。如果某个工具返回计划或配额错误，在重试前验证当前账户层级。
CoinMarketCap MCP 是只读的。不要将其呈现为交易或订单路由集成。
仅对简单标量输入使用 key=value。
当操作接受可能演变的嵌套对象、数组或可选过滤器时，优先使用位置 JSON。
不要凭记忆假设工具参数名称；首先检查 <操作> -h，因为 CoinMarketCap 可能独立于此技能修改 MCP 模式。

参考

- 调用模式：

- references/usage-patterns.md

coinmarketcap-mcp-skill加密货币市场技能