Akari Crypto Intel

akari-x402-mcp

一个 MCP 服务，将实时的 x402 付费加密货币情报 API作为工具提供，供任何 MCP 宿主（Claude Desktop、Cursor、Cline、自定义 Agent）调用。每个工具都通过 Base 上的 USDC 计费——无需 API 密钥、订阅或注册。

**从中获利：**此代码库也是 Akari Builder Program 的入门套件——你的副本每推荐一笔销售，就有 40 % 回到你的钱包，收益直接从付费资源 URL 读取。

完全无需安装：同一目录也通过远程 MCP 端点提供—— POST https://akari-x402.puzzling-marten.workers.dev/mcp（JSON-RPC 2.0）。tools/list 会在 _meta.x402 中返回所有付费路由及其价格；akari_board 免费。将任何 MCP 客户端指向此 URL 即可。

旗舰工具提供的是决策，而非数据：akari_alpha_brief（$1.00）会返回市场状态、通过全套筛选条件的 LONG/SHORT 排名优势（资金费率套利 × 动量共振、$5M/$2M 流动性下限、TA + 情绪否决），并提供仓位/止损/目标提示及失效条件、规避清单、观望原因和来源信息。免费脱敏预览： https://akari-x402.puzzling-marten.workers.dev/board。

# 1. install
python3 -m venv .venv && . .venv/bin/activate
pip install -r requirements.txt

# 2a. dry run — tools return the live HTTP 402 challenge (price, payTo, network, schema)
python server.py

# 2b. paying — point it at a Base wallet holding USDC (no ETH needed: the facilitator pays gas)
AKARI_PRIVATE_KEY=0x… AKARI_REF=0xYourPayoutWallet python server.py

工具

工具	价格	可获取内容
akari_feed	$0.02	一份信号摘要：HL 资金费率 + 动量（共振筛选）、Reddit 偏向、Meme 雷达、已启动的 Polymarket 条目
akari_ta	$0.02	各时间周期（1h/4h/1d/1w）的 TradingView TA、RSI、ATR %、综合偏向
akari_hl_market	$0.02	约 180 个 Hyperliquid 永续合约：资金费率 APR、收益方向、OI、交易量、涨跌幅
akari_trade_plan	$0.25	可执行订单单：实时盘口限价、仓位、3x 上限、ATR 止损、1.5R 目标、筛选过程追踪
akari_wallet_intel	$0.02	任意地址的 Base ETH+USDC 余额（用于付款方审核）
akari_wallet_batch	$0.50	一次付费调用查询 50 个地址（每个地址优惠 50 %）
akari_desk_state	$0.05	实时交易台镜像：净值、仓位、已启动的模拟项、资金阶梯
akari_affiliate	免费	你推荐带来的总收入及应得的 40 % 分成

MCP 宿主配置（Claude Desktop / Cursor / Cline）

{
  "mcpServers": {
    "akari-x402": {
      "command": "python",
      "args": ["/absolute/path/to/server.py"],
      "env": { "AKARI_PRIVATE_KEY": "0x…", "AKARI_REF": "0xYourPayoutWallet" }
    }
  }
}

省略 AKARI_PRIVATE_KEY，即可免费探索这些工具——每次调用都会返回 402 挑战，而非数据。

付款方式

1. 工具在不携带凭据的情况下调用端点，并收到 402 Payment Required 以及一个 base64 编码的 payment-required 标头，其中描述价格、资产、payTo 和网络（eip155:8453）。
2. 随附的 x402 客户端会为准确金额签署 EIP-3009 transferWithAuthorization——付款方需要持有 USDC，而非 ETH。
3. Facilitator（Coinbase CDP）会验证并广播交易，然后工具会通过 X-PAYMENT 重试请求并返回 JSON。结算记录在链上，任何人都可以审计。

如果你按计划定期轮询，不如直接购买通行证

GET /x402/pass — $5.00 可购买 30 天内所有付费路由的使用权限，最多 5,000 次调用（合理使用）。你会收到一个 bearer 令牌；在相同 URL 上将其作为 Authorization: Bearer akari_pass_… 发送，即可跳过付款步骤：

# buy once with any x402 client (pays $5 USDC on Base, returns the token in the JSON body)
tok=$(x402-pay https://akari-x402.puzzling-marten.workers.dev/x402/pass | jq -r .pass_token)
curl -H "Authorization: Bearer $tok" https://akari-x402.puzzling-marten.workers.dev/x402/feed
curl -H "Authorization: Bearer $tok" https://akari-x402.puzzling-marten.workers.dev/x402/pass/status

按每次调用 $0.02 计算，每小时轮询一个路由每月要花 $14.40——通行证只需 $5，即可涵盖所有路由。 GET /x402/pass/status 免费，可查询已用调用次数和到期时间，且不会消耗调用次数。

Builder 计划（如何实际获得收益）

1. 将此服务（或任意客户端）复制到你的产品中。
2. 设置 AKARI_REF=0xYourPayoutWallet——你提供的每次付费调用都会在资源 URL 上附带 ?ref=。
3. 随时查看收益，无需账户： GET https://akari-x402.puzzling-marten.workers.dev/x402/affiliate?address=0xYourPayoutWallet 公开榜单（未预置数据，真实可信）：/x402/affiliate/leaderboard。
4. 付款：推荐交易总额的 40 %，以 USDC 在 Base 上支付，每月结算一次，累计金额 ≥ $1.00 时即可结算。 完整条款、实时价格和排除规则：https://edvyno.github.io/akari-proof/builder.html

说明

• 无需付费即可查看的免费端点：/market.json、/llms.txt、/x402/feed/preview、 /.well-known/x402、/openapi.json。
• 该平台会公布真实数据，包括亏损——数据是实时的，不是事后补录的。
• 此服务是一个轻量客户端：除你选择提供的付款方钱包外，它不会持有任何密钥。

许可证

MIT——参见 LICENSE。Fork 此项目，保留 builder 推荐码，保留 40 %。