get_catalogLABSCO SUMMARY
Infrastructure an agent can buy and drive by itself.
The whole arc — discover, pay, provision, SSH in, run, extend, destroy — exists as tool calls, with payment signed rather than typed into a checkout form. The bounded exec (timeout and output cap) and the SSH-lockout guard on firewall changes are the parts that make that safe to hand over.
What it is
The MCP server for AgentMetal, which provisions and manages VPS instances. Paid tools sign USDC payments over x402 v2 (card payment is also available); the rest are plain HTTP.
What you get
- The catalogue of plans, locations and add-on pricing for bandwidth and storage, callable before anything is paid for
- A server provisioned for a chosen plan and number of days, returning id, IPv4 and SSH access — with
managed_key:truegenerating and authorizing a keypair and returning the private key once - Shell commands run as root over SSH on a managed-key server, returning exit code, stdout and stderr, bounded by a timeout and an output-size cap
- Fleet visibility and per-server status: IPv4, expiry, bandwidth and storage
- Lease extension by N days, and destruction or soft reboot when you are done or stuck
- Hypervisor-level diagnostics without logging in — status, recent provider actions, a VNC console URL and live CPU, disk and network metrics
- Edge firewall rules read and changed by protocol, port and source IPs, with SSH-lockout guarded
- Account claim by emailed one-time code, redeemed for an API key, optionally linked to a wallet
Requirements
No human signup for discovery or provisioning — paid calls sign a USDC payment over x402. Account-gated tools (destroy, reboot, logs, exec) need an API key in the am_live_… form and ownership of the server. Running commands over SSH requires that the server was provisioned with a managed key.
Setup effort
Build from source — get the source, then follow the project's own run instructions
USE CASES
01
Getting a machine for a job that will not fit locally
Read the catalogue, pick a plan and location, and provision for the number of days you actually need — with a managed key so commands can be run immediately.
02
Running a build or a batch on the rented box
Execute the command as root over SSH and read exit code, stdout and stderr back, inside a bounded timeout and output cap.
03
Working out why a box has gone quiet
Read hypervisor-level diagnostics — status, recent provider actions, live CPU, disk and network — and open the VNC console URL without needing to log in.
04
Opening a port for the service you just deployed
Change the edge firewall by protocol, port and source IPs, with the SSH lockout guard preventing the classic self-inflicted outage.
05
Keeping a machine past its lease
Extend by N days before expiry, or check the fleet to see which leases are about to run out.
06
Shutting down and stopping the spend
Reboot when it is wedged, destroy when the work is done, so a rented box does not quietly outlive its purpose.
13 tools
Listed in project docs. Your client may show a different list.
provision_serverget_serverlist_serversextend_serverdestroy_serverreboot_serverserver_logsexec_commandget_firewallmanage_firewallclaim_accountverify_claimBEFORE YOU INSTALL
What to know first
Tools you get
13 tools named in the project's documentation.
Requires
node on PATH
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
node packages/mcp/src/index.tsMCP Clients
Claude Code
CLAUDE CODE · JSON
{
"mcpServers": {
"agentmetal": {
"command": "node",
"args": [
"packages/mcp/src/index.ts"
],
"env": {
"WALLET_PRIVATE_KEY": "<YOUR_WALLET_PRIVATE_KEY>",
"AGENTMETAL_MAX_USDC": "50"
}
}
}
}
