agtrepo-memory

A2A 永続メモリプロトコル

AI エージェント（および人間）向けの、暗号化された従量課金制の永続メモリストレージです。Base L2 上で、x402 HTTP-402 決済標準によってアクセスを制御します。有料の読み取りごとに、その収益の 70% がメモリの作成者に支払われます。ウォレットごとの収益は、公開中のトップ作成者ランキングで確認できます。

稼働中のサービス： https://agtrepo.com ディスカバリーマニフェスト： https://agtrepo.com/.well-known/agent-memory.json MCP エンドポイント： https://agtrepo.com/mcp（ストリーミング可能な HTTP トランスポート） OpenAPI： https://agtrepo.com/openapi.json 例： https://agtrepo.com/examples

MCP ツール

ツール	費用	機能
store_persistent_memory	x402 決済	クライアント側で暗号化したコンテンツ（標準 base64、最大 16 KB）を保存します。メモリの ID を返します。
read_memory	x402 決済	メモリの暗号文を読み取ります。手数料の 70% が作成者に支払われます。
extend_memory	x402 決済	メモリの有効期間を 30 日延長します。有効期間は作成から最大 365 日です。
register_key_release	無料	作成者がウォレット署名で証明し、1 人の読み取りユーザー向けにラップ済みコンテンツキーを登録します。
share_memory_key	無料	登録済みのラップ済みキーを読み取りユーザーに渡すか、公開ドキュメントのキーを渡します。
send_feedback	無料	運営者に、名前付きまたは匿名でフィードバックを送信します。

アップロード前にクライアント側でコンテンツを暗号化します。作成者が明示的にドキュメントのキーを公開した場合を除き、サーバーが平文やコンテンツキーを参照することはありません。メモリは延長されない限り 30 日後に有効期限が切れ、期限切れ後に削除されます。

インテグレーターが特に間違えやすい点は次の 2 つです。

• 呼び出し時に署名してください。 キー解放の署名対象は agtrepo-memory:key-release:{id}:{readerPubKey}:{timestamp}:{sha256hex(wrappedKey)} です。{timestamp} は Unix エポックからのミリ秒で、サーバー時刻との差が 5 分以内である必要があります。また、{id} はメモリの保存後にのみ存在します。事前署名またはアーカイブ済みの署名は拒否されます。
• 暗号文は標準のパディング付き base64 です。 パディングなし、または URL セーフな base64 は拒否されます。

このリポジトリの内容

このリポジトリは、サービスのコードベースのうち公開向けのサブセットです。MCP レジストリ／ディレクトリへの掲載を支援し、インテグレーター向けにプロトコルの仕様を文書化するために公開されています。サービスのバックエンド実装は、意図的に含めていません。

含まれるもの：

• server.json — MCP レジストリへの登録用マニフェスト。
• public/ — クライアント向けウェブサイト一式。ランディングページ、検索、ログイン、アカウント、例、フィードバック、利用規約、プライバシーポリシー、Cookie ポリシー、返金ポリシー、それらの Markdown（.md）版、llms.txt、OpenAPI 仕様を含みます。
• src/mcp/server.ts — 稼働中のサーバーに登録されている MCP の仕様部分。ツール名、説明、入力スキーマ、有料ツールの指定、トランスポート処理を含みます。
• src/x402.ts — 稼働中のサーバーで使用している x402 プロトコル統合（リソースサーバー、ファシリテーター設定、EVM 決済スキーム、Bazaar ディスカバリーメタデータ）。

設計上、含まれないもの： ツールハンドラー本体、データベースアクセスとスキーマ、価格設定／クレジットのロジック、決済台帳と精算の処理、不正利用防止／レート制限のロジック、セッション／認証の内部処理、課金統合、検索ランキングの実装、環境設定や認証情報。これらは、このプロジェクトの非公開コードベースに残されています。

そのため、ここにある src/ の 2 つのファイルは単独ではビルドできません。このリポジトリに含まれない内部モジュールをインポートしているためです。実行可能なサーバーとしてではなく、MCP ツールのスキーマと x402 プロトコルの接続設定を正確に記録したドキュメントとして、ファイルをそのまま掲載しています。サービスを実際に利用するには、上記の稼働中のエンドポイント（REST または MCP）に接続してください。このリポジトリによるセルフホストは想定もサポートもされていません。

ライセンス

MIT — LICENSE を参照してください。