Home / API per Agentes
Hosting VPS per agentes IA · MCP · REST · x402

Compra un VPS o server dedicato con il tuo agente di IA — pagamento in crypto, senza KYC.

ServPrivate è progettato perché gli agenti AI possano acquistare, distribuire e gestire server end-to-end senza un umano nel loop. Tre percorsi di integrazione, un solo dominio, zero KYC, 8 criptovalute tra cui Monero. Compatibile con Claude (Desktop / Code / Managed Agents), OpenClaw, ChatGPT, Cursor, Continue, Cline, n8n e qualsiasi client HTTP personalizzato.

Claude Desktop Claude Code ChatGPT Cursor Continue OpenClaw curl
Senza KYC
Server MCP
REST + OpenAPI
x402-light
8 criptovalute
Modalità test

Tres percorsos di integrazione, un solo dominio

Scegli quello che si adatta al tuo stack. Tutti puntano allo stesso backend, agli stessi account, alla stessa logica /api/v1/*.

MCP

MCP — per Claude, Cursor, Continue, Cline

Aggiungi https://servprivate.com/mcp alla tua configurazione MCP. Otto strumenti disponibili all'istante: list_plans, list_locations, quote, create_order, payment_status, server_credentials, server_action, agent_help.

REST

REST — per qualsiasi cliente HTTP

Endpoint JSON semplici sotto /api/v1/. Autenticazione Bearer (emessa automaticamente al primo ordine, nessuna registrazione). Specifica OpenAPI 3.1 su /openapi.json. Funziona con curl, Python, Go e qualsiasi cosa che parli HTTP.

x402-light

x402-light — USDC istantaneo

Per agenti con un proprio wallet. Invia X-Payment-Mode: x402 a POST /api/v1/topup → 402 con il blocco accepts x402 (scheme "exact", USDC su Base). Regola il pagamento ritentando con l'header X-Payment firmato.

Quattro linee di prodotto, un solo endpoint /api/v1/orders

Passa `type=vps` / `dedicated` / `rdp` / `gpu` per cambiare linea di prodotto. Stessa autenticazione Bearer, stesso checkout crypto, stessi endpoint di stato. Le località sono limitate per prodotto — l'API rifiuta `type=gpu` in `russia` (controlli sull'export NVIDIA) e `type=rdp` in `iceland` / `panama` / `switzerland`.

Linea di prodottotypeLocalità disponibiliDaCaso d'uso tipico dell'agente
Linux VPS vps 7 (IS · PA · MD · RO · CH · NL · RU) $7.50/mo Servizi Linux (Tor, VPN, mail, bot di scraping, web app).
Dedicated Server dedicated 7 (IS · PA · MD · RO · CH · NL · RU) $48.50/mo Isolamento bare-metal (grandi database, carichi dual-socket, hypervisor).
Windows RDP rdp 4 (NL · RO · MD · RU) $11.00/mo Automazione browser, SMM multi-account, Forex / MetaTrader, app solo per Windows.
GPU AI Hosting Nuevo gpu 4 (IS · NL · RO · MD) $122.00/mo Finetuning di LLM, generazione di immagini / video, inferenza di modelli dietro la tua API.
Anonymous Domain Names Nuevo domain 26 TLDs (.com .net .org .io .me .ai .app .dev .fr .de …) $4.99/yr One-call live availability + Namecheap-beating prices. Buy via balance; deep-link to /domain-order on the site.

GET /api/v1/catalog restituisce la matrice SKU in tempo reale (prezzi per località, opzioni OS, modello GPU, VRAM). Il catalogo è aperto e cacheable per 5 minuti — nessuna autenticazione richiesta.

Come funziona — 4 chiamatas del descubrimiento a le credenziali

Nessun SDK da installare. Nessuna danza OAuth. Nessuna email. La prima chiamata restituisce il token del tuo account; le tre successive portano l'ordine da pending ad active.

1Descopre quale ci sono disponibile

Lee il catálogo e la lista di giurisdizioni. Entrambi endpoints sono aperte (senza autenticazione) e se possono cachear durante 5 minuti.

2Crea il ordine

Invia un POST con la tua scelta. La risposta contiene un nuovo indirizzo di pagamento per ogni ordine, l'importo esatto in crypto, una scadenza e — se non hai inviato un Bearer — un account_token nuovo. CONSERVA IL TOKEN: è l'unico modo per gestire il server in seguito. Non disponiamo di alcun meccanismo di recupero.

3Paga e consulta lo stato

Invia la crypto all'indirizzo indicato. Poi interroga l'ordine finché lo stato diventa "active"; di norma servono 1-5 minuti per un VPS dopo il rilevamento del deposito.

4Ricevi le credenziali

Quando l'ordine è attivo, recupera i dati del server. Vengono restituiti l'indirizzo IP, la password di root, la porta SSH e l'URL della console. Collegati in SSH e hai finito.

curl — balance-only two-step: topup, then deploy
# Step 1: fund USD balance with crypto (min $30, max $2000; bonus credit applied on confirmation)
curl -X POST https://servprivate.com/api/v1/topup \
  -H 'Content-Type: application/json' \
  -d '{ "amount": 200, "crypto": "XMR" }'

# → 201 Created
{
  "ok": true,
  "payment_id": 12345,
  "amount_usd": 200,
  "crypto": "XMR",
  "amount_crypto": "1.2034",
  "address": "47abc...",
  "bonus_usd": 50,            // free credit on confirmation
  "credited_usd": 250,         // 200 + 50 bonus
  "expires_in": 3600,
  "poll_url": "https://servprivate.com/api/v1/topup/12345",
  "account_token": "AAAA-BBBB-CCCC-DDDD"    // STORE THIS
}

# (send the crypto, poll poll_url until status="confirmed")

# Step 2: deploy the server from the funded balance
curl -X POST https://servprivate.com/api/v1/orders \
  -H 'Authorization: Bearer AAAA-BBBB-CCCC-DDDD' \
  -H 'Content-Type: application/json' \
  -d '{ "type": "vps", "plan": "IS-S", "location": "iceland", "os": "ubuntu-24", "billing": 3 }'

# → 201 Created
{
  "ok": true,
  "server_id": 9876,
  "status": "active",            // active immediately
  "charged_usd": 16.88,
  "new_balance": 233.12,
  "credentials_url": "https://servprivate.com/api/v1/servers/9876"
}

Un endpoint, cuatro lineas di producto — esempios pronti per copiare

curl — POST /api/v1/orders per ogni prodotto
# All examples assume the agent already topped up via POST /api/v1/topup and the Bearer token is set.

# Linux VPS — Iceland, Ubuntu 24, 3-month billing
POST /api/v1/orders {"type":"vps", "plan":"IS-S", "location":"iceland", "os":"ubuntu-24", "billing":3}

# Dedicated bare-metal — Switzerland, AlmaLinux, annual
POST /api/v1/orders {"type":"dedicated", "plan":"CH-3", "location":"switzerland", "os":"alma-9", "billing":12}

# Windows RDP — Netherlands, Win Server 2022, monthly
POST /api/v1/orders {"type":"rdp", "plan":"NL-M", "location":"netherlands", "os":"win-2022", "billing":1}

# GPU AI — H100 SXM5 with vLLM + Llama 3.3 70B pre-downloaded + HF token + SSH key + auto-shutdown after 24h
POST /api/v1/orders {
  "type":"gpu", "plan":"IS-L", "location":"iceland",
  "os":"ubuntu-22-cuda", "billing":1,
  "ai_stacks": ["vllm", "jupyterlab"],
  "pretrained_models": ["llama-3.3-70b", "flux-dev"],
  "hf_token": "hf_...",                     // optional — needed for Llama / Mistral (gated)
  "ssh_public_key": "ssh-ed25519 AAAA...",    // optional — password-less login
  "public_endpoint": true,                  // auto Let's Encrypt + nginx reverse proxy on 443
  "auto_shutdown_hours": 24                   // destroy after 24h to bound cost
}

# GPU AI image-gen — Netherlands, RTX 5090 (32 GB GDDR7), ComfyUI + FLUX.1-dev preinstalled, 3-month billing
POST /api/v1/orders {
  "type":"gpu", "plan":"NL-M", "location":"netherlands",
  "os":"ubuntu-22-cuda", "billing":3,
  "ai_stacks": ["comfyui", "kohya-ss"],
  "pretrained_models": ["flux-dev", "sdxl-base"]
}

# If the balance is short, /orders returns 402 with a topup_required block:
{
  "ok": false, "error": "insufficient_balance",
  "have_usd": 0, "need_usd": 53.5, "deficit_usd": 53.5,
  "topup_required": true,
  "topup": {
    "endpoint": "https://servprivate.com/api/v1/topup",
    "suggested_usd": 54, "suggested_bonus": 0,
    "minimum_usd": 30, "maximum_usd": 2000,
    "bonus_doc": "https://servprivate.com/api/v1/topup/bonus"
  }
}
# → POST /api/v1/topup {"amount": 54, "crypto": "XMR"} → wait for confirm → retry POST /api/v1/orders

# Anonymous domain check — 26 TLDs in one unauthenticated GET, no token required, JSON out, 1h Redis cache
GET /api/v1/domains/check?q=mybrand

# Tip: typing a TLD surfaces it FIRST. "mybrand.fr" returns .fr at index 0, then the rest.
GET /api/v1/domains/check?q=mybrand.fr

# Response (truncated): live availability + Namecheap-beating prices + featured/badge labels
# {"ok":true, "results":[
#   {"domain":"mybrand.com", "available":true, "price_usd":4.99,  "market_usd":15.98, "discount_pct":69, "badge":"BEST DEAL", "featured":true},
#   {"domain":"mybrand.io",  "available":true, "price_usd":24.99, "market_usd":46.98, "discount_pct":47, "badge":"HOT"},
#   {"domain":"mybrand.ai",  "available":true, "price_usd":84.99, "market_usd":109.98,"discount_pct":23, "badge":"HOT"} ...]}

Configurazione MCP (60 secondi)

Aggiungi questo snippet al tuo client compatibile con MCP (Claude Desktop, Claude Code, Cursor, Continue, Cline). Dopo il riavvio, chiedi: "Comprami un VPS-S in Islanda con Ubuntu 24.04, pagato in XMR".

~/.claude/mcp_settings.json — Cursor / Continue / Cline equivalent
{
  "mcpServers": {
    "servprivate": {
      "url": "https://servprivate.com/mcp"
    }
  }
}

Strumenti esposti dal server MCP:

list_plans
list_locations
quote
topup_bonus
topup_create
payment_status
account_balance
create_order
server_credentials
server_action
agent_help
domain_check
domain_quote

Poi chiama agent_help() dentro Claude: restituisce la ricetta canonica in 4 chiamate con esempi, integrata nello strumento.

x402-light — un solo viaje di ida e vuelta con USDC

Invia l'header X-Payment-Mode: x402 a POST /api/v1/topup. Il server risponde HTTP 402 con un blocco accepts x402 (scheme "exact", USDC su Base, EIP-3009 transferWithAuthorization). Firma l'autorizzazione per l'importo indicato, ritenta la stessa richiesta con l'header X-Payment — il deposito viene regolato e accredita il tuo saldo. Poi ordina qualsiasi server via /api/v1/orders.

x402-light — single round trip with USDT
# With balance-only orders, /api/v1/orders returns 402 insufficient_balance
# when balance is short — the response includes a topup_required block.
# Fund USDT directly via:
curl -X POST https://servprivate.com/api/v1/topup \
  -H 'Content-Type: application/json' \
  -d '{"amount":100,"crypto":"USDT"}'

# → 201 returns {payment_id, address, amount_crypto, bonus_usd: 25,
#               credited_usd: 125, poll_url, account_token}.
# Send USDT (ERC-20) to address, poll poll_url until status="confirmed",
# then POST /api/v1/orders with Bearer to deploy from the funded balance.

Modalità test (dry-run) — non spendere mai crypto reale durante l'integrazione

Aggiungi ?dry_run=1 (oppure l'header X-Dry-Run: 1, o il campo del corpo dry_run: true) a qualsiasi endpoint /api/v1/*. L'ordine sintetico si conferma automaticamente dopo circa 60 secondi, restituisce IP RFC 5737 e non tocca mai una riga reale del database né alcun processore di pagamento upstream. Ideale per validare l'integrazione di un agente prima di toccare la mainnet.

dry-run — never spend real crypto
# nessuna crypto reale spesa, nessun server reale provisionato
curl -X POST 'https://servprivate.com/api/v1/orders?dry_run=1' \
  -H 'Content-Type: application/json' \
  -d '{"type":"vps","plan":"IS-S","location":"iceland","billing":1}'

# For a topup preview:
curl -X POST 'https://servprivate.com/api/v1/topup?dry_run=1' \
  -H 'Content-Type: application/json' \
  -d '{"amount":200,"crypto":"XMR"}'

Casos di uso — lo che fan i agentes con ServPrivate

Questi sono i pattern che vediamo (e per cui progettiamo) oggi nell'infrastruttura agentica.

Levantar un VPS scraper in 30 secondi

Un agente di ricerca ha bisogno di un IP pulito in una giurisdizione specifica. Chiama create_order, ottiene le credenziali, esegue il job e poi termina.

Filiera di calcolo di proprietà dell'agente

Un agente autonomo di lunga durata (Claude Managed Agent, orchestratore personalizzato) provisiona la propria infrastruttura man mano che scala orizzontalmente — nessun gatekeeper umano.

Calcolo proprio (BYO) per carichi di lavoro sensibili

Un utente attento alla privacy chiede a Claude di ospitare un LLM, un relay Tor, un nodo Monero o una VPN self-hosted — pagamento, distribuzione e consegna della chiave SSH avvengono interamente lato agente.

Infrastruttura usa e getta per la ricerca sulla sicurezza

Strumenti di penetration testing, sandbox per malware, exit node — tutto ciò che trae vantaggio dall'essere effimero e non attribuibile. Gli agenti creano, usano e distruggono.

GPU sotto causa per finetuning e inferenza di LLM

Gli agenti avviano un H100 SXM5 (80 GB HBM3) con PyTorch / CUDA preinstallati in 60 secondi, eseguono un job di finetuning, distribuiscono il modello dietro il proprio endpoint vLLM, poi distruggono la macchina. Fatturazione mensile prevedibile, banda illimitata, nessuna commissione per token.

Distribuzione multi-regione e multi-prodotto da un solo prompt

Un singolo loop di agente distribuisce un VPS Linux in Islanda (control plane), un RDP Windows nei Paesi Bassi (worker di automazione browser) e una GPU H100 in Islanda (inferenza). Stesso token, stessa API, stesso checkout.

Perché ServPrivate funziona per agentes

Sei caratteristiche che rendono ServPrivate particolarmente adatto agli acquisti autonomi e assistiti.

Zero KYC

Niente nome, email, telefono, documento o captcha. L'agente paga e ottiene il server — tutto qui.

Distribuzione instantáneo

VPS attivo in meno di 5 minuti. Dedicato in genere in 15–60 minuti. Nessuna coda, nessuna approvazione umana.

8 crypto

BTC, XMR, ETH, USDT, USDTTRC, SOL, LTC, TRX. La stessa API per tutte.

7 giurisdizioni

Islanda, Panama, Moldavia, Romania, Svizzera, Paesi Bassi, Russia. Filtra per località.

Modalità test

Valida la tua integrazione end-to-end senza spendere. dry_run=1 su ogni endpoint.

Dos flussi, una sola API

Lo stesso endpoint serve sia Claude con un umano che paga, sia l'agente completamente autonomo con il proprio wallet.

Descopre la API con un solo curl

Oppure apri https://servprivate.com/openapi.json per la specifica OpenAPI 3.1 completa.

FAQ

Domande frequenti tuo la integrazione di ServPrivate con agentes di IA.

Quale asistentes di IA possono usare questo?

Qualsiasi client compatibile con MCP: Claude Desktop, Claude Code, Cursor, Continue, Cline e qualunque client che implementi il Model Context Protocol. Per gli agenti senza supporto MCP (OpenClaw, plugin di ChatGPT, script Python personalizzati, workflow n8n, Anthropic Managed Agents), la stessa funzionalità è disponibile tramite semplici chiamate HTTPS a /api/v1/* — esattamente lo stesso backend, la stessa autenticazione, lo stesso flusso.

Necesito una account prima di effettuare il primo ordine?

No. Fai una POST a /api/v1/orders senza alcun header Authorization e la risposta includerà un account_token nuovo (stringa di 16 caratteri nel formato AAAA-BBBB-CCCC-DDDD). Conservalo. Quel token è l'unico modo per gestire il tuo server in seguito — non abbiamo email, né percorso di recupero, né altro.

x402-light è compatibile con il client x402 ufficiale di Coinbase?

Parzialmente. Etichettiamo le nostre risposte 402 con x402_light: true e facilitator: null. Un client x402 conforme alle specifiche dovrebbe rilevare facilitator: null e ripiegare su un trasferimento USDC standard (che accettiamo normalmente) oppure fallire in modo elegante. Accettiamo qualsiasi trasferimento USDC ERC-20 all'indirizzo destinatario restituito nel 402 — non c'è alcun requisito di firma EIP-3009. Aggiungeremo un vero facilitatore Coinbase x402 la prima volta che un client reale lo richiederà.

Come hago tests senza spendere crypto reale?

Aggiungi ?dry_run=1 a qualsiasi URL /api/v1/* (oppure l'header X-Dry-Run: 1, o il campo del corpo dry_run: true). Riceverai un order_id sintetico che inizia con "DRY-", un indirizzo di pagamento fittizio, credenziali fittizie (IP RFC 5737), e l'ordine avanzerà automaticamente da pending a confirmed ad active in circa 60 secondi. Nessuna chiamata al processore di pagamento upstream, nessuna riga reale nella tabella pagamenti, nessun server reale provisionato. Gli strumenti MCP accettano lo stesso argomento dry_run.