llms.txt Content
# AgentMetal — llms.txt
# The infra provider you can use end-to-end. No signup: paying IS the signup.
# Pay with USDC on Base (x402) or a card — any plan, either rail, no account.
# VMs starting at $1.20/day, with add-on block storage ($0.01/GB/day) and
# bandwidth ($2/TB). Coming soon: Agent Memory (a native-Markdown,
# ultra-low-cost persistence layer for what you learn).
# Status: Phase-1 live — catalog/provision/status/list/extend/destroy/claim,
# plus add-on storage/bandwidth and operate (reboot/diagnostics/exec) implemented.
BASE_URL: https://api.agentmetal.dev
FULL: https://agentmetal.dev/llms-full.txt # expanded manual (full endpoint + payment + MCP reference)
## Discover for free (no payment, no account)
GET /v1/catalog -> plans (specs + per-day price), locations, selectable OS
images, and add-on pricing (storage $/GB/day, bandwidth $/TB). Quote before you
commit a payment.
## Provision a server (the whole product)
1) Request without payment:
POST /v1/servers
{"plan": "nano", "days": 7}
Optional "os": pick an image, e.g. "debian-12" (default "ubuntu-24.04").
GET /v1/catalog -> images for the list. Other fields: ssh_key, managed_key,
via, code (coupon).
-> 402 Payment Required listing ALL payment options:
accepts[]: x402 — exact USDC amount (atomic, 6dp), asset (USDC on Base),
payTo address, terms in `description`.
card: Stripe card rail — { checkout_url, session_id, poll, note }.
2a) USDC path (x402 v2, synchronous — best for autonomous agents): sign the
accepts[0] requirement (EIP-3009 transferWithAuthorization, USDC on Base),
base64-encode the payment payload, retry the identical request with:
X-PAYMENT: <base64 payload>
Idempotency-Key: <uuid> # replays return the original response
-> 201 {id, status, plan, ipv4, ssh:"root@<ip>", expires_at, renew}
NOTE: x402 is a SIGNED authorization in this header, not a transfer — do NOT
send USDC manually to pa
OpenAPI Spec (preview)
{
"openapi": "3.1.0",
"info": {
"title": "AgentMetal API",
"version": "0.3.2",
"description": "AgentMetal is the server provider an agent can drive end-to-end: discover, pay, provision, SSH in, run commands, manage, renew, and destroy. Pay per day in USDC over x402 (EIP-3009 on Base) or by card over HTTP 402, with no human signup and no API key required to buy. VMs from $1.20/day; 20 TB/mo egress included; block-storage add-on."
},
"servers": [
{
"url": "https://api