iotamine-mcp
Manage an Iotamine cloud VPS account through MCP tools that wrap the Iotamine REST API, from read-only inspection to paid/destructive changes and server command execution.
List and inspect VPS instances, specs, status, IPs, OS, location, stats, bandwidth, metrics, billing, pricing, SMTP status, build logs, and available OS images.
Create, destroy, start, stop, power off, restart, reinstall, resize, rename hostname, and change root password for VPS instances.
Manage backups: list, cost-check, create, delete, and restore.
Manage VPS disks, attached IPs, reverse DNS, and firewall rules.
Purchase, attach, detach, release, and inspect standalone IP addresses.
Purchase, resize, attach, detach, release, install OS on, and set boot status for standalone volumes.
Manage SSH keys.
View account quota, balance, invoices, usage billing, transactions, activity logs, and export account data as CSV.
Manage support tickets and view maintenance events.
Run commands and read/write files inside a server when using a full-access key and command access is enabled.
Most spending or destructive actions require explicit
confirm: true; command/console/password/reinstall tools require a full “Read, write & run commands” key.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@iotamine-mcp list my VPS instances and their status"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-mcpOr with pip:
pip install iotamine-mcp
iotamine-mcpFirst 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:
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.
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 |
| Yes | — |
| No |
|
Development
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
pytestAvailable Tools
78 toolsadd_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_ipsARead-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_keyADestructive
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_backupADestructive
Permanently delete one backup of this VPS. Irreversible — requires confirm=true.
Inputs: vps_id (required), backup_id (required), confirm.
destroy_vpsADestructive
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_dataARead-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_balanceARead-onlyIdempotent
This account's current wallet balance, currency, and basic profile (name, email, country, verification status).
Inputs: no named parameters.
get_bandwidth_overviewARead-onlyIdempotent
Account-wide bandwidth usage overview across every VPS.
Inputs: no named parameters.
get_ip_addressARead-onlyIdempotent
Get full detail for one standalone IP address by its id.
Inputs: ip_id (required).
get_quotaARead-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_ticketARead-onlyIdempotent
Get full detail for one ticket, including its replies.
Inputs: ticket_id (required).
get_transactionBRead-onlyIdempotent
Get full detail for one transaction by its id.
Inputs: transaction_id (required).
get_usage_billingARead-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_itemsARead-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_volumeARead-onlyIdempotent
Get full detail for one standalone volume by its id.
Inputs: volume_id (required).
get_volume_task_statusARead-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_vpsARead-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_costARead-onlyIdempotent
Cost of taking a new backup of this VPS, before calling create_vps_backup.
Inputs: vps_id (required).
get_vps_bandwidth_historyCRead-onlyIdempotent
Historical bandwidth usage for one VPS.
Inputs: vps_id (required).
get_vps_billingBRead-onlyIdempotent
Billing breakdown for one specific VPS.
Inputs: vps_id (required).
get_vps_build_logARead-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_consoleARead-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_historyARead-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_pricingARead-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_statusBRead-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_statsARead-onlyIdempotent
Real-time resource stats for a running VPS — CPU, RAM, disk, and network usage right now.
Inputs: vps_id (required).
install_os_on_volumeADestructive
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_logsARead-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_vpsARead-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_ipARead-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_volumeARead-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_volumeARead-onlyIdempotent
List operating systems available to install onto this volume via install_os_on_volume.
Inputs: volume_id (required).
list_available_volume_sizesARead-onlyIdempotent
List the volume sizes/kinds purchasable in a given region (Point of Presence id from list_regions).
Inputs: pop (required).
list_firewall_rulesARead-onlyIdempotent
List the firewall rules currently applied to this VPS.
Inputs: vps_id (required).
list_invoicesARead-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_addressesARead-onlyIdempotent
List every standalone IP address on this account (attached to a VPS or not).
Inputs: no named parameters.
list_maintenance_eventsARead-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_imagesARead-onlyIdempotent
List every operating system image available to deploy a VPS with (name, distro, virtualization type).
Inputs: no named parameters.
list_regionsARead-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_keysARead-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_departmentsARead-onlyIdempotent
List support departments a ticket can be filed under — the department_id source for create_ticket.
Inputs: no named parameters.
list_ticket_repliesARead-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_ticketsARead-onlyIdempotent
List this account's support tickets, most recently updated first. search (optional) matches subject/department/status.
Inputs: search.
list_transactionsARead-onlyIdempotent
List every transaction on this account's wallet (bonus credits, top-ups, adjustments), most recent first.
Inputs: no named parameters.
list_volumesARead-onlyIdempotent
List every standalone storage volume on this account (attached to a VPS or not, boot or non-boot).
Inputs: no named parameters.
list_vpsARead-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_osARead-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_backupsARead-onlyIdempotent
List every backup taken of this VPS.
Inputs: vps_id (required).
list_vps_disksARead-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_vpsADestructive
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_ipADestructive
Permanently release (delete) a standalone IP address — not just detach it. Irreversible — requires confirm=true.
Inputs: ip_id (required), confirm.
release_volumeADestructive
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_vpsBDestructive
Permanently remove a disk from this VPS. Irreversible — requires confirm=true.
Inputs: vps_id (required), disk_uuid (required), confirm.
remove_ip_from_vpsADestructive
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_backupADestructive
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
Scored across 78 tools
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.
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.
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.
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
Related MCP Connectors
Manage Vozora VPS servers, SSH keys, firewalls, DNS and usage from an AI agent.
Hosted WooCommerce MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.
Hosted DataForSEO MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to manage VPS servers, domains, DNS records, and SSH keys through the VPS.org API via natural language.262MIT

Hostodo MCPofficial
AlicenseBqualityDmaintenanceManage Hostodo VPS infrastructure from MCP clients and AI agents with scoped tokens and audit logs.471MIT- AlicenseNot gradedqualityDmaintenanceMCP server that wraps the Linode API v4 for use in Claude Desktop, enabling management of Linode instances, volumes, DNS, and more via natural language.ISC
- AlicenseCqualityBmaintenanceEnables 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.204MIT