How do I call these tools?

Connect an MCP client to https://mcp.eqvps.com/mcp (Streamable HTTP) and invoke the tool by name with the listed parameters. See the connect guide for Claude Desktop, Cursor, and Cline.

Which tools need a Bearer token?

Only the catalog/auth tools are public: list_plans, register_account, login. Everything else requires Authorization: Bearer — get a token from register_account.

Which tools are destructive?

reinstall_vps and immediate cancel_service wipe the VM and all data; reset_password invalidates the current root password. All three require a confirm value equal to the exact hostname (or 'DELETE') and should be confirmed with the human first.

Are there rate limits?

Yes — sensitive actions (reinstall, reset_password, cancel, power, order, top-up) are rate-limited server-side. Normal agent usage is well within the limits.

EQVPS MCP tools: full reference (16 tools)

The EQVPS MCP server exposes 16 tools that let an AI agent discover plans, open an account, pay with crypto, and fully operate a VPS. Endpoint: https://mcp.eqvps.com/mcp (Streamable HTTP). See the connect guide to wire it into your client.

Auth model: list_plans, register_account, and login are public. Every other tool requires a Bearer token — obtain one instantly from register_account and send it as Authorization: Bearer <token>.

Discovery & auth

Tool	Auth	Parameters	What it does
`list_plans`	public	—	List all VPS plans: pricing, specs, and the OS images each plan can boot. Call this first to pick a `product` slug and `os_id`.
`register_account`	public	`first_name`, `last_name`, `email`	Create an account with no password and no human step. Returns a Bearer `token`.
`login`	public	`email`, `password`	Log in with email + password; returns a Bearer `token`.
`whoami`	Bearer	—	Return the authenticated account profile (id, name, email). Verifies the token.

Balance & ordering

Tool	Auth	Parameters	What it does
`get_balance`	Bearer	—	Return the prepaid credit balance and currency. `order_vps` spends from it automatically.
`topup_balance`	Bearer	`amount` (USD, positive)	Create a top-up invoice; returns a PayRam `checkout_url`. Balance is credited once the on-chain USDC/USDT payment confirms. One unpaid top-up at a time.
`order_vps`	Bearer	`product` (plan slug), `os_id` (int), `hostname?`, `ssh_key?`	Order a VPS. Pass an `ssh_key` (public key) for key-based root login. Pays from balance when sufficient, otherwise returns an invoice to pay.
`pay_invoice`	Bearer	`invoice_id` (int)	Initiate payment for an owned, unpaid invoice. Returns a PayRam `checkout_url`; the VPS provisions automatically once payment confirms.

Operating a VPS

Tool	Auth	Parameters	What it does
`list_vps`	Bearer	—	List the account's VPS services (id, status, plan). Use `id` as `service_id` below.
`get_vps_status`	Bearer	`service_id` (int)	Full detail: status, specs, live VM state/uptime, and SSH access (host, port, ready-to-paste `command`). On the first call for a keyless server it returns the one-time root `password`. Poll after `order_vps` until `active`.
`power_vps`	Bearer	`service_id`, `action` = `start` \| `stop` \| `reboot`	Power-control the VPS.
`set_hostname`	Bearer	`service_id`, `hostname`	Set the VPS hostname (valid DNS label; applied on next reboot/rebuild).
`get_vps_metrics`	Bearer	`service_id`, `timeframe?` = `hour` \| `day` \| `week` \| `month`	Time-series CPU, memory, network, and disk metrics (default `hour`).

Destructive — require `confirm`

These wipe data or access. confirm must equal the exact hostname (from get_vps_status) or the literal DELETE. Confirm with the human first.

Tool	Auth	Parameters	What it does
`reset_password`	Bearer	`service_id`, `confirm`	Rotate the root password. The OLD password stops working immediately. New password is read once via `get_vps_status` (also emailed).
`reinstall_vps`	Bearer	`service_id`, `os_id` (int), `confirm`	Wipe and reinstall with the given OS image — all data is lost. Provisioning is async; poll `get_vps_status`.
`cancel_service`	Bearer	`service_id`, `type?` = `end_of_period` \| `immediate`, `confirm?`	Default `end_of_period`: stays active until the paid period ends, then not renewed — no data loss. `immediate` destroys the VM and all data now (requires `confirm` = hostname); the unused paid time is refunded to your balance (`refund_amount`).

Example: order and boot a VPS

list_plans()                                  // pick product "nano", note an os_id
register_account({ first_name, last_name, email })   // → Bearer token
topup_balance({ amount: 10 })                 // pay the returned checkout_url in USDC/USDT
order_vps({ product: "nano", os_id: <os_id from list_plans>, ssh_key: "ssh-ed25519 AAAA..." })
get_vps_status({ service_id: <your-service-id> }) // poll → active, read SSH host/port/command
power_vps({ service_id: <your-service-id>, action: "reboot" })

Notes for agents

Send Authorization: Bearer <token> on every non-public call.
Pay in USDC/USDT (Base, Ethereum, Tron) — no card required. Prefer a prepaid balance so ordering is one call.
Always get_vps_status to read access details; treat reinstall_vps, reset_password, and immediate cancel_service as irreversible.

New to the setup? Start with the connect guide, or read the Docs for the underlying REST API.