x402-mcp

@carbon-cashmere/x402-mcp

MCP 服务，可将 Carbon & Cashmere 的 177 个加密货币市场情报端点提供给你的 AI Agent 使用，并通过你的钱包自动进行 x402 USDC 微支付。

你将获得

安装此 MCP 后，你的 AI Agent 可以调用以下工具：

• get_v1_news — 经分析的加密货币新闻，包含情绪和市场影响
• get_v1_stablecoins — 总市值、各币种供应量、链分布
• get_v1_onchain_btc — Bitcoin 链上指标（哈希率、内存池、矿工资金流）
• get_v1_bittensor_leaderboard — 按排放量排名的 Bittensor 前 100 名矿工
• get_v1_mantis_realized_accuracy — MANTIS 子网（UID 253）的实际准确率记录
• get_v1_intel_snapshot — 汇总市场情报快照
• ……以及订阅（$10/天、$50/周、$200/月）、赞助商等级（$500–$50000），还有 170 多个研究端点，每次调用收费 $0.003–$0.50

**总计 177 个付费端点。**默认公开排名前 100 的端点（根据收入和受欢迎程度筛选）。设置 X402_TOOL_LIMIT=177 即可公开全部端点，包括各币种变体。

每次调用工具都会从你配置的钱包中触发一笔 USDC 微支付。无需订阅，无需 API 密钥。仅按使用量付费。

安装

Claude Desktop

将以下内容添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "carbon-cashmere": {
      "command": "npx",
      "args": ["-y", "@carbon-cashmere/x402-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0x_your_evm_private_key_here",
        "SVM_PRIVATE_KEY": "your_base58_solana_private_key_here_optional"
      }
    }
  }
}

重启 Claude Desktop。排名前 100 的 Carbon & Cashmere 工具（根据收入和受欢迎程度筛选）将显示在工具面板中。

Cursor / Cline / Continue

配置相同的 JSON，将其粘贴到 MCP 设置面板中。

钱包设置

安全提示：请使用专用的消费钱包，不要使用主钱包。 你的 EVM_PRIVATE_KEY 以明文形式保存在 Claude Desktop 配置中。主机上 任何能够读取该文件的进程都能获取密钥。请将它视为一旦丢失也不会 介意的热钱包：只存入你计划花费的小额资金（$10–$50 USDC），绝不要 存入主钱包中的资产。

• EVM_PRIVATE_KEY（Base / Polygon / Arbitrum / World / Avalanche 支付必需）
  • 以 0x 开头的十六进制字符串（例如 0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80）
  • 在 Base 主网上存入 USDC（费用最低、速度最快，每次调用的 Gas 费约为 $0.0001）
  • 一次性成本：约 $10 USDC 可支持 200 多次工具调用
  • **硬性上限 = 钱包余额。**失控的 Agent 循环最多只能花完已存入的金额； 签名金额受链上可用 USDC 余额限制。
• SVM_PRIVATE_KEY（可选，用于 Solana 支付）
  • 以 base58 编码的 Solana 密钥对字节
  • 仅当工具仅路由至 Solana 时才需要

**网络白名单。**MCP 服务只会为 API 的 402 响应 accepts[] 数组中列出的网络签署支付（目前包括 Base、Polygon、Arbitrum、World Chain、Solana、Algorand、Stellar）。路由到其他任何链的请求都会在签名层被拒绝——你的密钥不会被诱骗去为任意网络签名。

**密钥绝不会离开你的设备。**密钥只保存在你的 Claude Desktop 配置和本地运行的 MCP 进程中。支付签名在你的设备上完成；只有签名后的 EIP-712 / SIWS 载荷会发送给 Carbon & Cashmere。

仅发现模式（未设置密钥）

如果启动 MCP 服务时未设置 EVM_PRIVATE_KEY 和 SVM_PRIVATE_KEY，服务将以仅发现模式运行：工具注册正常，免费端点正常工作，调用付费工具时则会向 Agent 返回 402 错误。适用于：评估工具目录、检查 MCP 市场（Glama、npm 抓取器），或在未为钱包充值的情况下于 CI/测试环境中运行。

工作原理

Claude Desktop          @carbon-cashmere/x402-mcp        api.carbon-cashmere.de
     |                          (your machine)                 (our server)
     |  call get_v1_news        |                                 |
     |------------------------->|  GET /v1/news                   |
     |                          |-------------------------------->|
     |                          |  402 + PAYMENT-REQUIRED         |
     |                          |<--------------------------------|
     |                          |  sign with EVM_PRIVATE_KEY      |
     |                          |  GET /v1/news + PAYMENT-SIG     |
     |                          |-------------------------------->|
     |                          |  200 OK + data                  |
     |                          |<--------------------------------|
     |  formatted data          |                                 |
     |<-------------------------|                                 |

基于 Coinbase 官方 x402 v2 协议构建。结算使用 Base USDC（或你选择的链）。典型延迟：每次调用约 2–3 秒（一次性支付 + 获取数据）。

工具数量

默认情况下，会开放排名前 100 的工具 — 由服务器端根据实际结算量、美元收入、探索权重和描述质量综合评分后精选（目录会重新排序，无需重新发布 npm 包）。

X402_TOOL_LIMIT	可用内容
50	最小配置 — 排名前列的免费工具、工具包，以及少量高收入端点
100（默认）	高收入层级 — 增加 $10–$50 订阅、赞助层级、每周／每日报告以及链上工具包
177	全部工具 — 增加按币种细分的专用路由（vol-regime/{coin}、hurst/{coin}、trend/{coin}、…）。仅当 Agent 知道要查询哪种币时才建议使用。

覆盖默认值：

"env": {
  "X402_TOOL_LIMIT": "177"
}

默认设定上限的原因：MCP 工具过多可能会降低 Agent 选择工具的准确性。根据经验，Claude 3.5 Sonnet 及更新版本的最佳数量为 100。

配置环境变量

变量	必填	默认值	说明
EVM_PRIVATE_KEY	二选一	—	用于 Base/Polygon/Arbitrum 的 0x 前缀 EVM 密钥
SVM_PRIVATE_KEY	二选一	—	base58 Solana 密钥对
X402_API_BASE	否	https://api.carbon-cashmere.de	API 基础 URL
X402_TOOL_LIMIT	否	100	开放的工具数量上限（1-177）
X402_LOG_LEVEL	否	info	debug | info | warn | error

安全性

• 密钥不会离开你的设备。 MCP 服务在本地作为 Claude Desktop 的子进程运行。
• 按调用付费上限。 每次调用费用为 $0.003–$0.50。即使循环失控，支出也受钱包余额限制。
• 无需链下凭据。 无需 API 密钥，也无需 OAuth。纯链上结算。
• 开源。 自行审查代码：github.com/CarbonCashmere/x402-mcp

许可证

MIT — 参见 LICENSE。

链接

• Carbon & Cashmere API：https://api.carbon-cashmere.de
• x402 协议：https://github.com/coinbase/x402
• MCP 协议：https://modelcontextprotocol.io