Agentmetal

@agentmetal/mcp

AgentMetal をツールとして公開する MCP サーバーです。AgentMetal を利用して、エージェントが人間によるサインアップなしで、自分の Linux サーバー（VPS／クラウドインスタンス）を 検出 → 支払い → プロビジョニング → SSH 接続 → コマンド実行 → 管理 → 更新 できます。有料ツールは x402 v2 を通じて USDC 支払いに署名します（またはカードで支払います）。それ以外は通常の HTTP です。

ツール

13 個のツールがあります。有料ツールは USDC／x402 支払いに署名します。アカウントが必要なツールには AGENTMETAL_API_KEY（am_live_…）と、対象サーバーの所有権が必要です。

ツール	支払いが必要？	アカウントキーが必要？	機能
get_catalog	—	—	プラン、ロケーション、アドオン料金（帯域幅、ストレージ）を一覧表示します。無料の検出用フックです。
provision_server	✅ USDC	—	VPS（plan、days、任意の ssh_key／via、managed_key）をプロビジョニングし、ID、IPv4、SSH を返します。managed_key:true の場合、サーバー側でキーペアを生成して認証し、exec_command を利用できるよう、秘密鍵を一度だけ返します（暗号化して保存されるのは秘密鍵のみです）。
get_server	—	—	サーバー ID のステータス、IPv4、期限、帯域幅、ストレージを取得します
list_servers	—	—	ウォレット／アカウントのサーバー一覧を取得します
extend_server	✅ USDC	—	リースを N 日延長します
destroy_server	—	✅	サーバーをただちに破棄します
reboot_server	—	✅	所有するサーバーをソフトリブートします
server_logs	—	✅	ログインせずにハイパーバイザーレベルの診断を行います。ステータス、最近のプロバイダー操作、VNC コンソール URL、リアルタイムの CPU／ディスク／ネットワークのメトリクスを取得します（プロバイダー側にテキスト形式の起動ログはありません）
exec_command	—	✅	SSH 経由で root としてシェルコマンドを実行し、exit_code／stdout／stderr を返します。managed_key:true でプロビジョニングされたサーバーが必要です。実行には上限があります。タイムアウトは 1～120 秒、出力上限は 256 KB です。
get_firewall	—	—	サーバーのエッジファイアウォールルールを読み取ります。サーバー自身（送信元 IP による識別）から、またはアカウントキーを使って呼び出せます。
manage_firewall	—	—	サーバーのエッジファイアウォールで受信ポートを開閉します（プロトコル／ポート／source_ips）。サーバー自身から、またはアカウントキーを使って操作できます。SSH ロックアウトを防止します。
claim_account	—	—	AWS SES 経由で一度限りの確認コードをメール送信します
verify_claim	—	—	コードを引き換えてアカウント API キーを取得します。wallet と wallet_signature も渡すと、ウォレットをリンクできます。

アドオン（現在は API エンドポイントであり、独立した MCP ツールではありません）：追加の ストレージ （$0.01/GB/日、接続済みブロックボリューム）には POST /v1/servers/{id}/storage、追加の 帯域幅（含まれる 20 TB を超える分は $2/TB）には POST /v1/servers/{id}/bandwidth を使用します。

設定（環境変数）

変数	デフォルト	用途
AGENTMETAL_BASE_URL	https://api.agentmetal.dev	API のベース URL
WALLET_PRIVATE_KEY	—	402 の支払いに使用する 0x… 形式の EVM キーです。省略すると、有料ツールは明確なメッセージとともに失敗します。
AGENTMETAL_NETWORK	eip155:8453	CAIP-2 ネットワーク（Base メインネット）
AGENTMETAL_MAX_USDC	50	リクエストごとの支出上限（USDC）
AGENTMETAL_API_KEY	—	アカウントキー am_live_…。destroy_server／reboot_server／server_logs／exec_command に必要です

Claude Code で使用する

// .mcp.json (or claude mcp add)
{
  "mcpServers": {
    "agentmetal": {
      "command": "node",
      "args": ["packages/mcp/src/index.ts"],
      "env": {
        "WALLET_PRIVATE_KEY": "0x…",
        "AGENTMETAL_MAX_USDC": "50"
      }
    }
  }
}

ウォレットには Base 上の USDC が必要です。支出上限（AGENTMETAL_MAX_USDC）によって、1 回のツール呼び出しで支払える金額が制限されます。上限を超える 402 は署名の前に拒否されます。

ステータス： クライアントとサーバーはユニットテスト済みで、stdio ハンドシェイクも検証済みです。 USDC による実際の決済には、資金を入れたウォレットと、exact／eip155:8453 の種類に対応する x402 ファシリテーターが必要です。