402-mcp

Nostr: npub1mgvlrnf5hm9yf0n5mf9nqmvarhvxkc6remu5ec3vf8r0txqkuk7su0e7q2

👁 MIT licence
👁 TypeScript
👁 Node
👁 Coverage
👁 Nostr
👁 GitHub Sponsors

AI エージェントに経済的エージェンシーを与える L402 + x402 クライアント MCP です。人間による登録、API キー、仲介者なしで、支払いゲート付き API を発見、支払い、利用できます。

• 発見: Nostr 上で有料 API を発見 — 事前に URL を知る必要はありません

• 自動支払い: Lightning (NWC)、Cashu ecash、または人間による QR コード確認で支払い

• 認証情報のキャッシュと暗号化: 保存時に暗号化 (AES-256-GCM)

• あらゆる L402 サーバーで動作: toll-booth、Aperture、または将来の実装すべてに対応

クイックスタート

1. インストール

npx 402-mcp

2. Claude Code に接続

claude mcp add 402-mcp -- npx 402-mcp

3. 試してみる

Claude にこう尋ねてください: "Search for paid joke APIs using l402-search" — ウォレットは不要で、発見するだけです。

有料の呼び出しを行う準備はできましたか？完全なクイックスタートガイドを参照してウォレットを設定し、エージェントが最初の API 呼び出しの支払いを行う様子を確認してください。

Related MCP server: ag402-mcp

仕組み

graph LR
 A["1. l402-config()"] --> B["2. l402-discover(url)"]
 B --> C["3. Agent reasons<br/>about pricing"]
 C --> D["4. l402-buy-credits()<br/>or l402-fetch()"]
 D --> E["5. l402-fetch(url)<br/>with credentials"]
 E --> F["6. Data returned<br/>+ balance cached"]

セッション例:

Agent: "I need routing data from routing.trotters.cc"

1. l402-config()
 -> nwcConfigured: true, maxAutoPaySats: 1000

2. l402-discover("https://routing.trotters.cc/api/route")
 -> 10 sats/request, toll-booth detected, tiers available

3. Agent reasons: "I need ~20 requests. The 500-sat tier
 gives 555 credits. Better value."

4. l402-buy-credits(url, amountSats=500)
 -> Paid 500 sats, received 555 credits

5. l402-fetch("https://routing.trotters.cc/api/route?from=...&to=...")
 -> 200 OK, route data, 545 credits remaining

詳細なアーキテクチャと支払いフローの図については、docs/architecture.mdを参照してください。

設定

トランスポートの選択とフォールバック

kind 31402 イベントが複数の URL (トランスポートごとに 1 つ) をアドバタイズする場合、402-mcp は設定に基づいて最適なものを選択します:

1. 優先順位: TRANSPORT_PREFERENCE=tor で .onion URL が利用可能な場合、それが最初に試行されます。

2. 可用性フォールバック: 優先トランスポートに到達できない場合 (プロキシ未設定、タイムアウトなど)、クライアントはリスト内の次の URL にフォールバックします。

3. クリアネットのデフォルト: 優先順位が設定されていない場合、.onion や HNS エントリよりも先にクリアネット URL が試行されます。

サービスは、同じサービス (同じ価格設定、同じマカロンキー) に対して、異なるトランスポートで複数のエンドポイントをアナウンスできます。これは純粋に検閲耐性のためであり、トランスポートを切り替える際に再認証する必要はありません。Tor または HNS エンドポイントに到達するには、上記の対応するプロキシ/ゲートウェイ環境変数を設定する必要があります。

ツール

コア L402 (任意のサーバー)

toll-booth 拡張機能

支払い方法

優先順位の高い順に 3 つの支払いレールが試行されます:

1. NWC (Nostr Wallet Connect) — 完全自律型。接続されたウォレットから支払い

2. Cashu — 完全自律型。ecash トークンを溶かして請求書を支払い

3. ヒューマン・イン・ザ・ループ — QR コードを提示し、決済をポーリング

エージェントは呼び出しごとにメソッドをオーバーライドできます。また、必要なメソッドのみを設定することも可能です。

l402-fetch は 4 つの HTTP 402 チャレンジバリアントを透過的に処理します:

安全性

MAX_AUTO_PAY_SATS は、単一の自律的な支払いに上限を設けます。この制限を超えると、エージェントは人間に承認を求める必要があります。エージェントは l402-config を介してこの制限を読み取り、購入の意思決定に反映させることができます。

プライバシー

402-mcp は認証情報をローカルマシン上のみに保存します (~/.402-mcp/credentials.json、保存時に暗号化)。第三者にデータは送信されません。アカウント、追跡、分析はありません。支払いは Lightning または Cashu を使用するため、設計上匿名です。

エコシステム

支払いゲート付き API の分散型マーケットプレイス 402.pub でライブ L402 サービスを閲覧してください。

402-mcp は、Lightning Labs の lightning-agent-tools や Coinbase の x402 に代わる、支払いレール非依存の代替手段です。Lightning ノードは不要で、複数のウォレットと暗号化された認証情報を使用します。

エージェントに 独自の Lightning ノードを実行させたい場合は Lightning Labs のツールを使用してください。インフラなしで任意のウォレットから支払うエージェントが必要な場合は 402-mcp を使用してください。

開発のセットアップとガイドラインについては、CONTRIBUTING.mdを参照してください。

Built by @forgesworn.

• Lightning tips: thedonkey@strike.me

• Nostr: npub1mgvlrnf5hm9yf0n5mf9nqmvarhvxkc6remu5ec3vf8r0txqkuk7su0e7q2

ForgeSworn Toolkit の一部

ForgeSworn は、Nostr 用のオープンソースの暗号 ID、支払い、調整ツールを構築しています。

ライセンス

MIT

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers