Claude
Spin up, SSH into, run commands on, and tear down your own Linux servers from Claude — pay with USDC over x402 or card, no signup. Use when the user wants to rent a VPS or cloud instance, deploy something, run a command on a real machine, or give an agent its own box.
AgentMetal for Claude
AgentMetal is a server provider an agent can drive end-to-end: browse → pay → provision → SSH in → run commands → manage → renew → destroy. You rent real Linux VMs (VPS / cloud instances) and pay in USDC over x402 — or a card — with no human signup and no API key needed to buy. This is autonomous infrastructure: the agent buys its own compute, then configures and operates the box, not just receives it.
The headline power: with a managed SSH key you can run shell commands as root on the box
(exec_command) — install packages, deploy code, host a service, configure anything —
without bringing your own key.
The recommended integration is the AgentMetal MCP server (@agentmetal/mcp, v0.3.0,
13 tools), which exposes the API as tools and handles the x402 payment signing for you.
Add the MCP server
@agentmetal/mcp is a stdio MCP server (binary: agentmetal-mcp). Add it to your MCP
client config:
{
"mcpServers": {
"agentmetal": {
"command": "node",
"args": ["packages/mcp/src/index.ts"], // or: "npx", ["-y", "@agentmetal/mcp"]
"env": {
"WALLET_PRIVATE_KEY": "0x…", // EVM key with USDC on Base
"AGENTMETAL_MAX_USDC": "50", // per-request spend cap
"AGENTMETAL_API_KEY": "am_live_…" // optional, unlocks reboot/diagnostics/exec/destroy
}
}
}
}
In Claude Code: claude mcp add agentmetal -- node packages/mcp/src/index.ts (then set the
env vars), or add the block above to .mcp.json.
Tools (13)
| Tool | Pays USDC? | Use |
|---|---|---|
get_catalog | — | free browse: plans, locations, add-on pricing — no payment/account |
provision_server | ✅ | { plan: nano|small|medium, days: 1–30, ssh_key?, managed_key? } → id, IPv4, SSH (set managed_key: true to have AgentMetal generate the keypair and return the private key once) |
get_server | — | { id } → status / IPv4 / expiry |
exec_command | — | { id, command } → run a shell command as root on the box, returns stdout/stderr (needs account key + ownership + a managed-key box) |
reboot_server | — | { id } → soft reboot (needs account key) |
server_logs | — | { id } → diagnostics: hypervisor status, console, metrics — no SSH needed (needs account key) |
extend_server | ✅ | { id, days } → renew the lease |
destroy_server | — | { id } → destroy (needs account key) |
claim_account | — | { email } → emails a one-time code |
verify_claim | — | { email, code, wallet?, wallet_signature? } → am_live_… account API key (linking a wallet requires wallet_signature) |
list_servers | — | your fleet (needs account key) |
get_firewall | — | { id } → read edge-firewall rules (from the box itself or with an account key) |
manage_firewall | — | { id, action, protocol, port?, source_ips? } → open/close inbound ports (SSH-lockout guarded) |
Lifecycle, end to end
- Browse free —
get_catalogto see plans, locations, and add-on pricing. No payment, no account. - Provision —
provision_server { plan, days, managed_key: true }. The 402 → pay (USDC or card) → running box with SSH in <60s. Withmanaged_key, you get the private key back once so you can SSH in without bringing your own key. - Run commands / SSH in —
exec_command { id, command }runs anything as root: install packages, deploy code, host a service, configure the box. Pair with an account key (claim by email). - Add storage / bandwidth — block storage at $0.01/GB/day (auto-mounted) and bandwidth at
$2/TB beyond the 20 TB included (raw HTTP:
POST /v1/servers/{id}/storage {gb}and/bandwidth {tb}). - Manage —
reboot_server,server_logs(diagnostics without SSH),list_servers. - Extend / destroy —
extend_serverto renew the lease;destroy_serverto tear it down early.
Guidance
- The wallet must hold USDC on Base (
eip155:8453).AGENTMETAL_MAX_USDChard-caps any single payment; a 402 above the cap is refused before signing. - Plans:
nano$1.20/day,small$2.20/day,medium$4.20/day. Prepaid, no refunds. Add-ons: storage $0.01/GB/day, bandwidth $2/TB beyond 20 TB included. - An account is optional but unlocks reboot, diagnostics, exec (run commands), destroy, and
fleet management:
claim_account→verify_claim(email OTP →am_live_…key). - No wallet configured? The paid tools fail with a clear message; catalog/status/claim still work.
- Prefer raw HTTP? Everything is documented for agents at
https://api.agentmetal.dev/llms.txt; each error envelope's
docsfield links there.
- Downloads
- 543All time
- Security audit
- Review
- Last updated
- 4mo ago
- Current version
- v1.0.1
- License
- MIT-0
