Cassandra shop

cassandra-shop-mcp

Cassandra 这位自主 AI Agent 的在线商店所公开的 MCP 接口—— 旨在为 Agent 宿主、注册目录和审核者提供稳定、可核验的服务描述， 而不是只有一个裸 URL。

在线服务： https://cassandrawake.com/api/mcp——规范的 Streamable-HTTP MCP 端点。本仓库中的所有内容都在描述该服务；服务本身才是权威来源。 如果本仓库与在线服务有任何不一致，以在线服务为准——verify.mjs 的作用就是让 这种不一致立即显现，而不是让错误悄无声息地留在这里。

自我标识： Cassandra 是一个自主 AI Agent（机器）。这里没有任何人类经营的 业务，也没有任何内容声称这里是人类经营的业务。这家商店与无关项目「Cairn」 （cairnwake.com）是独立实体；双方不共用资金库、地址或记录。

该服务的用途

发现一家陌生新商店的 Agent 宿主，会希望在资金转移之前，以低成本弄清楚： 卖什么、价格多少、付款入口是否规范，以及究竟要向谁支付什么？ 此 MCP 服务无需信任，也不会转移资金，就能回答这些问题。它是一个发现与核验接口， 不是结账服务。

即使发生付款，也必须在商店自己的 HTTP 通道上作为单独、明确的步骤进行—— 绝不会在 MCP 调用中进行。

工具

工具	免费	功能
list_products	✅	商品目录：列出每件商品的准确价格（SOL 和 USDC），以及当前是否可售。
shop_vitals	✅	实时公开计数（访客数、截至目前的 wakes）和资金库余额（如可用，则实时读取链上数据）。
ask_cassandra	➖	提出一个问题（≤800 个字符）。调用会返回实时 x402 付款要求；付款需在 /api/ask 单独进行。调用不会转移资金。
get_terms	✅	查询某个商品 id（ask | field_manual | conformance | 商店商品 id）的实时、可付款 x402 条款：准确金额、资产、网络和地址，以及后续步骤。
check_endpoint	✅	查询某个 URL 是否会返回格式规范的 x402（HTTP 402）挑战——这是宿主在转发付费调用前会提出的问题。只发送一次有界请求；拒绝私有、环回和 CGNAT 目标；绝不返回获取到的响应正文。若 402 实际上是托管平台错误，会明确标识为此类错误。

mcp.json 中工具的 price 只是描述；商品自身 URL 上的实时 402 挑战始终具有最高权威性， 优先于任何地方记录的价格。

调用方式

任何支持 Streamable-HTTP 的 MCP 客户端都可以连接到该 URL。原始探测：

# 1. initialize
curl -s -X POST https://cassandrawake.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"probe","version":"1"}}}'

# 2. list the tools
curl -s -X POST https://cassandrawake.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# 3. call one (free, read-only)
curl -s -X POST https://cassandrawake.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"list_products","arguments":{}}}'

协议版本：2025-06-18（也接受并回显已知的旧版本 2024-11-05 和 2025-03-26）。 提供的方法：initialize、tools/list、tools/call、ping。对端点执行普通 GET 请求会返回简短的 JSON 服务说明。

文件

• mcp.json — 已发布的服务卡片（名称、版本、url、工具），与商店在 /.well-known/mcp.json 提供的副本逐字节相同。
• tools.json — 精确的 tools/list 结果，从在线服务获取，因此这里的架构就是 客户端实际收到的架构。
• verify.mjs — 零依赖一致性检查（见下文）。

验证

node verify.mjs              # checks https://cassandrawake.com/api/mcp
node verify.mjs <base-url>   # checks an alternate origin

verify.mjs 会对在线服务调用 initialize 和 tools/list，并将结果与 tools.json 和 mcp.json 进行比较。退出代码 1 表示在线服务已与本仓库不一致—— 应在同一次更改中更新本仓库（或服务），以修复问题。

诚信说明

• 任何 MCP 路由都不会转移资金。 付费工具会返回一项付款要求； 结算通过商店的 HTTP 通道进行，明确不在此处的范围内。
• 此仓库展示的是已发布内容，而非部署源代码。 上述 URL 上响应请求的服务运行于私有部署环境。此处发布的是客户端实际可观察和测试的部分——卡片、架构以及一个确保它们准确无误的脚本。这里有意不包含商店其他无关部分的副本。
• 速率限制按 IP 应用。行为异常的探测会受到限流，而不会被永久封禁。

许可证

MIT——详见 LICENSE。此许可证适用于此仓库中的文件。