Back to Browse

Agentmetal MCP Server

Developer ToolsModerate6.3MCP RegistryLocal
Free

Server data from the Official MCP Registry

Rent a Linux VPS from an AI agent: provision, SSH in, run commands. Pay USDC (x402) or card.

About

Rent a Linux VPS from an AI agent: provision, SSH in, run commands. Pay USDC (x402) or card.

Security Report

6.3
Moderate6.3Moderate Risk

This MCP server is a well-structured client for the AgentMetal API. It requires an account key for sensitive operations, caps each x402 payment per request, and its permissions match its purpose. The main concerns are that the per-request spend cap does not limit cumulative spending, and that sensitive credentials returned by tools (a one-time SSH private key and an account API key) enter the LLM conversation context. Supply chain analysis found 1 known vulnerability in dependencies (0 critical, 1 high severity). Package verification found 1 issue.

6 files analyzed · 9 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

Shell Command Execution

Runs commands on your machine. Be cautious — only use if you trust this plugin.

payment_transaction

Check that this permission is expected for this type of plugin.

How to Install

Add this to your MCP configuration file:

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

Documentation

View on GitHub

From the project's GitHub README.

@agentmetal/mcp

MCP server that exposes AgentMetal as tools, so an agent can discover → pay → provision → SSH in → run commands → manage → renew its own Linux server (VPS / cloud instance) with no human signup. Paid tools sign USDC payments over x402 v2 (or pay by card); the rest are plain HTTP.

agentmetal/mcp MCP server CI smithery badge

Tools

13 tools. Paid tools sign a USDC/x402 payment; account-gated tools need AGENTMETAL_API_KEY (am_live_…) and ownership of the server.

ToolPays?Account key?What it does
get_catalog——List plans, locations, and add-on pricing (bandwidth, storage). The free discovery hook.
provision_server✅ USDC—Provision a VPS (plan, days, optional ssh_key/via, managed_key) → id, IPv4, SSH. With managed_key:true, a server-side keypair is generated, authorized, and the private key returned once (stored only encrypted) to enable exec_command.
get_server——Status, IPv4, expiry, bandwidth, storage for a server id
list_servers——Fleet for a wallet/account
extend_server✅ USDC—Extend a lease by N days
destroy_server—✅Destroy now
reboot_server—✅Soft-reboot an owned server
server_logs—✅Hypervisor-level diagnostics without logging in: status, recent provider actions, a VNC console URL, and live CPU/disk/net metrics (no text boot log exists provider-side)
exec_command—✅Run a shell command as root over SSH → exit_code/stdout/stderr. Requires a server provisioned with managed_key:true. Bounded: 1–120 s timeout, 256 KB output cap.
get_firewall——Read a box's edge-firewall rules. Callable from the box itself (source-IP identity) or with an account key.
manage_firewall——Open/close inbound ports on a box's edge firewall (protocol/port/source_ips). From the box itself or with an account key; SSH-lockout guarded.
claim_account——Email a one-time claim code (via AWS SES)
verify_claim——Redeem the code for an account API key. Link a wallet by also passing wallet + wallet_signature.

Add-ons (currently API endpoints, not yet separate MCP tools): extra storage ($0.01/GB/day, attached block volume) via POST /v1/servers/{id}/storage and extra bandwidth ($2/TB beyond the 20 TB included) via POST /v1/servers/{id}/bandwidth.

Configuration (env)

VarDefaultPurpose
AGENTMETAL_BASE_URLhttps://api.agentmetal.devAPI base URL
WALLET_PRIVATE_KEY—0x… EVM key used to pay 402s. Omit and paid tools fail with a clear message.
AGENTMETAL_NETWORKeip155:8453CAIP-2 network (Base mainnet)
AGENTMETAL_MAX_USDC50Per-request spend cap, in USDC
AGENTMETAL_API_KEY—am_live_… account key, required for destroy_server / reboot_server / server_logs / exec_command

Use with Claude Code

// .mcp.json (or claude mcp add)
{
  "mcpServers": {
    "agentmetal": {
      "command": "node",
      "args": ["packages/mcp/src/index.ts"],
      "env": {
        "WALLET_PRIVATE_KEY": "0x…",
        "AGENTMETAL_MAX_USDC": "50"
      }
    }
  }
}

The wallet must hold USDC on Base. The spend cap (AGENTMETAL_MAX_USDC) bounds what any single tool call can pay; a 402 above the cap is refused before signing.

Status: client + server are unit-tested and the stdio handshake is verified. Live USDC settlement needs a funded wallet + an x402 facilitator that supports the exact / eip155:8453 kind.

Reviews

No reviews yet

Be the first to review this server!