De EQVPS MCP-server (versie 1.9.1) heeft 47 tools voor een klanttoken. Deze pagina behandelt de 23 die een VPS huren en beheren: elke parameter, het type en de standaardwaarde, en aan het eind een reeks aanroepen die je kunt kopiëren. Endpoint: https://mcp.eqvps.com/mcp (Streamable HTTP). Nieuw? Begin met de koppelgids.
Laatst gecontroleerd op 2026-10-20 op MCP-server 1.9.1 (tools/list).
Welke pagina heb je nodig? Parameters voor VPS-aanroepen staan op deze pagina. Alle tools in één lijst, inclusief delegatie, support, sandboxes en de 30 resellertools, vind je in de volledige lijst. Wat een gelekt token kan en hoe je een agent beperkt, staat in MCP guardrails.
Authenticatie. list_plans, get_order_limits, register_account en login zijn openbaar. Al het andere vraagt Authorization: Bearer <token>. Binnen één MCP-sessie wordt het token onthouden na register_account of login.
service_id is de servicecode uit order_vps of list_vps, bijvoorbeeld 68J67T5. Een numerieke id werkt ook.
Account en token
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
list_plans | public | — | Plannen met prijzen, specificaties en de OS-images die elk plan opstart. plans[] bevat de maandelijkse en jaarlijkse plan_id. Als eerste aanroepen. |
register_account | public | first_name, last_name, email, token_ttl_days? (1–1825, standaard 365) | Maakt een account zonder wachtwoord en geeft een herbruikbaar Bearer-token met token_expires_at terug. Eén keer aanroepen: een tweede aanroep maakt een tweede, leeg account. |
login | public | email, password, token_ttl_days? | Geeft een nieuw token terug. Werkt pas na set_password. |
refresh_token | Bearer | expires_in_days? (1–1825) | Geeft een nieuw token uit en trekt het huidige direct in. Een verlopen token kun je niet vernieuwen. |
set_password | Bearer | password (8+ tekens, letters en cijfers) | Zet login met e-mail en wachtwoord aan als reserve als het token kwijt is. Werkt één keer; een tweede aanroep geeft 409. |
whoami | Bearer | — | Account-id, naam en e-mail. Handig om het token te controleren. |
Saldo en bestellen
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
get_balance | Bearer | — | Prepaid saldo en valuta. order_vps betaalt daaruit. |
topup_balance | Bearer | amount (USD) | Maakt een crypto-opwaardering en geeft een checkout_url terug. Het saldo wordt bijgeschreven zodra de betaling on-chain bevestigd is. Maar één onbetaalde opwaardering tegelijk. |
order_vps | Bearer | product, os_id, hostname?, ssh_key?, period? (month | year), plan_id?, location? (de | fi), quantity? (1–50), addons? (backups | extra_ipv4), idempotency_key? | Bestelt een VPS en betaalt uit het saldo als dat genoeg is; anders komt er een factuur. Zonder location kiezen wij. Windows-pakketten negeren ssh_key. Met quantity 2–50 krijg je één factuur en evenveel losse servers; stuur bij een nieuwe poging dezelfde idempotency_key. |
get_order_limits | public | product, period?, plan_id?, location?, addons? | Het maximum per bestelling (max_quantity = 50, bescherming tegen typefouten) en welke extra's beschikbaar zijn, met prijzen. |
pay_invoice | Bearer | invoice_id | Geeft een checkout_url voor een openstaande factuur. De VPS wordt aangemaakt zodra die betaald is. |
Een VPS beheren
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
list_vps | Bearer | — | Actieve, in aanmaak zijnde en geschorste services. Verwijderde staan er niet in. |
get_vps_status | Bearer | service_id | Status, specificaties, live toestand en toegang: host, poort en een kant-en-klaar command (SSH voor Linux, RDP voor Windows). reveal_password geeft na het opstarten het eenmalige root-wachtwoord; password_pending: true betekent: roep over 30–60 s opnieuw aan. |
reveal_password | Bearer | service_id | Rootwachtwoord van een VPS zonder SSH-sleutel, één keer getoond. Zolang de server opstart: password_pending: true, roep na 30–60 s opnieuw aan. |
power_vps | Bearer | service_id, action (start | stop | reboot) | Stroombeheer. |
set_hostname | Bearer | service_id, hostname | Wordt in de draaiende server toegepast via de guest agent. Op Windows werkt het na een herstart (reboot_required: true). Staat de server uit, dan komt 409 agent_unavailable terug. |
get_vps_metrics | Bearer | service_id, timeframe? (hour | day | week | month, standaard hour) | CPU, geheugen, netwerk en schijf door de tijd. |
Planwijziging en opzeggen
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
get_upgrade_options | Bearer | service_id | Pakketten waarnaar deze VPS kan overstappen met behoud van data: een groter pakket, NAT naar eigen IPv4 of eigen IP naar NAT. Elke optie toont prorated_topup, mode en capacity_now. Een schijf kan niet kleiner. |
change_plan | Bearer | service_id, target_plan (product_id), confirm: true | Wisselt het pakket ter plekke met één herstart van ongeveer een minuut. Het naar rato verschil gaat van het saldo af (402 als dat te laag is). |
cancel_service | Bearer | service_id, reason (3–500 tekens, verplicht), type? (end_of_period | immediate), confirm? | Standaard end_of_period: de server draait tot het eind van de betaalde periode en wordt niet verlengd. immediate vernietigt de server meteen, vraagt confirm met de exacte hostnaam; het antwoord bevat het veld refund_amount. |
undo_cancel | Bearer | service_id | Haalt een geplande opzegging end_of_period weg. Een directe opzegging is niet terug te draaien. |
Destructief: deze vragen confirm
confirm is de exacte hostnaam uit get_vps_status, of DELETE. Vraag het eerst aan de mens.
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
reset_password | Bearer | service_id, confirm | Een nieuw root-wachtwoord staat binnen 10–30 s op de draaiende server en het oude werkt niet meer. Lees het nieuwe één keer met reveal_password. Voor een kwijtgeraakt wachtwoord, niet voor een server die nog opstart. |
reinstall_vps | Bearer | service_id, os_id, confirm | Wist de schijf en installeert os_id. Alle data gaat verloren. Loopt op de achtergrond; vraag get_vps_status op. |
Voorbeeld: van nul tot een draaiende server
list_plans() // pick a product slug and an os_id
register_account({ first_name: "Ada", last_name: "Agent", email: "you@yourdomain.com" }) // returns a token
topup_balance({ amount: 10 }) // pay the checkout_url in crypto
order_vps({ product: "nano", os_id: <os_id>, ssh_key: "ssh-ed25519 AAAA..." }) // returns a service_id
get_vps_status({ service_id: "<service_id>" }) // poll until active, then read access.command
power_vps({ service_id: "<service_id>", action: "reboot" })
cancel_service({ service_id: "<service_id>", reason: "project finished" }) // end_of_period; undo_cancel keeps it
Tips voor agents
- Stuur
Authorization: Bearer <token>mee bij elke aanroep behalve de drie openbare. Met gewoon HTTP sla je het token op in een bestand: een shellvariabele overleeft losse commando's niet. - Lees de toegangsgegevens uit
get_vps_statusin plaats van de poort te raden. NAT-plannen gebruiken een persoonlijke poort; plannen met dedicated IPv4 gebruiken 22 voor Linux en 3389 voor Windows. - Een nieuwe server heeft ongeveer een minuut nodig om op te starten. Blijf
get_vps_statusopvragen; roepreset_passwordniet aan omdat SSH niet meteen antwoordde. topup_balanceenpay_invoicegeven een betaallink terug die een mens of een wallet moet betalen. Monero is een aparte handmatige opwaardering in het dashboard: zie betalen met Monero.
Dezelfde acties zonder MCP staan in de REST API-documentatie.
Reacties
Nog geen reacties. Wees de eerste.