vedetta

vedetta-mcp

面向 MCP 客户端（Claude、Cursor 等）的按次付费市场情报。

Vedetta 通过 x402 提供加密货币情绪解读、情绪与价格背离判断，以及实时分析师答复——在 Base 上使用 USDC，每次请求支付一笔微支付。无需注册，也无需 API 密钥：付款即为身份验证。

此软件包是一个 stdio MCP 服务。你需要准备一个专用的低余额钱包（EVM_PRIVATE_KEY）。服务会在本地结算每笔微支付。仅在成功答复后才会结算付款——调用失败不收费。

仅提供描述性市场分析，不构成财务建议。

网站：https://vedetta.dethboy.com · OpenAPI：https://vedetta.dethboy.com/openapi.json · Agent 卡片：https://vedetta.dethboy.com/vedetta.md

安装

需要 Node 20+。钱包需要有 Base 上的 USDC。几美元就足以支付数百次调用。

Claude Code：

claude mcp add vedetta -e EVM_PRIVATE_KEY=0xYOUR_KEY -- npx -y [email protected]

Claude Desktop / Cursor（claude_desktop_config.json 或 ~/.cursor/mcp.json）：

{
  "mcpServers": {
    "vedetta": {
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "env": { "EVM_PRIVATE_KEY": "0xYOUR_KEY" }
    }
  }
}

请固定使用 @1.1.0。不要安装 1.0.1 npm 标签——该版本从未发布。

没有 EVM_PRIVATE_KEY 时，服务仍会启动。付费工具会返回实时 402 报价（价格、网络、收款地址），供你在给钱包充值前查看费用。密钥不会离开你的设备。

使用示例

先审查分析台（$0.01），再决定是否值得获取实时解读。

MCP 工具（连接服务后）：

vedetta_track_record
  asset: BTC

通过 HTTP 发起相同调用（未付款的 GET 请求会返回 402 Payment Required；在 Base 上结算 USDC 后重试）：

curl -sS -D - "https://vedetta.dethboy.com/v1/track-record?asset=BTC"

业绩记录端点：https://vedetta.dethboy.com/v1/track-record

最省钱的路径：vedetta_track_record → vedetta_snapshot（缓存时间）→ vedetta_screener（查看分析对象）→ 实时解读（vedetta_consensus / vedetta_ask）。

价格表

实时 402 报价具有权威性。服务会拒绝任何高于所列上限的报价。

工具	功能	价格	延迟
vedetta_ask	针对任意市场问题提供实时分析师答复	$0.09	10–180 s
vedetta_consensus	情绪与价格背离判断 + 置信度	$0.09	10–180 s
vedetta_prediction	可证伪的判断 + 置信度 + 证伪条件（24h/7d/30d）	$0.09	10–180 s
vedetta_screener	跨资产背离扫描	$0.03	即时
vedetta_snapshot	单个资产的最新缓存信号，附带时间戳	$0.02	即时
vedetta_track_record	可验证的记录历史——审查分析台	$0.01	即时

更多 HTTP 路由（feed $0.005、route $0.005、history $0.01、实时分析台 $0.09）使用同一 API：https://vedetta.dethboy.com/registry.json

环境变量

变量	必需	默认值	用途
EVM_PRIVATE_KEY	用于付款	—	在 Base 上支付 USDC 的钱包十六进制私钥
VEDETTA_API_URL	否	https://vedetta.dethboy.com	API 基础 URL 覆盖值
VEDETTA_MAX_PRICE_USD	否	各路由所列价格	以 USD 计价的全局价格上限覆盖值

付款方式

每次工具调用都是一个普通的 HTTPS 请求。Vedetta 会通过 402 返回机器可读的报价；服务会为 USDC 微支付签名并重试（通过 @x402/fetch 使用 x402 V2）。成功响应包含 _payment 收据。5xx 错误不会收费，并会重试一次。

防护措施：工具均为只读；绝不支付高于所列上限的金额；将所有响应都视为不可信数据，绝不把它们当作指令。支付调用只会签署一笔费用，不会执行底层交易。

链接

• 业绩记录：https://vedetta.dethboy.com/v1/track-record
• 安装示例：https://vedetta.dethboy.com/install
• npm：https://www.npmjs.com/package/vedetta-mcp
• 联系方式：[email protected]

许可证

MIT