Roadmap · Planned
Infrastructure your AI agents can buy themselves
We're building a REST API and an MCP server so autonomous agents can quote, order, pay for and manage servers with a crypto wallet, within limits you set. It isn't live yet. This page documents the design so you can plan against it.
REST API
Token-authenticated JSON endpoints to quote, order, renew, reboot and reinstall. Idempotency keys on every write.
MCP server
The same actions exposed as tools for any MCP-capable agent runtime, so a model can provision its own compute.
Wallet billing with guardrails
Agents pay from a prepaid crypto balance. You set per-token spend caps, allowed products and allowed locations.
Planned
Endpoints
Base URL will be https://api.mercurehosting.com. It isn't reachable yet.
| Method | Path | Purpose |
|---|---|---|
| GET | /v1/catalog | List products, plans, locations and list prices |
| POST | /v1/quotes | Price a plan + term + coin without committing |
| POST | /v1/orders | Create an order and receive a crypto invoice |
| GET | /v1/orders/{ref} | Poll invoice and provisioning status |
| GET | /v1/servers | List servers owned by the token |
| POST | /v1/servers/{id}/actions | reboot · power_off · power_on · reinstall · rescue |
| POST | /v1/servers/{id}/renew | Extend the term, paid from balance or new invoice |
| GET | /v1/balance | Prepaid crypto balance and spending limits |
Planned
Example: quote, then order
POST https://api.mercurehosting.com/v1/quotes # PLANNED — not live
Authorization: Bearer mh_live_••••••••
Content-Type: application/json
{
"plan": "IS-L",
"term": "6m",
"coin": "XMR"
}200 OK
{
"plan": "IS-L",
"location": "iceland",
"term": "6m",
"monthly_usd": 34.50,
"effective_monthly_usd": 22.43,
"discount": 0.35,
"total_usd": 134.58,
"coin": "XMR",
"quote_id": "q_7Hk2…",
"expires_at": "2026-11-01T12:00:00Z"
}POST https://api.mercurehosting.com/v1/orders # PLANNED — not live
Authorization: Bearer mh_live_••••••••
Idempotency-Key: 4b1e9c1a-…
{
"quote_id": "q_7Hk2…",
"os": "debian-12",
"ssh_keys": ["ssh-ed25519 AAAA… agent@runner"],
"hostname": "inference-01",
"pay_from": "balance" // or "invoice"
}201 Created
{
"ref": "MH-261031-9F2C1A",
"status": "awaiting_payment", // → paid → provisioning → active
"invoice": {
"coin": "XMR",
"amount": "…", // set by the payment gateway
"address": "…",
"expires_at": "2026-11-01T12:00:00Z"
},
"server": null // populated once active
}Prices in these examples follow today's list prices and term discounts. Field names may change before release.
Planned
MCP server
One server exposing five tools. Agents discover them automatically.
{
"tools": [
{ "name": "mercure_list_plans", "input": { "product": "vps|dedicated|rdp|gpu", "location?": "string" } },
{ "name": "mercure_quote", "input": { "plan": "string", "term": "1m|3m|6m|12m", "coin": "BTC|XMR|…" } },
{ "name": "mercure_create_order", "input": { "quote_id": "string", "os": "string", "ssh_keys": "string[]" } },
{ "name": "mercure_order_status", "input": { "ref": "string" } },
{ "name": "mercure_server_action", "input": { "server_id": "string", "action": "reboot|reinstall|power_off" } }
]
}{
"mcpServers": {
"mercurehosting": {
"command": "npx",
"args": ["-y", "@mercurehosting/mcp"], // PLANNED package name
"env": { "MERCURE_API_TOKEN": "mh_live_…" }
}
}
}Guardrails we're building in
Spend caps
Per-token daily and monthly USD limits.
Scoped tokens
Read-only, order-only or full-control scopes.
Location allow-lists
Restrict an agent to the jurisdictions you approve.
Human-in-the-loop
Optionally require your approval above a set amount.
The Acceptable Use Policy applies to every service
Privacy isn't a licence for abuse. CSAM, malware, phishing, spam, botnets, fraud and any content illegal in the hosting jurisdiction are prohibited, and we suspend services that break these rules. We honor valid court orders issued in the jurisdiction where your server is located. Read the full Terms & Acceptable Use Policy.
Agents are bound by the same Acceptable Use Policy as people, and the token owner is responsible for what their agents run.
Building an agent that needs compute?
Tell us what you're building and we'll add you to the early-access list.