Agentmetal
Let an agent rent, pay for and run commands on its own Linux VPS
- Pricing
- Paid
- Platforms
- CLI, API, Linux
- Runs
- Locally
- Version
- 0.3.5
- Listing updated
- today
Similar MCP servers
About Agentmetal
Agentmetal is a paid MCP server for cloud and infrastructure. It runs locally on your machine and is started by your AI client.
The server's loop is discover, pay, provision, SSH in, run commands, manage and renew, with no human signup. Paid tools sign USDC payments over x402 v2 from an EVM wallet key, with a per-request spend cap defaulting to 50 USDC; a request above the cap is refused before signing. The wallet must hold USDC on Base. The registry description also mentions paying by card.
Provisioning returns a server id, IPv4 address and SSH details. If you ask for a managed key, a keypair is generated server-side and the private key is returned once, enabling a command tool that runs shell commands as root over SSH with a 1 to 120 second timeout and a 256 KB output cap. Destroy, reboot, logs and command execution need an account API key and ownership of the server; an account is claimed through an emailed one-time code.
The README also lists firewall tools that open or close inbound ports with SSH-lockout protection, and add-on storage at $0.01 per GB per day and bandwidth at $2 per TB beyond 20 TB included. It states that unit tests and the stdio handshake are verified, while live USDC settlement needs a funded wallet and a compatible x402 facilitator.
Install
Run in a terminal
claude mcp add agentmetal -- npx -y @agentmetal/mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"agentmetal": {
"command": "npx",
"args": [
"-y",
"@agentmetal/mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"agentmetal": {
"command": "npx",
"args": [
"-y",
"@agentmetal/mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"agentmetal": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@agentmetal/mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"agentmetal": {
"command": "npx",
"args": [
"-y",
"@agentmetal/mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"agentmetal": {
"command": "npx",
"args": [
"-y",
"@agentmetal/mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (13)
Taken from the project documentation; the running server may differ.
- get_catalog
- Lists plans, locations and add-on pricing.
- provision_server
- Provisions a VPS paid in USDC and returns its id, IPv4 and SSH details.
- get_server
- Returns status, IPv4, expiry, bandwidth and storage for a server.
- list_servers
- Lists the fleet for a wallet or account.
- extend_server
- Extends a lease by a number of days, paid in USDC.
- destroy_server
- Destroys a server immediately.
- reboot_server
- Soft-reboots an owned server.
- server_logs
- Returns hypervisor-level diagnostics, a VNC console URL and live metrics.
- exec_command
- Runs a shell command as root over SSH.
- get_firewall
- Reads a server's edge firewall rules.
- manage_firewall
- Opens or closes inbound ports on a server's edge firewall.
- claim_account
- Emails a one-time claim code.
- verify_claim
- Redeems the code for an account API key.
What it does
- Pay-as-you-go servers
- Provisions a VPS and extends the lease in USDC over x402.
- Root command execution
- Runs shell commands over SSH, bounded to 120 seconds and 256 KB of output.
- Spend cap
- A per-request limit, default 50 USDC, refuses larger payments before signing.
- Edge firewall control
- Reads and changes inbound port rules, guarded against SSH lockout.
- Hypervisor diagnostics
- Shows status, recent provider actions, a VNC console URL and live metrics.
- Account claim flow
- Emails a one-time code that is redeemed for an account API key.
Good for
- Have an agent spin up a short-lived Linux box to run a build
- Extend a server's lease by a number of days when a job runs long
- Open a port on a server's firewall from the box itself
- Reboot or destroy a server when a task finishes
Pricing
Paid
Pay per lease in USDC; storage $0.01/GB/day, bandwidth $2/TB beyond 20 TB; plan prices not listed
Agentmetal FAQ
How does it pay?
Paid tools sign USDC payments over x402 v2 with a WALLET_PRIVATE_KEY; the registry description also says card.
Can it limit spending?
Yes. AGENTMETAL_MAX_USDC caps what a single call can pay, defaulting to 50, and larger requests are refused before signing.
Which tools need an API key?
Destroy, reboot, logs and command execution need an AGENTMETAL_API_KEY and ownership of the server.
How many tools are there?
Thirteen, from catalog lookup to account claiming.
Is live payment verified?
The README says live USDC settlement needs a funded wallet and an x402 facilitator that supports the exact kind on Base.
Is Agentmetal free?
No. Agentmetal is a paid product.
How do I add Agentmetal to Claude Code?
Run this command in your terminal: claude mcp add agentmetal -- npx -y @agentmetal/mcp
What are the best alternatives to Agentmetal?
The closest alternatives to Agentmetal are mcp, Webflow, Ripe Stat, Vercel MCP and OpenWrt MCP.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

