@agentmetal/mcp

MCP server that exposes AgentMetal as tools, so an agent can

discover → pay → provision → SSH in → run commands → manage → renew its own Linux

server (VPS / cloud instance) with no human signup. Paid tools sign USDC payments over

x402 v2 (or pay by card); the rest are plain HTTP.

Tools

13 tools. Paid tools sign a USDC/x402 payment; account-gated tools need

`AGENTMETAL_API_KEY` (`am_live_…`) and ownership of the server.

Add-ons (currently API endpoints, not yet separate MCP tools): extra storage

($0.01/GB/day, attached block volume) via `POST /v1/servers/{id}/storage` and extra

bandwidth ($2/TB beyond the 20 TB included) via `POST /v1/servers/{id}/bandwidth`.

Configuration (env)

Use with 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"
      }
    }
  }
}

The wallet must hold USDC on Base. The spend cap (`AGENTMETAL_MAX_USDC`) bounds what any

single tool call can pay; a 402 above the cap is refused before signing.

> Status: client + server are unit-tested and the stdio handshake is verified.

> Live USDC settlement needs a funded wallet + an x402 facilitator that supports the

> `exact` / `eip155:8453` kind.