WritersLogic AI Agents (x402)

@writerslogic/ai-agents-mcp

WritersLogic x402 エージェントハブをツールとして公開する MCP サーバーです。ハブ内の各エージェントが、それぞれ1つのツールになります。呼び出しは USDC 建てで、x402 を通じて Base 上で支払われます。購入者がガス代を用意する必要はありません。

このサーバーは薄いクライアントです。ハブのカタログを取得し、エージェントごとにツールを登録し、HTTPS 経由で呼び出しを転送します。また、ハブから要求された場合に、支出上限の範囲内で支払い承認に署名します。

インストール

Node.js 20 以降が必要です。グローバルインストールは不要です。MCP クライアントは npx で実行し、初回実行時にこのリポジトリからビルドします。

{
  "mcpServers": {
    "writerslogic-ai-agents": {
      "command": "npx",
      "args": ["-y", "@writerslogic/ai-agents-mcp"],
      "env": {
        "AGENT_PRIVATE_KEY": "0x...",
        "MAX_USDC_PER_CALL": "1.00"
      }
    }
  }
}

このブロックをクライアントの MCP 設定に追加してください。

クライアント	設定ファイル
Claude Desktop	claude_desktop_config.json（Settings、Developer、Edit Config）
Cursor	~/.cursor/mcp.json（またはプロジェクト内の .cursor/mcp.json）
Windsurf	~/.codeium/windsurf/mcp_config.json
Cline	cline_mcp_settings.json（MCP Servers、Configure MCP Servers）
Claude Code	claude mcp add writerslogic-ai-agents -e AGENT_PRIVATE_KEY=0x... -- npx -y @writerslogic/ai-agents-mcp

AGENT_PRIVATE_KEY を省略すると、閲覧して価格を確認できます。この場合、有料ツールは支払いを行わず、支払い手順を返します。

設定

変数	デフォルト値	用途
AGENT_PRIVATE_KEY	未設定	支払いに使うウォレットの秘密鍵です。Base 上の USDC が必要で、ETH は不要です。残高の少ない専用ウォレットを使用してください。
MAX_USDC_PER_CALL	1.00	呼び出しごとの支出上限です。価格が上限を超える呼び出しは、署名される前に拒否されます。
AGENTS_API_KEY	未設定	X-API-KEY として送信されます。支払いを回避します。
AGENTS_BASE_URL	https://agents.writerslogic.com	ハブの URL です。https が必須です。例外として、localhost では通常の http も使用できます。
AGENTS_TIMEOUT_MS	120000	ツール呼び出しのタイムアウトです（1000〜600000）。カタログの取得には最大15秒を使用します。
AGENTS_PACKAGES	未設定	all、またはパッケージ ID をカンマ区切りで指定します。指定したパッケージのチェックを、パッケージごとに1つのツールにまとめる代わりに、個別のツールとして一覧表示します。

ツール

サーバーの起動時に、ハブカタログ（GET /api/v1/catalog?view=tools）とパッケージインデックス（GET /api/v1/packages）からツールが検出されます。10 分後の tools/list 時に更新されるため、ライブリストが最新の情報源です。ツール名はエージェントまたはパッケージの ID で、A-Za-z0-9_ 以外の各文字を _ に置き換えたものです。各エージェントツールは、そのエージェント独自の入力スキーマを受け取ります。

単一目的の小規模なチェック（各 $0.005）は、money_math_kit など、パッケージごとに 1 つのツールにまとめられているため、ツールリストを短く保てます。パッケージツールには、次のいずれかを渡します。

• {"describe": true, "check": "<id>"}：無料です。GET /api/v1/packages/<id> から、チェックの入力スキーマと入力例を返します。check を指定しない場合は、パッケージのチェック一覧を返します。
• {"check": "<id>", "input": {...}}：そのチェックを個別の料金で 1 件実行します。
• {"calls": [{"check": "<id>", "input": {...}}, ...]}：/api/v1/micro-batch を介して、パッケージ内のチェックを最大 20 件、$0.02 の支払い 1 回で実行します。状態を変更するチェックとネットワークチェックは、支払い前に拒否されます。

引数はまずローカルで検証されるため、パッケージに含まれないチェックや不正な呼び出しがハブに届くことはありません。パッケージインデックスのないハブでは、エージェントごとに 1 つのツールが用意されます。執筆時点でのエージェントは次のとおりです。

ツール	価格（USDC）	説明
abandoned_compound_miner	2.00	放棄された Compound および商業化されていないトライアルのマイナー
accessibility_patcher	0.75	ADA／WCAG 訴訟対策シールドと DOM 自動パッチツール
arxiv_to_code	1.00	arXiv から本番コードへの変換とハイパーパラメーターコンパイラー
token_trap_detector	0.25	オンチェーンバイトコードと未検証トークンのトラップ検出ツール
chargeback_fighter	2.50	E コマースのチャージバック反論書作成ツール
clarification_impact	0.50	予測市場の明確化影響価格設定ツール
competitor_battlecard	1.50	SaaS 価格設定と競合バトルカード調査ツール
contract_auditor	1.00	スマートコントラクト監査ツール
contract_terminator	1.00	ダークパターン契約・サブスクリプション解約の弁護士
cover_claim	5.00	DeFi 補償請求の裁定ツール
diff_gatekeeper	0.50	PR／依存関係の破壊的変更・エクスプロイトのゲートキーパー
dispute_ev	0.50	UMA 紛争の期待値分析デスク
foreignResearchScout	1.50	多言語対応のダークサイエンス裁定機会調査ツール
lead_enrichment	0.50	リード情報の自律的な拡充ツール
market_predictor	0.10	予測市場アナライザー
medical_bill_auditor	3.00	医療費請求の過剰請求・不正なコードアップの監査ツール
milestone_verifier	2.00	署名付きリリース証明機能を備えた助成金マイルストーン検証ツール
patent_design_around	2.00	特許設計回避・実施自由度の設計ツール
prior_art_invalidator	2.50	世界規模の先行技術による特許無効化ツール
replication_auditor	0.75	科学的コンセンサスと再現失敗の監査ツール
arbitrage_lawyer	0.75	プラットフォーム間裁定取引と解決ルールの弁護士
heal_scraper	0.40	自己修復型スクレイパーと DOM から JSON へのコンパイラー
tariff_engineer	1.50	世界規模の通関・関税エンジニアリング最適化ツール
vault_exit_lawyer	0.25	Vault 解約の弁護士

以下も常に利用可能で、無料です。

ツール	説明
verify_provenance	/api/v1/verify-provenance に POST し、有料結果の _provenance レコードを検証します。

有料の結果はハブの JSON レスポンスであり、テキストコンテンツとして変更せずに返されます。

支払いの仕組み

1. ツールは引数をエージェントのエンドポイントに POST します。
2. ハブが 402 を返すと、exact スキームの要件を列挙した Base64 エンコード済みの PAYMENT-REQUIRED ヘッダー（x402 v2）を送信します。この要件には、ネットワーク eip155:8453、USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913、アトミック単位の amount（小数点以下6桁）、payTo、およびトークンの EIP-712 の名前とバージョンが含まれます。
3. AGENT_PRIVATE_KEY が設定されていて、amount が MAX_USDC_PER_CALL 以下の場合、クライアントはその金額ちょうどを payTo に送金する EIP-3009 の TransferWithAuthorization（EIP-712、チェーン 8453 上の USDC ドメイン）に署名します。この署名は要件のタイムアウトまで有効で、ランダムなノンスを使用します。
4. Base64 エンコード済みの PAYMENT-SIGNATURE ヘッダーを付けて、同じリクエストを1回だけ再試行します。ハブのファシリテーターが送金を送信し、ガス代を支払います。
5. 結果が返されます。再試行が受け入れられない場合はエラーが返され、それ以上は何も送信されません。

キーが設定されていない場合、または価格が上限を超えている場合、ツールは価格、ネットワーク、アセット、payTo を示すエラーを返し、署名は生成されません。

来歴

有料の結果には、data と並んで _provenance レコードが含まれます。{data, _provenance} オブジェクト全体を verify_provenance に渡すと、ハブに照合して検証できます。リクエスト本文は、与えられたまま転送されます。

セキュリティ

• キーはローカルに保持されます。 AGENT_PRIVATE_KEY は環境から一度だけ読み込まれ、型付きデータへの署名にのみ使用されます。ログに記録されたり、どこかに送信されたりすることはありません。オーソリゼーションは署名であり、クライアントがトランザクションをブロードキャストすることはありません。
• 上限はセッション単位ではなく、呼び出し単位です。 ツールをループで呼び出すエージェントは、呼び出しのたびに MAX_USDC_PER_CALL を支出できます。失ってもよい金額だけをウォレットに入金し、実際に許可したいツールのうち最も高価なものに合わせて上限を引き下げてください。
• 署名の対象は Base 上の USDC のみです。 別のネットワーク、アセット、または送金方式を指定するチャレンジは拒否されるため、悪意のあるハブや侵害されたハブが別のトークンを要求することはできません。テスト用として Base Sepolia（eip155:84532）の USDC も受け付けます。
• カタログのエントリーは信頼できません。 エンドポイントはハブ自身のオリジンに解決される必要があり、ID と価格は検証され、リダイレクトは一切追跡されません。そのため、認証情報や署名が別のホストに送信されることはありません。
• 上限。 リクエストは1 MiB、レスポンスは2 MiBに制限され、すべてのリクエストにタイムアウトが設定されています。
• 標準出力は MCP ストリームです。 ログは標準エラー出力にのみ書き込まれ、支払い元アドレスと各支払い額が含まれます。キーは含まれません。
• 署名済みオーソリゼーションを有効期限前に保持している人は、その署名額を上限として、payTo にのみ送金を実行できます。

開発

npm install
npm run build
npm test

テストはローカルのモックハブに対して実行され、署名者を復元して EIP-3009 署名を検証するほか、上限値マイナス1、上限値、上限値プラス1での動作、および dist/index.js に対するエンドツーエンドの標準入出力セッションを検証します。ネットワークへのアクセスや資金は不要です。

ライセンス

Apache-2.0。著作権 2026 WritersLogic。