# Agentmetal

> Agentmetal is a paid MCP server for cloud and infrastructure. Let an agent rent, pay for and run commands on its own Linux VPS. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** CLI, API, Linux
- **Repository:** https://github.com/agentmetal/mcp
- **MCP Registry name:** dev.agentmetal/agentmetal
- **Categories:** [cloud and infrastructure](https://ai-powered.com/categories/cloud-and-infrastructure)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add agentmetal -- npx -y @agentmetal/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "agentmetal": {
      "command": "npx",
      "args": [
        "-y",
        "@agentmetal/mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "agentmetal": {
      "command": "npx",
      "args": [
        "-y",
        "@agentmetal/mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "agentmetal": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@agentmetal/mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "agentmetal": {
      "command": "npx",
      "args": [
        "-y",
        "@agentmetal/mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "agentmetal": {
      "command": "npx",
      "args": [
        "-y",
        "@agentmetal/mcp"
      ]
    }
  }
}
```

## Tools

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

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

## Alternatives

- [mcp](https://ai-powered.com/mcp/mcp-mwfu4c84): mcp is an open-source MCP server for cloud and infrastructure.
- [Webflow](https://ai-powered.com/mcp/webflow): Webflow is a freemium MCP server for cloud and infrastructure.
- [Ripe Stat](https://ai-powered.com/mcp/ripe-stat): Ripe Stat is a freemium MCP server for cloud and infrastructure.
- [Vercel MCP](https://ai-powered.com/mcp/vercel-mcp): Vercel MCP is an MCP server for cloud and infrastructure.
- [OpenWrt MCP](https://ai-powered.com/mcp/openwrt-mcp): OpenWrt MCP is an open-source MCP server for cloud and infrastructure.
- [Opendatasoft](https://ai-powered.com/mcp/opendatasoft): Opendatasoft is a freemium MCP server for cloud and infrastructure.
- [Nist Beacon](https://ai-powered.com/mcp/nist-beacon): Nist Beacon is a freemium MCP server for cloud and infrastructure.
- [Gateway SSH](https://ai-powered.com/mcp/gateway-ssh): Gateway SSH is a freemium MCP server for cloud and infrastructure.

---
Source: https://ai-powered.com/mcp/agentmetal
