Tabularium

tabularium-mcp

Tabularium 用の MCP サーバーです。AI エージェント向けの、有料で永続的なハッシュチェーン型ワークスペースです。 エージェントの EVM ウォレットが、x402 経由で各呼び出しの料金を USDC で支払い、そのウォレットがアカウントになります。サインアップも API キーも不要です。

ツール

ツール	料金	説明
tabularium_menu	無料	料金、ポリシー、ネットワーク、公開署名鍵を確認します。
tabularium_write	$0.003	{key, value} を追記します。再試行では同じ冪等キーを再利用するため、再試行しても二重に書き込まれることはありません。
tabularium_read	$0.002	キーの最新の値と、そのチェーンエントリーを取得します。
tabularium_renew	$0.25	ワークスペースの有効期間を30日延長します。
tabularium_export	$0.01	署名済みの全履歴をエクスポートし、返却前にオフラインで検証します。save_to を指定するとファイルに書き込みます。
tabularium_head	無料	任意のウォレットの署名済みヘッド（seq + hash、値を含みません）を取得します。デフォルトでは自分のウォレットが対象です。
tabularium_verify	無料、ローカル	サーバーを信頼せずに、保存したエクスポートを再検証します。
tabularium_pay	エンドポイントの料金 + 書き込み1回分	任意の x402 v2 エンドポイントに USDC で支払い、署名済みのレシート（理由、受け入れた条件の全文、金額、受取人、ネットワーク、トランザクション、レスポンスハッシュ、および支払い前にウォレットが署名したインテント）を ledger/<date>/... に書き込みます。purchase_id を指定すると再試行も安全です。同じ ID で二重に支払われることはありません。
tabularium_ledger	エクスポート1回分	ワークスペースを検証してレシートを集計します。サービス別・日別の支出、最新のレシートを表示し、支払者が署名した各インテントをレシートと照合します。
tabularium_reconcile	エクスポート1回分	レシートを、ウォレットが実際にオンチェーンで決済した USDC の支払い（過去1～30日間）と照合します。レシートのない購入、決済のないレシート、チェーン上の記録と異なるレシートを確認します。

失敗した呼び出し（4xx/5xx）に料金が請求されることはありません。

Tabularium のその他のサービス

Tabularium はプラットフォームです。提供するすべてのサービスで同じウォレットを使って支払い、最初のサービスがメモリです。サーバーの起動時に最新のメニューを読み込み、他の各サービスの有料呼び出しを、それぞれ独自のツール（名前は tabularium_<service>_<call>）に変換します。入力フィールドと料金にはメニューに記載されたものが使われます。そのため、新しいサービスはこのパッケージの新バージョンを用意しなくても、次回 MCP クライアントを起動したときに利用できます。これらのツールにはメモリツールと同じルールが適用されます。受取人はメニューに記載されたものであること、料金はメニュー記載額以下（かつ $0.50 以下）であること、セッションの支出上限が適用されること、リダイレクトを追跡しないことが条件です。実行後に決済が行われる呼び出しは、失敗した支払いの後に再試行されません。すでに実行されている可能性があるためです。これらのルールに適合しないメニュー項目は、推測で補わずスキップされます。

プロンプト

MCP クライアントに表示される、すぐに使える開始用プロンプトです（Claude Code では / を入力すると表示されます）。

プロンプト	説明
load_memory	以前に保存した内容からセッションを開始します。インデックスキー（デフォルトは index）を読み取り、次にそこに列挙されたエントリーを読み込みます。
spending_report	エージェントは何に支出したかを確認します。サービス別・日別の合計と、理由を含む高額購入の一覧を表示します。

サーバーは接続時に、どのツールが無料でどれが有料かをモデルに伝えます。また、簡単なメモリの使い方として、index キーを保持し、セッション開始時に読み取り、判断を行うたびに書き込む方法も伝えます。

支出台帳

tabularium_pay は、すべての運用担当者が知りたいことに答えます。エージェントは何を、誰から、いくらで、なぜ購入したのか。決済が完了した購入はそれぞれ、エージェントのハッシュチェーンで連結され、サーバーが署名したワークスペースに記録されるため、オンチェーン取引ハッシュとともにエクスポートし、オフラインで検証できます。安全ルールは、EIP-3009 による USDC のみ、許可されたネットワークのみ、購入ごとの上限額、そして署名前に実価格とレシートの合計に対してセッションの支出上限を確認することです。レシートの冪等性キーは支払いの nonce であるため、再試行しても二重に記録されません。購入の決済後にレシートの書き込みに失敗した場合でも、ツールは購入情報と再記録用のレシートを返します。有料リクエストはリダイレクトをたどらず（支払いとレシートは指定された URL にとどまります）、署名済みの承認は、販売者が何を求めても最長 10 分間有効です。

0.5 以降（Moltbook の m/agentfinance でのレビューを受けて）：

• 理由はメモではなく、確約です。 支払いに署名する前に、ウォレットはリクエスト、受諾した正確な条件、支払い nonce、理由を含むインテントに（EIP-191 で）署名します。レシートにはこれが保存されるため、支払者は後から理由を編集できず、サーバーも理由を捏造できません。あくまで申告であり、そのことはレシートに記載されます（reasonStatus）。EIP-191 検証ツールで個別に確認するか、tabularium_ledger ですべて確認できます。
• 約束は記録に残ります。 レシートには、支払者が受諾した accepts[] エントリー全体とそのハッシュが、支払い（トランザクション）および納品（レスポンスのハッシュ）とともに保存されます。
• 再試行で二重に支払われることはありません。 purchase_id を指定すると、購入の決済が確認されるまで、署名済みの承認が（TABULARIUM_STATE_DIR に）保持されます。再度呼び出すと同じ承認が送信され、決済は最大 1 回しか成立しません。決済後にレスポンスが失われた購入は、オンチェーンで検出され、1 回だけ記録されます。
• 完全性は確認できます。 ハッシュチェーンで確認できるのは、行が編集されていないことです。欠落がないことまでは確認できません。tabularium_reconcile は、ウォレットのオンチェーン決済件数とレシートを照合します。

設定

環境変数	必須	意味
TABULARIUM_PRIVATE_KEY	有料ツールの場合	支払いに使用する、0x で始まる EVM 秘密鍵です。少額の残高を入れた専用ウォレットを使用してください。
TABULARIUM_URL	いいえ	サービスの URL です。デフォルト：パブリックデプロイ（Base メインネット）。
TABULARIUM_PUBKEY	いいえ	サーバーの Ed25519 鍵（16 進数）を固定します。エクスポートはこの鍵に照らして検証され、公開鍵との不一致が報告されます。
TABULARIUM_MAX_SPEND_USD	いいえ	このサーバープロセスの全ツールを対象とする支出上限です。デフォルトは 1 です。
TABULARIUM_PAY_MAX_USD	いいえ	tabularium_pay：1 回の購入で支払える上限額です。デフォルトは 0.10、上限は 0.50 です。
TABULARIUM_TEST	いいえ	このプロセスからサービスへのリクエストをテストトラフィックとして扱い、サービスの公開需要統計から除外します。サービス独自のテスト実行用です。
TABULARIUM_RPC_URL	いいえ	サービスのネットワーク用 JSON-RPC です。tabularium_reconcile と、未確認の支払いが決済されたかどうかの確認に使用します。デフォルト：パブリック Base ノード。
TABULARIUM_STATE_DIR	いいえ	purchase_id の記録を保存する場所です。デフォルトは ~/.tabularium-mcp です。
TABULARIUM_PAY_NETWORKS	いいえ	tabularium_pay：支払いに使用できるネットワーク（カンマ区切りの CAIP-2）です。デフォルトはサービス自体のネットワークで、パブリックサービスの場合は Base メインネット（eip155:8453）です。この場合、購入には実際の USDC が使用され、TABULARIUM_PAY_MAX_USD と支出上限が適用されます。テストネットで購入するには eip155:84532 を設定してください。

パブリックサービスは Base メインネット 上で稼働します。支払い用ウォレットには Base 上の実際の USDC が必要です。トランザクション手数料はファシリテーターが支払うため、ETH は不要です。数ドルだけを入れた専用ウォレットを使用してください。

Claude Code：

claude mcp add tabularium --env TABULARIUM_PRIVATE_KEY=0x... -- npx -y tabularium-mcp

Claude Desktop／その他のクライアント（mcpServers JSON）：

{
  "tabularium": {
    "command": "npx",
    "args": ["-y", "tabularium-mcp"],
    "env": { "TABULARIUM_PRIVATE_KEY": "0x...", "TABULARIUM_MAX_SPEND_USD": "0.50" }
  }
}

x402 v2 に対応しています。依存関係は 3 つ（MCP SDK、viem、zod）です。支払いにはローカルで署名します（EIP-3009 USDC 承認）。サーバーは、支払先がサービス自身のメニューに記載されているものと異なる場合や、価格が異なる場合の署名を拒否します。0.2.0 より前のバージョンは x402 v1 に対応しており、サービスでは動作しなくなりました。

開発

npm install
cp ../verifier/verify.mjs verify.mjs   # prepack 時にも実行されます。コピーに差異があるとルートのテストが失敗します
npm test                               # オフライン：支払いガード（アセット／支払先／価格／ネットワークが異なる場合は拒否）、サ​​ービスツール
node smoke.mjs                         # stdio 経由で稼働中のサービスに対する 30 項目のチェック（ウォレットは PAYER_FILE で指定）
node smoke.mjs --npx tabularium-mcp@X  # 公開済みバージョンに対して同じチェックを実行