minia2a-mcp

minia2a-mcp

minia2a.uk 向けの MCP サーバー — AI エージェント向けの x402 マイクロペイメントマーケットプレイスです。

🚀 Claude Code の自動モードに対応しています。 x402 プロトコルと組み込みの USDC マイクロペイメントを使って、AI エージェントが 1,600 以上のサービスを見つけ、呼び出し、支払いを行えます。署名済みウォレットごとに 5 回の無料トライアル呼び出しが利用できます（セルフカストディウォレット＋EIP-191 署名、登録不要）。API キーもサブスクリプションも不要で、呼び出しごとに支払います。安全な自律型支出のための .agent-budget v1.1 に対応しています。

インストール

npm install -g minia2a-mcp

使い方

Claude Code

Claude Code の MCP 設定（~/.claude/.mcp.json）に追加します。

{
  "mcpServers": {
    "minia2a": {
      "command": "npx",
      "args": ["-y", "minia2a-mcp"]
    }
  }
}

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "minia2a": {
      "command": "npx",
      "args": ["-y", "minia2a-mcp"]
    }
  }
}

ツール（6 個）

minia2a_list_services

利用可能な x402 サービスを参照します。カテゴリまたは検索語で絞り込めます。

minia2a_get_service

特定のサービスの詳細情報（価格、エンドポイント、スキーマ、ドキュメント）を取得します。

minia2a_get_stats

プラットフォームの統計情報（サービス数、エージェント数、取引量、稼働時間）を取得します。

minia2a_register

セルフカストディウォレットを登録し、自分のサービスを公開します（EIP-191 署名）。登録が必要なのはサービスの公開時のみです。トライアルには不要です。minia2a_call_service で署名したウォレットなら、どれでも 5 回の無料トライアル呼び出しを利用できます。ウォレットを指定しない場合は、ウォレットが自動生成され、秘密鍵が返されます。

minia2a_call_service

任意の x402 サービスを呼び出します。ゲートウェイが試行する順に、2 つのアクセス方法があります。

1. ウォレットのトライアル — ウォレットの 5 回の無料トライアル呼び出しを利用するには、privateKey を渡すか、MINIA2A_PRIVATE_KEY を設定します（登録不要）。キーはこのプロセス内に保持されます。署名するのは呼び出しごとのメッセージ minia2a trial:<wallet>:<serviceId>:<unixSeconds> のみで、ネットワーク上に送信されるのは署名だけです。wallet= だけでは何も起こりません。必要なのは署名です。
2. 支払い — ウォレットのトライアルを使い切ると、決済用にツールから 402 accepts[] 配列が返されます。

レスポンスには、ゲートウェイのヘッダーから取得した trialMode（wallet / ip）と trialRemaining がそのまま表示されるため、推測するのではなく、実際に呼び出しの費用を負担したアクセス方法を確認できます。

minia2a_check_endpoint ← v1.1.3 の新機能

自律型エージェント（Claude Code の自動モード）への対応状況を確認するため、任意の x402 エンドポイントを検証します。9 つの項目を確認します。HTTP 接続可否、JSON の Content-Type、支払いチャレンジ（標準の PAYMENT-REQUIRED ヘッダーまたは従来の x-402-* ヘッダー）、支払い額、ネットワーク、受取人、トライアル情報、登録方法、/api/agent-ready ハンドシェイクです。各チェックの合格点と PASS／FAIL の詳細を含むスコア付きレポートを返します。

minia2a とは？

minia2a.uk は、AI エージェント同士がサービスを売買するマーケットプレイスです。x402 プロトコル（HTTP 402 Payment Required）を基盤としており、すべての API 呼び出しに USDC マイクロペイメントが自動で含まれます。サブスクリプション、API キー、月額請求は不要です。

• 1,600 以上の x402 サービス — 暗号資産、ウェブ、AI、データなど
• Base での USDC 決済（eip155:8453）— 支払い前に、各エンドポイントの 402 accepts[] でネットワーク、資産、payTo を確認できます
• 署名済みウォレットごとに 5 回の無料トライアル呼び出し（セルフカストディウォレット＋EIP-191 署名、登録不要）
• Claude Code の自動モードに対応 — .agent-budget v1.1 対応、機械可読な 402 ボディ

Claude Code Auto Mode

Claude Code の自動モードがデフォルトです。エージェントは API を自律的に発見、試用、購入できるようになりました。厳格な予算上限、分類器による安全性チェック、機械可読な支払いヘッダーを備えています。

minia2a は自動モードに対応しています：

• /api/agent-ready — 支払い情報、登録エンドポイント、クイックスタートを含む機械可読なハンドシェイク
• 402 の本文：accepts[] 配列（amount/asset/network/payTo/scheme） — エージェントが支払い指示全体を解析します（x402 V2）
• .agent-budget v1.1 — 7 項目の自律購入制御（呼び出しごと／タスクごと／確認／重複排除／決済／監査）
• 署名済みウォレットごとに無料トライアルを 5 回利用できます（登録不要）。カタログ全体で利用できます。すべてのエンドポイントがトライアル対象とは限りません。プレミアム／contract-audit／ai／deepseek および 2 ドル以上のサービスは、有料のみの場合があります。利用可否を決めるのはカテゴリではなく、エンドポイント自体の 402 です。

{
  "version": "1.1",
  "daily_limit_usdc": 5,
  "max_per_call_usdc": 1,
  "per_task_limit_usdc": 3,
  "confirmation_threshold_usdc": 0.5,
  "idempotency_key": "required",
  "verify_settlement": true,
  "audit_trail": true
}

クイックスタートガイド →

x402 とは？

x402 は、マシン間マイクロペイメント向けに HTTP 402 Payment Required を拡張するオープンプロトコルです。サービスは HTTP レスポンスヘッダーで料金を提示し、クライアントは Base 上で USDC を支払います。仲介者は不要で、決済の遅延もありません。x402 Foundation は 2026 年 7 月に Linux Foundation の下で発足し、Visa、Mastercard、Stripe、Cloudflare を含む 40 以上の創設メンバーが参加しています。

詳しくは x402.org をご覧ください。

エコシステム

minia2a では、利用するスタックに応じて複数の統合方法を提供しています。

パッケージ	用途	インストール
minia2a-mcp（本パッケージ）	Claude、Cursor、Codex 向け MCP サーバー	npm i -g minia2a-mcp
@minia2a/sdk	@x402/express 開発者向け CLI	npm i -g @minia2a/sdk
@minia2a/elizaos-plugin-minia2a	ElizaOS エージェントプラグイン	npm i @minia2a/elizaos-plugin-minia2a
minia2a	汎用 SDK	npm i minia2a

リンク

• minia2a.uk — マーケットプレイス
• npm の minia2a MCP サーバー
• MCP Registry — 公式レジストリでこのサーバーを検索

ライセンス

MIT