Skip to main content
Glama
iotamine-mcp

iotamine-mcp

by piyushladhar

iotamine-mcp

An MCP server for the Iotamine cloud VPS platform. Connect it to Claude Desktop, Claude Code, Cursor, or any other MCP-compatible client to manage your account directly — the same actions available on the dashboard.

This is a thin wrapper around the real Iotamine REST API — the exact same API the dashboard itself uses. It doesn't duplicate any account logic, store any of your data, or run any service of its own; it just translates MCP tool calls into ordinary API requests on your behalf, using your own API key.

Setup

1. Get an API key

From your Iotamine dashboard → API Keys → Create Key. Choose a scope:

  • Read-only — can look up anything (VPS list, stats, billing, invoices, ...) but can't change anything. Use this if you're not fully in control of what calls the tools — an AI assistant, a script you didn't write yourself.

  • Read & write — can also do everything the read-only scope can, plus create/destroy/modify things. Required for any of the write tools below; a read-only key gets a clean, clear rejection if a write tool is called with it. It can reinstall a server, swap its boot volume or move its volumes to another server, so treat it as able to get root on your servers and their data.

  • Read, write & run commands — read & write, plus the command tools below (run_command, read_file, write_file, ...), the console (get_vps_console) and setting the root password (change_vps_root_password) on an existing server. Only give a key this when it needs to work inside a server.

2. Install and run

Using uv (recommended — no separate install step):

uvx iotamine-mcp

Or with pip:

pip install iotamine-mcp
iotamine-mcp

First run on a fresh machine takes longer — uvx/pip need to download the package and its dependencies once. If you're wiring this into an MCP client (below) and it fails with a timeout the very first time, run the command above directly in a terminal first, let it finish, then retry from the client — every run after the first is near-instant.

Already using an older version? uvx caches its own resolution of "latest" — it won't automatically notice a new release. Run uvx --refresh iotamine-mcp once in a terminal (or clear ~/.cache/uv) to pick up new tools, then restart your MCP client.

3. Add it to your MCP client

Claude Code:

claude mcp add iotamine uvx --args iotamine-mcp --env IOTAMINE_API_KEY="your-key-here"

Claude Desktop: Settings → Developer → Edit Config (or directly edit ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows, ~/.config/Claude/claude_desktop_config.json on Linux):

{
  "mcpServers": {
    "iotamine": {
      "command": "uvx",
      "args": ["iotamine-mcp"],
      "env": {
        "IOTAMINE_API_KEY": "your-key-here"
      }
    }
  }
}

Cursor: same JSON shape, in ~/.cursor/mcp.json (all projects) or .cursor/mcp.json in one project — or via Settings → MCP → Add new MCP server.

Set IOTAMINE_API_KEY as an environment variable in your client's config, not hardcoded anywhere else — the same rule any API key deserves. This is not the same thing as the "Connectors" picker some clients show for remote/OAuth servers — that only accepts a server URL, and won't list this package at all; the config-file route above is what actually runs it.

Related MCP server: Hostodo MCP

Write tools require confirmation

Every tool that spends money, destroys something, or otherwise changes account state takes an explicit confirm: true argument and refuses to run without it. This is deliberate — it means a model has to be told (by you, or by its own judgment reading the tool's description) exactly what it's about to do before it can actually do it. Always expect your assistant to explain the action and its cost (if any) before it sets confirm: true.

Running commands inside a server

run_command, get_command_result, cancel_command, list_commands, read_file and write_file let an assistant work inside a VPS — install packages, edit configs, restart services, read logs — without SSH. Commands run as root through the server's iotamine-agent (installed on Iotamine images), with output and an exit code; a long command keeps running even if the tool call returns first, and get_command_result follows it.

Two switches, both on the dashboard, and both are needed:

  1. Command access for that server — open the server → Commands → Allow commands. Off by default; only the owner can turn it on, never through an API key, and turning it on emails you.

  2. A key with "Read, write & run commands" access (or, when connecting an app like Claude, that access level on the authorization screen).

Every command is listed on the server's Commands tab with who ran it (dashboard, API key, or AI app). run_command and write_file are marked destructive, so MCP clients ask before each call. Linux servers only for now. Limits: 30 commands a minute per account, up to 3 running at once per server, commands up to 64 KB, files up to 1 MB, timeout up to 1 hour.

Tools

89 tools in total. There are three key scopes: read_only ("Read-only", the default), read_write ("Read & write") and full ("Read, write & run commands"). Read-only tools work with any of them; everything else needs at least read_write (still true for create_ticket/ reply_to_ticket/close_ticket/reopen_ticket — any write needs that scope, full stop). The one difference: those four don't require confirm=true the way spend/destroy tools do — nothing about a ticket's lifecycle costs anything or destroys anything (closing one isn't even final — replying to it, or calling reopen_ticket, reopens it). The command tools, get_vps_console, change_vps_root_password and reinstall_vps (a reinstall always sets a new root password) need a full key; get_vps_console is marked destructive, so MCP clients ask first.

VPS — lifecycle list_vps, get_vps, create_vps, destroy_vps, start_vps, stop_vps, poweroff_vps, restart_vps, reinstall_vps, resize_vps, change_vps_hostname, change_vps_root_password

VPS — monitoring & management get_vps_console, get_vps_stats, get_vps_bandwidth_history, get_vps_metrics_history, get_bandwidth_overview, get_bandwidth_overview_daily, get_vps_billing, get_vps_pricing, get_vps_smtp_status, get_vps_build_log, list_vps_available_os

VPS — backups list_vps_backups, get_vps_backup_cost, create_vps_backup, delete_vps_backup, restore_vps_backup

VPS — its own disks, IPs, reverse DNS, firewall list_vps_disks, add_disk_to_vps, remove_disk_from_vps, list_attachable_ips_for_vps, add_ip_to_vps, remove_ip_from_vps, set_vps_reverse_dns, list_firewall_rules, update_firewall_rules

Standalone IP addresses list_ip_addresses, get_ip_address, check_available_ips, purchase_ip, list_attachable_vps_for_ip, attach_ip, detach_ip, release_ip

Standalone volumes list_volumes, get_volume, list_available_volume_sizes, purchase_volume, get_volume_task_status, list_attachable_vps_for_volume, list_available_os_for_volume, install_os_on_volume, resize_volume, attach_volume, set_volume_as_boot, detach_volume, release_volume

SSH keys list_ssh_keys, create_ssh_key, delete_ssh_key

Billing & account get_quota, get_account_balance, list_invoices, get_invoice_summary, pay_invoice_from_credit, get_usage_billing, get_usage_billing_line_items, list_transactions, get_transaction

Catalogs list_os_images, list_regions

Activity & data export list_activity_logs, export_data

Support tickets list_ticket_departments, list_tickets, get_ticket, create_ticket, list_ticket_replies, reply_to_ticket, close_ticket, reopen_ticket

Maintenance list_maintenance_events

Commands & files inside a server (need a "Read, write & run commands" key and command access switched on for that server) run_command, get_command_result, cancel_command, list_commands, read_file, write_file

Configuration

Environment variable

Required

Default

IOTAMINE_API_KEY

Yes

—

IOTAMINE_API_URL

No

https://iotamine.com/api/

Development

python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
pytest

Available Tools

78 tools
add_disk_to_vpsA

Add a new disk of the given size (GB) directly to this VPS. Spends real money — requires confirm=true. For a standalone, independently-manageable volume instead, see purchase_volume.

Inputs: size (required), vps_id (required), confirm.

add_ip_to_vpsA

Purchase and attach a brand-new IP address directly to this VPS. This is an ONGOING monthly charge (see check_available_ips' own monthly_price, and its note on converting to an hourly rate), not a one-time fee — requires confirm=true. To attach an IP you already own instead, see attach_ip.

Inputs: vps_id (required), confirm.

attach_ipB

Attach a standalone IP address to a VPS (same region). Requires confirm=true.

Inputs: ip_id (required), vps_id (required), confirm.

attach_volumeA

Attach a standalone volume to a VPS (same region). Requires confirm=true. Asynchronous — poll get_volume_task_status.

Inputs: vps_id (required), volume_id (required), confirm.

change_vps_hostnameA

Change a VPS's hostname. The VPS must already be stopped — this rewrites files on the offline disk image, which isn't safe while it's running (stop it first with stop_vps). Requires confirm=true.

Inputs: vps_id (required), hostname (required), confirm.

change_vps_root_passwordA

Change a VPS's root/administrator password. The VPS must already be stopped, same reason as change_vps_hostname. Requires confirm=true.

Inputs: vps_id (required), new_password (required), confirm.

check_available_ipsA
Read-onlyIdempotent

How many standalone IP addresses can be purchased in a given region (Point of Presence id from list_regions) right now, and at what price. monthly_price is exactly what it says — a recurring monthly charge for as long as the address is held, NOT a one-time purchase fee. To quote an hourly-equivalent rate (to line up with a VPS's own hourly cores/ram/disk cost), divide by 720 (30 * 24) — this is the one field on a PoP that's monthly while cpu_price/ram_price/disk_price are already hourly; don't assume the same unit for all of them.

Inputs: pop (required).

create_ssh_keyA

Save a new SSH public key to this account, for installing onto future VPS instances via create_vps's own ssh_key parameter. Requires confirm=true. ssh_key is the public key material (e.g. the contents of id_ed25519.pub) — never a private key.

Inputs: title (required), ssh_key (required), confirm.

create_ticketA

Open a new support ticket with an opening message. priority is one of: low, medium, high. vps_id (optional) links the ticket to a specific VPS (an id from list_vps) if the issue is about one.

Inputs: message (required), subject (required), department_id (required), vps_id, +1 more.

create_vpsA

Deploy a new VPS. Spends real money — requires confirm=true, and should only be called after explicitly telling the user what will be provisioned and its estimated cost (see "Cost" below — get this right; it's a common mistake to quote only compute and forget the IP).

pop: a Point of Presence id from list_regions. cores/ram/disk: must match one of the allowed values the real API enforces — see get_quota or just try a value; a rejection names the allowed set.

Boot disk — exactly one of these two:

  • disk + operating_system: provisions a fresh disk (disk in GB) with a fresh OS install (operating_system an id from list_os_images). Both required together.

  • existing_boot_volume: boots from a standalone volume this account already owns instead (an id from list_volumes, kind "boot", not already attached to anything — check first). disk/operating_system are ignored if this is given; the volume already has its own OS. Costs nothing extra — the volume's own cost, if any, was already paid when it was purchased.

IP address — one of these two:

  • Omit existing_ip: a brand-new IP is automatically purchased and assigned as part of deployment. This is NOT free — it's the pop's own ip_price, billed the same as calling purchase_ip separately.

  • existing_ip: attach a standalone IP this account already owns instead (an id from list_ip_addresses, not already attached to anything — check first). No new IP purchased, no extra cost.

ssh_key: an id from list_ssh_keys, to install onto the new VPS.

Cost: call list_regions first and use the matching pop's own rates. cpu_price/ram_price/disk_price are hourly; ip_price is a MONTHLY figure — divide by 720 (30 * 24) before adding it to an hourly total, or it'll be off by ~720x (a real mistake this tool's docs used to make). Total hourly cost = cores * cpu_price

  • ram * ram_price + (disk * disk_price, only if provisioning a fresh disk — 0 if existing_boot_volume is given) + (ip_price / 720, only if existing_ip is NOT given — 0 if it is). Quote this full total, not just compute, before asking for confirmation — and say plainly that the IP portion is a recurring monthly charge, not a one-time fee.

Provisioning is asynchronous — this call returns immediately with the new VPS's id and is_building=true; poll get_vps for it to finish.

Inputs: pop (required), ram (required), cores (required), hostname (required), +8 more.

create_vps_backupA

Take a new backup of this VPS. May incur a cost — check get_vps_backup_cost first. Requires confirm=true.

Inputs: vps_id (required), confirm.

delete_ssh_keyA
Destructive

Permanently delete a saved SSH key from this account. Irreversible — requires confirm=true. Does not affect VPS instances it's already been installed onto, only future deploys.

Inputs: ssh_key_id (required), confirm.

delete_vps_backupA
Destructive

Permanently delete one backup of this VPS. Irreversible — requires confirm=true.

Inputs: vps_id (required), backup_id (required), confirm.

destroy_vpsA
Destructive

Permanently destroy a VPS and, by default, its boot disk. Irreversible — requires confirm=true. release_ip_ids/ release_disk_ids (lists of ids, optional) additionally release any attached standalone IPs/volumes instead of just detaching them (kept, unreleased, by default — see list_vps's own ip/disk fields for their ids).

Inputs: vps_id (required), confirm, release_ip_ids, release_disk_ids.

detach_ipA

Detach a standalone IP address from whatever VPS it's currently attached to (kept, not released). Requires confirm=true.

Inputs: ip_id (required), confirm.

detach_volumeA

Detach a standalone volume from whatever VPS it's currently attached to (kept, not released — the volume itself still belongs to this account). Requires confirm=true. Asynchronous — poll get_volume_task_status.

Inputs: volume_id (required), confirm.

export_dataA
Read-onlyIdempotent

Export a copy of this account's own data as CSV, one category at a time. category must be one of: profile, activity, invoices, transactions, usage, ip_addresses, volumes, vms, firewall_rules. ids (optional, for invoices/transactions/usage/ ip_addresses/volumes/vms only) narrows to specific row ids instead of exporting everything in that category.

Note: 'invoices' is a zip archive (one folder per invoice) on the real dashboard, which can't be returned as text here — that one category should be downloaded from the dashboard's own Export Data page instead.

Inputs: category (required), ids. Returns: result

get_account_balanceA
Read-onlyIdempotent

This account's current wallet balance, currency, and basic profile (name, email, country, verification status).

Inputs: no named parameters.

get_bandwidth_overviewA
Read-onlyIdempotent

Account-wide bandwidth usage overview across every VPS.

Inputs: no named parameters.

get_ip_addressA
Read-onlyIdempotent

Get full detail for one standalone IP address by its id.

Inputs: ip_id (required).

get_quotaA
Read-onlyIdempotent

This account's resource limits (VPS count / vCPU / RAM / disk / IP caps), current usage against each, and its current tier — core.quotas's balance-driven tier system, exactly what the dashboard's own Tier page shows.

Inputs: no named parameters.

get_ticketA
Read-onlyIdempotent

Get full detail for one ticket, including its replies.

Inputs: ticket_id (required).

get_transactionB
Read-onlyIdempotent

Get full detail for one transaction by its id.

Inputs: transaction_id (required).

get_usage_billingA
Read-onlyIdempotent

Current unbilled usage (a live snapshot) plus historical already-billed cost broken down by Compute/Storage/Network/Other — the same data the dashboard's own Usage Billing page shows.

Inputs: no named parameters.

get_usage_billing_line_itemsA
Read-onlyIdempotent

Row-by-row usage detail backing get_usage_billing's own summary — one row per VPS/volume/IP/bandwidth charge. status is "unbilled" (default, a live snapshot) or "billed" (everything already charged).

Inputs: status.

get_volumeA
Read-onlyIdempotent

Get full detail for one standalone volume by its id.

Inputs: volume_id (required).

get_volume_task_statusA
Read-onlyIdempotent

Check the status of an async volume operation (purchase, attach, detach, destroy, install_os, resize) by the task_id those calls return.

Inputs: task_id (required).

get_vpsA
Read-onlyIdempotent

Get full detail for one VPS instance by its id (a UUID, as returned by list_vps's own "id" field).

Inputs: vps_id (required).

get_vps_backup_costA
Read-onlyIdempotent

Cost of taking a new backup of this VPS, before calling create_vps_backup.

Inputs: vps_id (required).

get_vps_bandwidth_historyC
Read-onlyIdempotent

Historical bandwidth usage for one VPS.

Inputs: vps_id (required).

get_vps_billingB
Read-onlyIdempotent

Billing breakdown for one specific VPS.

Inputs: vps_id (required).

get_vps_build_logA
Read-onlyIdempotent

Provisioning log for a VPS that's still building, or was recently built — useful for diagnosing a stuck/failed deploy.

Inputs: vps_id (required).

get_vps_consoleA
Read-onlyIdempotent

Get a one-time console (VNC) connection URL and password for this VPS — grants live console access, treat the returned credentials as sensitive.

Inputs: vps_id (required).

get_vps_metrics_historyA
Read-onlyIdempotent

Historical CPU/RAM/disk metrics for one VPS (for graphing usage over time, not just the current snapshot get_vps_stats gives).

Inputs: vps_id (required).

get_vps_pricingA
Read-onlyIdempotent

Current per-unit pricing for this VPS's region — useful before calling resize_vps to preview cost. cpu_price/ram_price/ disk_price are hourly; ip_price is a monthly figure (divide by 720 for hourly-equivalent) — see list_regions's own note, same fields, same units.

Inputs: vps_id (required).

get_vps_smtp_statusB
Read-onlyIdempotent

Whether outbound SMTP ports are blocked on this VPS (a common anti-abuse policy) — {"supported": false} if this VPS's node doesn't support the check at all.

Inputs: vps_id (required).

get_vps_statsA
Read-onlyIdempotent

Real-time resource stats for a running VPS — CPU, RAM, disk, and network usage right now.

Inputs: vps_id (required).

install_os_on_volumeA
Destructive

Install a fresh OS onto this standalone volume, overwriting whatever's on it entirely. Irreversible — requires confirm=true. The volume must be detached from any VPS first (detach_volume). A Windows OS requires root_password; anything else needs at least one of ssh_public_key/root_password. Asynchronous — poll get_volume_task_status.

Inputs: volume_id (required), operating_system (required), confirm, root_password, +1 more.

list_activity_logsA
Read-onlyIdempotent

List this account's activity log — every action taken on the account or its VPS instances (sign-ins, VM power/create/ destroy, IP/volume changes, SSH key changes, ...), newest first. search (optional) matches action/description/IP address.

Inputs: search.

list_attachable_ips_for_vpsA
Read-onlyIdempotent

List this account's standalone IP addresses eligible to attach to this specific VPS (same region, not already attached).

Inputs: vps_id (required).

list_attachable_vps_for_ipA
Read-onlyIdempotent

List this account's VPS instances eligible to attach this IP to (same region as the IP).

Inputs: ip_id (required).

list_attachable_vps_for_volumeA
Read-onlyIdempotent

List this account's VPS instances eligible to attach this volume to (same region, stopped where required).

Inputs: volume_id (required).

list_available_os_for_volumeA
Read-onlyIdempotent

List operating systems available to install onto this volume via install_os_on_volume.

Inputs: volume_id (required).

list_available_volume_sizesA
Read-onlyIdempotent

List the volume sizes/kinds purchasable in a given region (Point of Presence id from list_regions).

Inputs: pop (required).

list_firewall_rulesA
Read-onlyIdempotent

List the firewall rules currently applied to this VPS.

Inputs: vps_id (required).

list_invoicesA
Read-onlyIdempotent

List every invoice on this account (paid, unpaid, and cancelled), most recent first — amount, status, due date, and line items.

Inputs: no named parameters.

list_ip_addressesA
Read-onlyIdempotent

List every standalone IP address on this account (attached to a VPS or not).

Inputs: no named parameters.

list_maintenance_eventsA
Read-onlyIdempotent

List maintenance events relevant to this account — anything affecting a VPS/region this account has infrastructure in, plus anything scoped account-wide. Includes recently-completed events (within the last 24h), not just currently-active ones.

Inputs: no named parameters.

list_os_imagesA
Read-onlyIdempotent

List every operating system image available to deploy a VPS with (name, distro, virtualization type).

Inputs: no named parameters.

list_regionsA
Read-onlyIdempotent

List every Point of Presence (region/data-center location) VPS instances can be deployed in, with each one's own per-unit rates: cpu_price, ram_price, disk_price are hourly. ip_price is the one exception — it's a monthly figure, not hourly; divide by 720 (30 * 24) for an hourly-equivalent rate before adding it to an hourly compute total (see create_vps's own cost explanation). Getting this unit mismatch wrong is a real, previously-shipped mistake — always double-check which field you're reading before quoting a price.

Inputs: no named parameters.

list_ssh_keysA
Read-onlyIdempotent

List every SSH public key saved on this account (title only — the public key material itself, never anything private).

Inputs: no named parameters.

list_ticket_departmentsA
Read-onlyIdempotent

List support departments a ticket can be filed under — the department_id source for create_ticket.

Inputs: no named parameters.

list_ticket_repliesA
Read-onlyIdempotent

List every reply on a ticket (same data get_ticket's own "replies" field already includes — this is the paginated version, for a ticket with a long conversation).

Inputs: ticket_id (required).

list_ticketsA
Read-onlyIdempotent

List this account's support tickets, most recently updated first. search (optional) matches subject/department/status.

Inputs: search.

list_transactionsA
Read-onlyIdempotent

List every transaction on this account's wallet (bonus credits, top-ups, adjustments), most recent first.

Inputs: no named parameters.

list_volumesA
Read-onlyIdempotent

List every standalone storage volume on this account (attached to a VPS or not, boot or non-boot).

Inputs: no named parameters.

list_vpsA
Read-onlyIdempotent

List every VPS instance on this Iotamine account — hostname, status, specs (cores/ram/disk/traffic), IP addresses, OS, node location, and machine_status (Running/Stopped/Building/...) for each one.

Inputs: no named parameters.

list_vps_available_osA
Read-onlyIdempotent

List the operating systems available to reinstall onto this specific VPS (via reinstall_vps) — not every OS is available on every node, unlike list_os_images' full catalog.

Inputs: vps_id (required).

list_vps_backupsA
Read-onlyIdempotent

List every backup taken of this VPS.

Inputs: vps_id (required).

list_vps_disksA
Read-onlyIdempotent

List the disks currently attached to this VPS.

Inputs: vps_id (required).

poweroff_vpsA

Hard power-off a VPS — equivalent to pulling the plug, no chance for the guest OS to shut down cleanly. Use stop_vps for a graceful shutdown instead.

Inputs: vps_id (required).

purchase_ipA

Purchase one or more new standalone IP addresses in a region (Point of Presence id from list_regions). At most 20 at a time. This is an ONGOING monthly charge, not a one-time fee — see check_available_ips's own monthly_price before quoting a cost, and make that recurring nature clear to the user, not just the number. Spends real money (checked against balance and quota) — requires confirm=true. Synchronous — the purchased addresses are returned directly, no task to poll.

Inputs: pop (required), quantity (required), confirm.

purchase_volumeA

Purchase a new standalone volume. Spends real money (checked against balance and quota) — requires confirm=true. kind is "data" or "boot" (a boot volume becomes a future VPS's boot disk, not attached to anything existing). In a region without fleet-volume support, a "data" volume must instead be pinned to an existing VPS at purchase time via vps_id (a "boot" volume isn't purchasable there at all — the real API's error message will say so if this applies).

Asynchronous — returns a task_id immediately; poll get_volume_task_status for completion, then list_volumes to see the finished volume.

Inputs: pop (required), size_gb (required), kind, vps_id, +1 more.

reinstall_vpsA
Destructive

Wipes the VPS's boot disk and reinstalls a fresh OS onto it — irreversible, everything currently on the disk is lost. The VPS must already be stopped, same reason as change_vps_hostname (stop it first with stop_vps). Requires confirm=true. os_id: an id from list_vps_available_os for this specific VPS (not every OS is available on every node).

Inputs: os_id (required), vps_id (required), new_pass (required), confirm.

release_ipA
Destructive

Permanently release (delete) a standalone IP address — not just detach it. Irreversible — requires confirm=true.

Inputs: ip_id (required), confirm.

release_volumeA
Destructive

Permanently release (delete) a standalone volume — not just detach it. Irreversible — requires confirm=true. Asynchronous — poll get_volume_task_status.

Inputs: volume_id (required), confirm.

remove_disk_from_vpsB
Destructive

Permanently remove a disk from this VPS. Irreversible — requires confirm=true.

Inputs: vps_id (required), disk_uuid (required), confirm.

remove_ip_from_vpsA
Destructive

Permanently remove (release) an IP address from this VPS. Irreversible — requires confirm=true. To detach without releasing it, see detach_ip instead.

Inputs: vps_id (required), ip_addr (required), confirm.

reply_to_ticketC

Post a reply on an existing ticket.

Inputs: message (required), ticket_id (required).

resize_volumeA

Resize a standalone volume (grow only). Spends real money — requires confirm=true. Asynchronous — poll get_volume_task_status.

Inputs: size_gb (required), volume_id (required), confirm.

resize_vpsA

Resize a VPS's CPU/RAM. An increase is checked against balance and quota by the real API (fails cleanly if either is insufficient); a decrease is always allowed. Requires confirm=true for any change. Only pass the value(s) you want to change — omit the other.

Inputs: vps_id (required), ram, cores, confirm.

restart_vpsB

Restart a running VPS.

Inputs: vps_id (required).

restore_vps_backupA
Destructive

Restore this VPS from a backup — overwrites its current disk state entirely with the backup's. Irreversible (anything written since the backup was taken is lost) — requires confirm=true.

Inputs: vps_id (required), backup_id (required), confirm.

set_volume_as_bootA

Set this volume as a VPS's boot disk. The VPS must already be stopped — the same requirement vps.py's change_vps_hostname documents (stop it first with stop_vps). Requires confirm=true.

Inputs: vps_id (required), volume_id (required), confirm.

set_vps_reverse_dnsA

Set the reverse-DNS (PTR) record for one of this VPS's IP addresses. Requires confirm=true.

Inputs: ip (required), rdns (required), vps_id (required), confirm.

start_vpsA

Start a stopped VPS.

Inputs: vps_id (required).

stop_vpsA

Gracefully stop (ACPI shutdown) a running VPS — gives the guest OS a chance to shut down cleanly. Use poweroff_vps for a hard power-off instead.

Inputs: vps_id (required).

update_firewall_rulesA

Replace this VPS's entire firewall rule set with the given list. Requires confirm=true — this can lock out access (including SSH) if the rules are wrong; double-check with the user before calling. Each rule should match the shape returned by list_firewall_rules.

Inputs: rules (required), vps_id (required), confirm.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 78 tools

    Disambiguation5/5

    Every tool has a clearly distinct purpose, even with 78 tools. Similar operations are carefully separated and described (e.g., detach_ip keeps the IP while remove_ip_from_vps releases it; add_ip_to_vps purchases and attaches a new IP while attach_ip uses an existing one). Detailed descriptions make the boundaries unmistakable.

    Naming Consistency4/5

    All tool names follow a snake_case verb_noun pattern, and resource nouns (vps, ip, volume, ssh_key, ticket) are consistent. However, verb choices are highly varied—attach/add, remove/detach/release, set/change/update—which reduces predictability and can lead to hesitation when selecting the right verb.

    Tool Count1/5

    78 tools is far beyond the typical well-scoped range (3-15) and well past the 50+ extreme mismatch threshold. Even for a full-featured cloud provider API, this breadth overwhelms an agent, increases selection errors, and consumes excessive context.

    Completeness5/5

    The tool set provides comprehensive lifecycle coverage across VPS, IP, volume, backup, billing, support, and account domains. It supports read/list, create, update, and delete/release operations for each major resource, with no obvious dead ends or missing core operations.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      B
      maintenance
      Enables MCP clients like Claude Code, Claude Desktop, or Cursor to read and manage Remnawave 3.x VPN panel resources — users, nodes, hosts, config profiles, squads, subscription templates, billing, and HWID devices — through the panel's REST API, with contract-driven tool schemas, numeric user IDs, multi-panel config lookup, and an optional readonly mode.
      204
      MIT