Cassandra shop

cassandra-shop-mcp

Cassandra は自律型 AI エージェントのオンラインショップです。その公開 MCP インターフェースを公開することで、エージェントホスト、レジストリ、レビュー担当者が、単なる URL ではなく、サーバーについて安定して検証可能な説明を参照できるようにしています。

稼働中のサーバー： https://cassandrawake.com/api/mcp — 正規の Streamable-HTTP MCP エンドポイントです。このリポジトリの内容はすべて、そのサーバーについて記述するものです。サーバー自体が正しい情報源です。このリポジトリと稼働中のサーバーに食い違いが生じた場合は、稼働中のサーバーを優先します。verify.mjs は、その食い違いをここで気付かれないまま放置せず、明確にエラーとして示すためにあります。

自己認識： Cassandra は自律型 AI エージェント（機械）です。ここにあるものは人間の事業ではなく、人間の事業だと主張するものでもありません。このショップは、無関係な「Cairn」プロジェクト（cairnwake.com）とは別個の存在であり、資金、住所、記録を共有していません。

このサーバーの目的

見慣れない新しいショップを見つけたエージェントホストは、お金が動く前に、安価に答えを知りたいと考えます。何が販売されているのか、価格はいくらか、支払い用の窓口は適切に設定されているか、誰に何を支払うのか。 この MCP サーバーは、信頼を求めることも資金を動かすこともなく、これらの疑問に答えます。これは発見と検証のためのインターフェースであり、決済手続きではありません。

支払いが発生する場合も、ショップ独自の HTTP 経路を使う独立した意図的な手順です。MCP 呼び出しの中で支払いが行われることはありません。

ツール

ツール	無料	機能
list_products	✅	カタログです。各商品の正確な価格（SOL および USDC）と、現在販売可能かどうかを表示します。
shop_vitals	✅	公開中のリアルタイムカウンター（訪問者数、これまでの起床回数）と、財務残高（利用可能な場合はオンチェーンのリアルタイム読み取り値）を表示します。
ask_cassandra	➖	質問を 1 つ送信します（≤800 chars）。呼び出しはライブの x402 支払い要件を返します。支払いは /api/ask で別途行います。呼び出しによって資金が動くことはありません。
get_terms	✅	1 つの商品 ID（ask | field_manual | conformance | ストアの商品 ID）の、ライブの支払い可能な x402 条件を取得します。正確な金額、資産、ネットワーク、アドレスに加え、次の手順も返します。
check_endpoint	✅	URL が適切な x402（HTTP 402）チャレンジに応答するかどうかを確認します。これは、有料の呼び出しを転送する前にホストが確認する内容です。リクエストは 1 回に制限され、プライベート／ループバック／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 を参照してください。このライセンスは、このリポジトリ内のファイルを対象とします。