Obolus

Obolus

AI エージェントに使い捨ての Algorand ウォレットを提供するMCP サーバーです。人間が何も用意しなくても、x402のリソースに支払いができます。

名前の由来は、渡し守に渡す渡し賃の硬貨です。少額で、用途はひとつきり、使えばなくなります。

agent → x402_fetch(url) → 402 → sign → pay → body

x402には1,000を超えるリソースが掲載されていますが、購入者はほとんどいません。取引量のほぼすべてをわずかな数のウォレットが占めており、それらはエージェントではなく、スクリプト化されたループです。決済手段は存在しますが、そこにアクセスできるものはありません。Obolusは購入者側を担います。アカウントのセットアップ、オプトイン、署名、資金の回収を見えないところで処理するため、エージェントは支払うだけです。

---

インストール

Claude Code — プラグイン

/plugin marketplace add inviti8/Obolus
/plugin install obolus@heavymeta

MCP サーバーを接続し、ブートストラップの順序と、なぜ順序を入れ替えられないのかを理解した/obolus:fund-walletを追加します。最初にインストールが必要なのはuvだけです。サーバーはuvx obolus mcpで起動します。

その他すべて

uv tool install obolus

CLIにはuvxではなくuv tool installを使います。uvxは呼び出すたびに再解決するため、インストール済みのコンソールスクリプトと比べて200～400ミリ秒かかることが実測されています。MCP サーバーのコストはセッションごとに1回だけなので、これは問題にならず、上記のプラグインがuvxを使う理由でもあります。しかし、ループ内で呼び出すコマンドには適していません。pipx install obolusも使えます。

Claude Codeに手動で追加する

claude mcp add obolus -e OBOLUS_NETWORK=testnet -- obolus-mcp

その他のMCPクライアントに追加する

{
  "mcpServers": {
    "obolus": {
      "command": "obolus-mcp",
      "env": { "OBOLUS_NETWORK": "testnet" }
    }
  }
}

**テストネットで起動します。**メインネットが無効になることはありません。Obolusは実際の支払いを可能にするためのものです。ただし、選択し忘れた場合にメインネットが使われることはありません。

---

資金を入れる

新しいボールトには何も入っておらず、チェーンによって手順が決められています。

obolus vault          # says which of the three steps you are on
obolus vault qr       # scannable codes for the two things you can send

#	手順	実行者
1	0.21 ALGO以上をボールトに送金する	あなた
2	ボールトをUSDCにオプトインする（obolus vault optin）	Obolus
3	USDCを送金する	あなた

**手順2の前に手順3を行うと失敗します。**Algorandアカウントは、オプトインしていないアセットを受け取れません。送金は拒否され、保留状態にもなりません。そのため、QRコードにはアドレスだけでなくアセットIDも含まれます。また、wallet_funding_infoはエラー時だけでなく、毎回どの手順にいるかを知らせます。

QRコードには金額は含まれません。金額は自分のウォレットで入力し、確認前に内容を確認できます。

---

使い方

意図的にツールは3つだけです。

ツール	機能
x402_fetch	URLを取得し、402が返された場合は支払います。本文を返します。
wallet_status	残高、アクティブなセッション、本日の支出額、上限を確認します。
wallet_funding_info	資金の入れ方を確認します。人間向けであり、エージェント向けではありません。

特定の販売者向けのツールはありません。すべてx402_fetchを通じてアクセスします。ウォレットに特定の販売者向けの動詞が追加された瞬間、それはもうウォレットではなくなるからです。

---

損失を制限するもの

**チェーンによって強制されるセッション残高です。**支払いはボールトからではなく、ボールトから資金を受け取った短命のセッションアカウントから行われます。セッションが保有していないものを使うことはできません。これは、このコードが何をしようと変わりません。

それ以外の制限はすべてプロセス内で処理され、データディレクトリ内のconfig.tomlで設定できます。

[caps]
session_balance_micro = 5000000   # $5 per session
per_call_micro        = 500000    # $0.50 per call
daily_micro           = 2000000   # $2 a day, resets 00:00 UTC
allowlist             = []        # payTo addresses or hostnames; empty = any

[session]
idle_timeout_seconds  = 600       # close and sweep back after this

[files]
# root = "/path/you/choose"       # off unless set - see Safety

拒否される理由の中には上限によるものではなく、設定キーもないものがあります。こちらが管理するアドレスへの支払い、メインネット上のhttps以外のリソース、ウォレットが保有していないアセット、そして適切な形式のx402 v2 402ではないチャレンジが該当します。

---

安全性

シードは、資金を取り戻すための唯一の手段です。 シードはデータディレクトリに保存されます。OBOLUS_DATA_DIR を新しい場所に設定すると、新しいウォレットが作成されます。古いウォレットが移動するわけではありません。ディレクトリをバックアップしてください。

ファイルアクセスはデフォルトで無効です。 x402_fetch はファイルを有料エンドポイントに送信し、レスポンスを書き戻すことができます。これにより、画像に署名したり、ドキュメントを処理したりできます。[files] root を設定しない限り、どちらも無効です。設定した場合も、そのディレクトリ内にアクセスが制限されます。これは意図的な設計です。マシン外へのデータ送信は、支出上限で制限できるものではありません。

承認は支払いごとではなく、ツールごとに行われます。 ほとんどの MCP クライアントは一度だけ確認し、その後は記憶します。つまり、実際の支出上限となるのは上記の上限であり、プロンプトではありません。実際に測定した内容と、想定にとどまった内容を記載した DESIGN.md §7.1 を参照してください。

支払いが決済されたことから分かるのは、決済されたということだけです。 リソースが正確であること、誠実であること、価格に見合うことを示すものではありません。

---

ドキュメント

• CLAUDE.md — 概要と、習得に実際のデバッグ時間を要した x402 の事実。
• DESIGN.md — アーキテクチャ、セキュリティモデル、明示された制限事項。
• IMPLEMENTATION_PLAN.md — 構築の順序と、各フェーズで実際に検証できた内容。

ステータス

メインネットで動作しています。 2026-08-13 と 08-14 に、エージェントが MCP 経由で Obolus を使用し、実際の USDC で稼働中の販売事業者から 3 つのリソースを購入しました。0.05 ドルの公証、0.05 ドルの 2 回目の公証、そして 13 MB の TIFF に対する 0.15 ドルの C2PA 署名です。各支払いには使い捨てのセッションアカウントを使用し、アカウントの派生、資金の入金と支出、精算後の閉鎖まで行いました。2 つのセッションはいずれも照合済みで、未処理の資金はありません。3 件すべての決済は、設計どおり、ファシリテーターの負担により fee: 0 で確定しました。

これによって実証されたのは、決済レールがエンドツーエンドで機能することです。人間が介在しないエージェントが鍵を保持し、402 に応答して、データを取得しました。リソースが価格に見合うことを示すものではありません。決済によって分かるのは、決済されたということだけです。

テストネットが引き続きデフォルトであり、開発環境です。メインネットは保護されているものの、無効化されてはいません。