内容
# x402-mcp
> 面向AI智能体的跨交易所加密货币市场结构。20个交易所，26个固定的Pillar代币以及任意代币的轻度覆盖，7种工具 - 轻度覆盖，snapshot，订单流，宏观状态，完整分析，地址风险和API信息。通过MCP免费提供。
[](https://www.npmjs.com/package/@tunedforai/x402-mcp)
[](https://opensource.org/licenses/MIT)
`x402-mcp` 是一个stdio MCP服务器，暴露了 [x402.tunedfor.ai](https://x402.tunedfor.ai) - 一个实时的加密货币市场结构API - 作为7种工具，任何MCP兼容的客户端（Claude Desktop，Cursor，Cline，Windsurf，Claude Code）都可以调用。通过MCP免费提供用于测试和低频查询；付费REST在相同的端点为需要更高吞吐量的生产智能体提供。
---
## 安装
### Claude Desktop / Cursor / Windsurf
将以下内容添加到您的MCP配置中（`~/Library/Application Support/Claude/claude_desktop_config.json` 在macOS上，其他操作系统上类似）：
```json
{
"mcpServers": {
"x402": {
"command": "npx",
"args": ["-y", "@tunedforai/x402-mcp"]
}
}
}
```
### Claude Code
```bash
claude mcp add x402 -- npx -y @tunedforai/x402-mcp
```
### Cline / Continue / 其他MCP客户端
使用与stdio命令相同的 `npx -y @tunedforai/x402-mcp` 调用。
### 手动安装
```bash
npm install -g @tunedforai/x402-mcp
x402-mcp # 运行stdio服务器
```
---
## 工具
所有7种工具都是无状态的。无需API密钥，无需身份验证，无需设置。直接调用它们。
| 工具 | 返回内容 | REST等效 | 通过MCP免费 / 付费REST |
|---|---|---|---|
| `marketLight` | 任意代币的CoinGecko支持的市场覆盖：价格，动量，排名，流动性/交易所上下文和风险标志。默认为`brief=off`；设置`brief=full`以获取Kimi简介 | `POST /data/light` | 免费 / $0.05 |
| `marketSnapshot` | 免费的16字段MCP子集：实时价格，资金，OI，买卖比率，恐惧/贪婪 | `POST /data` | 免费 / $0.20 |
| `marketAnalyze` | 宏观状态，DXY，VIX，方向信号+置信度 | `POST /analyze/market` | 免费 / $0.25 |
| `marketOrderflow` | 跨交易所CVD，鲸鱼活动，清算压力 | `POST /analyze/orderflow` | 免费 / $0.50 |
| `marketFull` | 快照+订单流+LLM综合分析 | `POST /analyze/full` | 免费 / $0.75 |
| `addressRisk` | 钱包风险评分（混币器，制裁，交易对手）。EVM + Solana | `POST /analyze/address` | 免费 / $0.25 |
| `apiInfo` | 定价，快速启动，迁移详细信息 | `GET /api_info` | 免费 |
### 代币覆盖
快照层的主要L1和L2：BTC，ETH，SOL，XRP，BNB，DOGE，ADA，AVAX，LINK，ATOM，DOT，ARB，SUI，OP，LTC。
扩展订单流层：上述代币加上NEAR，AAVE，BCH，HBAR，SHIB，TON，TRX，UNI，XLM。
marketLight支持列出的CoinGecko符号，超出固定的Pillar代币列表。使用它来对诸如WCT等代币进行轻量级覆盖，当固定快照/订单流工具拒绝某个符号时。默认情况下，`brief=off`以降低延迟；当您特别需要Kimi生成的简介时，请请求`brief=full`。
从任何MCP客户端调用`apiInfo`以获取权威的当前列表。
---
## MCP子集合约
marketSnapshot返回一个免费的16字段MCP子集，用于智能体上下文和路由。它不是付费REST `/data`模式。
预期的顶级MCP键：
- `as_of_utc`
- `token`
- `snapshot`
- `data_freshness`
- `presentation_hint`
- `next_steps`
`snapshot`对象承载16个市场数据字段以及元数据。`token`和`fetched_at`是元数据键，因此原始JSON键计数可能显示17个键在`snapshot`下，即使产品合约是16字段市场数据子集。
无需从MCP获取`schema_version`或`coverage`。除非MCP产品合约被故意扩展，否则它们属于付费REST合约。
每个`marketSnapshot`响应必须保留REST CTA：
```text
这是16字段MCP子集。付费REST /data 在 x402.tunedfor.ai ($0.20 USDC) 返回完整的70字段快照，包括链上指标，情绪和历史百分位。无需API密钥，从任何钱包按调用付费。
```
---
## 示例
### 交易前检查
```
您：marketSnapshot BTC
LLM：BTC 在 $74,180。买入比例 58% — 看涨倾向。资金利率 +0.012%
（轻微多头偏向）。未平仓利息 $14.2B。恐惧与贪婪：32（恐惧）。
快照 12 秒前。
```
### 跨交易所订单流
```
您：marketOrderflow ETH
LLM：ETH 跨交易所 CVD：-1.2M 美元（卖方主导）过去一小时。
鲸鱼活动：8 个大柱分布在 Binance/Coinbase/Bybit。
清算：$890K 多头，$230K 空头。压力：看跌。
```
## 免费MCP与付费REST
MCP包装 **免费且有速率限制** - 非常适合测试，原型设计，低频智能体工作流程和个人使用。
对于生产智能体（24/7轮询，多代币监控，大规模回测），请在 [x402.tunedfor.ai](https://x402.tunedfor.ai) 使用付费REST端点。REST是：
- **按调用付费（USDC on Base 或 Solana）** 通过 [x402 协议](https://www.x402.org/)
- **无需API密钥** - 您的智能体在本地签署支付；私钥从未离开您的机器
- **速率限制为每分钟60次调用和每小时200次调用** - 防止 stripmining；429 在违规时
- **无需订阅** - 无月度最低消费
从任何MCP客户端调用`apiInfo`以获取当前的定价计划，迁移指南和SDK示例。
---
## x402 支付方式（REST层级）
当您的智能体调用付费REST端点时:
1. 第一个请求返回 `HTTP 402 Payment Required` 以及价格
2. 智能体在本地签署USDC支付（私钥从未离开智能体）
3. 智能体重试并附上支付头部
4. 服务器验证链上结算并返回数据
无需账户，无需API密钥，无需信用卡。只有USDC和钱包。
---
## 数据源
- **价格 + 股票代码：** OKX，Coinbase 公共API
- **资金 / OI / 清算：** [Coinalyze](https://coinalyze.net) （商业许可）
- **链上指标，交易所流动，鲸鱼比率：** 许可的第三方机构数据
- **跨交易所订单流（CVD，鲸鱼条，清算聚合）：** 20个交易所的WebSocket聚合器进入InfluxDB，标准化为1分钟条
- **宏观背景（DXY，VIX，国债收益率）：** FRED + Finviz
- **恐惧与贪婪指数：** alternative.me
我们不重新分配原始交易所数据 - 我们提供派生，计算的聚合数据。所有原始源字段在响应返回前都会转换为我们自己的复合信号。
---
## 链接
- **服务：** [x402.tunedfor.ai](https://x402.tunedfor.ai)
- **REST 文档：** [x402.tunedfor.ai/catalog](https://x402.tunedfor.ai/catalog)
- **快速入门：** [x402.tunedfor.ai/llms.txt](https://x402.tunedfor.ai/llms.txt)
- **npm：** [@tunedforai/x402-mcp](https://www.npmjs.com/package/@tunedforai/x402-mcp)
- **Smithery：** [smithery.ai/server/@tunedforai/x402-mcp](https://smithery.ai)
- **问题/请求：** [github.com/tunedforai/x402-mcp/issues](https://github.com/tunedforai/x402-mcp/issues)
- **x402 协议：** [x402.org](https://www.x402.org/)
---
## 许可证
MIT © Tuned For AI
