Skip to content
MCP server

Agentmetal

Let an agent rent, pay for and run commands on its own Linux VPS

Runs locallyStatus and history
Install
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/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "agentmetal": {
      "command": "npx",
      "args": [
        "-y",
        "@agentmetal/mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "agentmetal": {
      "command": "npx",
      "args": [
        "-y",
        "@agentmetal/mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers