vpscloudpaymentssshusdc
MCP server enabling autonomous provisioning, management, and payment for Linux VPSes via USDC or card with no signup.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
One-click editor setup isn’t available for this listing yet — we don’t have a confirmed install command, and we’d rather show nothing than point your editor at the wrong package or host. Follow the project’s own setup instructions, linked above.
Manual Client & Custom JSON ConfigExpand JSON ▾
No confirmed setup config for this listing yet. We only publish a config block when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for agentmetal/mcp, and we’d rather show nothing than a guess you’d paste into your client. Follow the project’s own setup instructions for the current steps.
Overview
Use cases
Provision Linux VPS instances programmatically with payment
Run root shell commands remotely via SSH on managed servers
Extend or renew VPS leases automatically
Manage firewall rules on VPS instances
Retrieve server status, logs, and metrics without SSH login
Key features
Discover VPS plans, locations, and pricing
Pay with USDC over x402 protocol or by card
Provision and destroy VPS servers with optional managed SSH keys
Execute root commands remotely with time and output limits
View hypervisor-level server logs and live metrics
Manage edge firewall rules with SSH-lockout protection
Capabilities & Tool Schemas (13)
Inspect callable tools, capabilities, and parameters exposed to AI agents by Agentmetal MCP.
get_catalogList plans, locations, and add-on pricing (bandwidth, storage). The free discovery hook.
provision_serverProvision 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_serverStatus, IPv4, expiry, bandwidth, storage for a server id
list_serversFleet for a wallet/account
extend_serverExtend a lease by N days
destroy_serverDestroy now
Documentation Overview
@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.
Tools
13 tools. Paid tools sign a USDC/x402 payment; account-gated tools need
AGENTMETAL_API_KEY (am_live_…) and ownership of the server.
| Tool | Pays? | 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)
| Var | Default | Purpose |
|---|---|---|
AGENTMETAL_BASE_URL | https://api.agentmetal.dev | API base URL |
WALLET_PRIVATE_KEY | — | 0x… EVM key used to pay 402s. Omit and paid tools fail with a clear message. |
AGENTMETAL_NETWORK | eip155:8453 | CAIP-2 network (Base mainnet) |
AGENTMETAL_MAX_USDC | 50 | Per-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
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:8453kind.
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
GitHub stars
2
Stargazers on the source repository.
Last commit
2mo ago
Most recent push to the default branch.
Tools exposed
13
Callable tools this server registers over MCP.
Directory activity
2 views
Config copies, upvotes, and views on AllMCPs.
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Agentmetal MCP
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/agentmetal-mcp)HTML Embed
<a href="https://allmcps.com/mcp/agentmetal-mcp"><img src="https://allmcps.com/api/badge/agentmetal-mcp?style=directory" alt="Agentmetal MCP on AllMCPs" /></a>