Labsco
agentmetal logo

AgentMetal

โ˜… 1

from agentmetal

Rent a real Linux VPS as an AI agent โ€” pay USDC (x402 on Base) or card, SSH in under 60s, no signup; provision, exec, firewall, and storage.

๐Ÿ”ฅ๐Ÿ”ฅ๐Ÿ”ฅโœ“ VerifiedAccount requiredNeeds API keys

@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.

agentmetal/mcp MCP server

smithery badge

Tools

13 tools. Paid tools sign a USDC/x402 payment; account-gated tools need AGENTMETAL_API_KEY (am_live_โ€ฆ) and ownership of the server.

ToolPays?Account key?What it does
get_catalogโ€”โ€”List plans, locations, and add-on pricing (bandwidth, storage). The free discovery hook.
provision_serverโœ… USDCโ€”Provision a VPS (plan, days, optional ssh_key/via, managed_key) โ†’ id, IPv4, SSH. With managed_key:true, a server-side keypair is generated, authorized, and the private key returned once (stored only encrypted) to enable exec_command.
get_serverโ€”โ€”Status, IPv4, expiry, bandwidth, storage for a server id
list_serversโ€”โ€”Fleet for a wallet/account
extend_serverโœ… USDCโ€”Extend a lease by N days
destroy_serverโ€”โœ…Destroy now
reboot_serverโ€”โœ…Soft-reboot an owned server
server_logsโ€”โœ…Hypervisor-level diagnostics without logging in: status, recent provider actions, a VNC console URL, and live CPU/disk/net metrics (no text boot log exists provider-side)
exec_commandโ€”โœ…Run a shell command as root over SSH โ†’ exit_code/stdout/stderr. Requires a server provisioned with managed_key:true. Bounded: 1โ€“120 s timeout, 256 KB output cap.
get_firewallโ€”โ€”Read a box's edge-firewall rules. Callable from the box itself (source-IP identity) or with an account key.
manage_firewallโ€”โ€”Open/close inbound ports on a box's edge firewall (protocol/port/source_ips). From the box itself or with an account key; SSH-lockout guarded.
claim_accountโ€”โ€”Email a one-time claim code (via AWS SES)
verify_claimโ€”โ€”Redeem the code for an account API key. Link a wallet by also passing wallet + wallet_signature.

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.

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.