Agentmetal
@agentmetal
Provision, SSH into, run commands on, and manage Linux VPSes from an AI agent. Pay USDC over x402 (Base) or by card over HTTP 402, with a running box in under 60 seconds. No signup, no API key to buy. Includes get_catalog, provision_server, get_server, list_servers, extend_server
Overview
What is Agentmetal?
Agentmetal is an MCP server that exposes the AgentMetal platform as tools, enabling an AI agent to discover, pay for, provision, SSH into, run commands on, manage, and renew its own Linux server (VPS or cloud instance) without any human signup. Paid tools settle payments in USDC via the x402 v2 protocol (or by card); all other tools use plain HTTP.
How to use Agentmetal?
Configure the server in your MCP client (e.g., Claude Code) by adding a mcpServers entry with the command node packages/mcp/src/index.ts. Set the environment variable WALLET_PRIVATE_KEY to an EVM private key holding USDC on Base mainnet, and optionally set AGENTMETAL_MAX_USDC to cap per-request spend. Paid tools require a funded wallet; account‑gated tools require AGENTMETAL_API_KEY.
Key features of Agentmetal
- 13 tools covering the full server lifecycle.
- Paid tools sign USDC/x402 payments; free tools use plain HTTP.
- Provision a VPS with optional managed SSH key for command execution.
- Run shell commands as root via
exec_command(requires managed key). - Read and manage edge firewall rules from the server or with an account key.
- Claim an account via email and link a wallet for extended capabilities.
- Bounded spend cap: per‑request limit configurable via
AGENTMETAL_MAX_USDC.
Use cases of Agentmetal
- An agent autonomously provisions a Linux server to deploy a web application.
- The agent extends the server lease when more runtime is needed.
- The agent runs diagnostics and reboots the server without human interaction.
- The agent opens firewall ports to expose a service, then closes them after use.
- A developer integrates server lifecycle management into an automated workflow.
FAQ from Agentmetal
How do payments work on Agentmetal?
Paid tools (e.g., provision_server, extend_server) require a USDC payment signed over the x402 v2 protocol. The wallet specified by WALLET_PRIVATE_KEY must hold USDC on Base mainnet. Card payment is also supported.
What is the spend cap?
AGENTMETAL_MAX_USDC (default: 50) sets the maximum USDC a single tool call can pay. A 402 payment request above this cap is refused before signing.
How do I get an account API key?
Use claim_account to email a one‑time claim code. Then call verify_claim with that code to receive an am_live_… API key. Optionally, pass a wallet and wallet_signature to link a wallet.
What does exec_command require?
The server must have been provisioned with managed_key:true. The command runs as root over SSH with a 1–120 second timeout and a 256 KB output cap.
Which tools require an API key?
destroy_server, reboot_server, server_logs, and exec_command require AGENTMETAL_API_KEY and ownership of the server.
