websupport-mcp
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., "@websupport-mcp list DNS records for example.com"
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.
websupport-mcp
An MCP server (TypeScript, ESM, stdio) wrapping the Websupport REST API v1 + v2 — DNS, FTP, hosting, databases, mailboxes, VPS and invoices — exposed as MCP tools with signed HMAC-SHA1 authentication.
Status: early. All 50 tools are implemented and published, but most have been verified only as
far as reaching the API — routes, signing and error handling are proven; response shapes largely are
not. Read docs/verification-matrix.md before relying on any tool,
and see IMPLEMENTATION_PLAN.md for progress.
Risk tiers
Tools are registered in three tiers, and the tier gates registration — a read-only deployment
never sees a write tool in tools/list at all, so it costs no client context and offers no
affordance.
Tier | Opt-in | Extra per-call gate | Currently |
| always on | — | 30 tools |
|
| — | 13 tools |
|
|
| 7 tools |
A tool is destructive when it destroys state you cannot cheaply recreate — not merely because it
writes. A graceful VPS reboot is write; a hard power-cycle is destructive, because it can
corrupt in-flight writes. Taking a snapshot is write; restoring one is destructive, because it
discards everything since.
The two opt-ins are independent: WEBSUPPORT_ALLOW_DESTRUCTIVE=1 alone does not unlock write
tools, and vice versa.
The confirm: true argument, not MCP elicitation, is the safety boundary. Protocol negotiation may
settle well below the revision that supports elicitation — this server's SDK currently tops out at
2025-11-25 — and a gate that disappears against an older client is not a gate.
Related MCP server: cpanel-mcp
Install
Requires Node >= 22. Nothing to install ahead of time — npx fetches the package on first run.
Add this to your MCP client's configuration:
{
"mcpServers": {
"websupport": {
"command": "npx",
"args": ["-y", "websupport-mcp"],
"env": {
"WEBSUPPORT_API_KEY": "…",
"WEBSUPPORT_API_SECRET": "…"
}
}
}
}That gives you the 30 read-only tools. Nothing in that configuration can change your account.
To allow changes, add only the opt-ins you need — see Risk tiers above:
"env": {
"WEBSUPPORT_API_KEY": "…",
"WEBSUPPORT_API_SECRET": "…",
"WEBSUPPORT_ALLOW_WRITE": "1",
"WEBSUPPORT_ALLOW_DESTRUCTIVE": "1"
}Ready-made configurations for each combination live in
examples/mcp-config/. Pin a version with websupport-mcp@0.1.1 in place
of websupport-mcp.
Once it is wired up, ask your client to run ws_auth_check. It returns {"verified": true} when
the credentials work, which is the quickest way to separate a bad key from anything else.
Docker
A Dockerfile is included, for hosts that run containers rather than npx and for
registry build sandboxes:
docker build -t websupport-mcp .
docker run -i --rm -e WEBSUPPORT_API_KEY -e WEBSUPPORT_API_SECRET websupport-mcp-i is not optional — the transport is stdio. No credentials are baked into the image; pass them
per run.
From a local checkout
For development, or to run unreleased changes:
npm install
npm run buildThen point command at node and args at the built entrypoint
(<checkout>/dist/index.js) instead of npx.
Credentials
Generate a Standard API access pair in WebAdmin (Security → API keys). A DynDNS-only pair
authenticates against /nic/update and nothing else.
Variable | Required | Default | Notes |
| yes | — | The pair's identifier. |
| yes | — | The pair's secret. Used for HMAC-SHA1 signing; never logged, never returned in an error. |
| no |
| Market selection — see below. |
| no |
| One of |
| no | off | Set to |
| no | off | Set to |
Copy .env.example for local development. .env is gitignored.
Missing credentials do not stop the server. It starts, registers its tools and answers tools/list
unauthenticated — which is what registry build sandboxes, MCP Inspector and client config probes
do before anyone holds a key — and the first tool call then fails with a message naming the
variable that is absent.
Markets
Websupport is a regional team.blue/Loopia brand, so the API host selects the market. The same
application serves every host — GET /v2/docs/openapi.json is byte-identical across all of them —
so switching markets is configuration, never a code change.
Market |
|
Slovakia (default) |
|
Czechia |
|
Hungary |
|
Sweden |
|
An unrecognised host warns to stderr and is used anyway, so a newly added market works without waiting for a release.
Documentation
Document | What it holds |
Every tool: tier, method + path, confirm requirement. Generated from the registry — never hand-edited. | |
What has actually been proven about each tool, and what has not. Read this before trusting any tool in production. | |
The request path, the signing contract and its three counter-intuitive rules, and how the tier model works. | |
Module map — what lives where and why. | |
Ready-to-edit client configurations for each tier combination. |
Scope
Order creation and invoice/order payment endpoints are deliberately out of scope and are asserted absent by test. v1 DNS-record CRUD and v1 FTP-account CRUD are deprecated upstream and are not exposed — the v2 tools cover both.
Development
npm test # offline suite
npm run test:network # live, unauthenticated probes (market hosts + OpenAPI drift)
npm run typecheck
npm run lint
npm run buildNetwork suites are separated deliberately: a Websupport outage must not fail the build.
Toolchain
Node >= 22, to run or to build. Node 20 reached end of life on 2026-04-30 and is not supported. CI covers the two live LTS lines, 22 and 24, and builds and smoke-tests the bundle on each.
Building also needs npm >= 11: npm 10 cannot resolve the bundler's dependency tree and fails
with an unhelpful Cannot read properties of null (reading 'edgesOut'). If you hit that, upgrade
npm rather than debugging the repository.
Security
The credentials this server holds grant full control of a Websupport account — there is no
read-only API pair. SECURITY.md covers how they are handled, which tools return
sensitive data, and how to report a vulnerability privately.
Contributing
See CONTRIBUTING.md. Note two boundaries enforced by test rather than review:
no order or payment endpoints, and every destructive tool must declare confirm: true.
Licence
MIT — see LICENSE.
Available Tools
30 toolsws_auth_checkVerify API credentialsARead-onlyIdempotent
Verify that the configured Websupport API key and secret authenticate successfully. Returns {verified: true} on success. Use this first when diagnosing 401 errors.
Inputs: no named parameters.
ws_db_getGet databaseARead-onlyIdempotent
Get one database by id, including its name, type and connection details.
Inputs: hostingId (required), databaseId (required), userId.
ws_db_listList databasesARead-onlyIdempotent
List the databases on a hosting service.
Inputs: hostingId (required), userId.
ws_db_statsDatabase statisticsBRead-onlyIdempotent
Usage statistics for one database. kind selects the series: size (storage used) or cpu (query load).
Inputs: kind (required), hostingId (required), databaseId (required), userId.
ws_db_users_listList database usersBRead-onlyIdempotent
List the database users on a hosting service.
Inputs: hostingId (required), userId.
ws_dns_record_listList DNS recordsARead-onlyIdempotent
List DNS records in a service zone, with paging and server-side filtering. Returns the API pagination envelope unflattened.
Inputs: service (required), page, sortBy, filters, +2 more.
ws_dns_zone_getGet DNS zoneARead-onlyIdempotent
Get the DNS zone attached to a service.
Inputs: service (required).
ws_ftp_account_getGet FTP accountARead-onlyIdempotent
Get one FTP account by id. The password is never returned.
Inputs: service (required), ftpAccount (required).
ws_ftp_account_listList FTP accountsARead-onlyIdempotent
List FTP accounts on a hosting service. Passwords are never returned — the API response schema has no password field.
Inputs: service (required), page, sortBy, descending, +1 more.
ws_hosting_getGet hosting serviceARead-onlyIdempotent
Get one hosting service by id or uuid, including its package, limits and current usage.
Inputs: hostingId (required), userId.
ws_hosting_listList hosting servicesARead-onlyIdempotent
List the hosting services on the account.
Inputs: page, userId, pagesize.
ws_hosting_statsHosting statisticsARead-onlyIdempotent
Usage statistics for a hosting service. kind selects the series: size (disk usage), domain (per-domain traffic), or ftp (FTP activity).
Inputs: kind (required), hostingId (required), userId.
ws_hosting_vhost_getGet virtual hostARead-onlyIdempotent
Get one virtual host by id, including its document root and domain configuration.
Inputs: vhostId (required), hostingId (required), userId.
ws_hosting_vhost_listList virtual hostsARead-onlyIdempotent
List the virtual hosts (domains) served by a hosting service.
Inputs: hostingId (required), userId.
ws_invoice_getGet invoiceARead-onlyIdempotent
Get one invoice by id, including line items, totals and payment status. Use ws_invoice_pdf for the document itself.
Inputs: invoiceId (required), userId.
ws_invoice_listList invoicesARead-onlyIdempotent
List the account's invoices with their amounts, dates and payment status. Paying an invoice is deliberately out of scope for this server.
Inputs: page, userId, pagesize.
ws_invoice_pdfGet invoice PDFARead-onlyIdempotent
Fetch an invoice as a PDF. base64 returns the document encoded for a caller that will decode and save it. binary reports the size and type only — raw PDF bytes are never inlined into a tool result, because they would flood the conversation without being usable.
Inputs: invoiceId (required), format, userId.
ws_mailbox_getGet mailboxARead-onlyIdempotent
Get one mailbox by id, including its address, quota and forwarding configuration.
Inputs: hostingId (required), mailboxId (required), userId.
ws_mailbox_listList mailboxesARead-onlyIdempotent
List the mailboxes on a hosting service.
Inputs: hostingId (required), userId.
ws_mail_statsMail statisticsARead-onlyIdempotent
Mail storage statistics for a hosting service. Supply domain to scope the figures to one domain; omit it for the whole service.
Inputs: hostingId (required), domain, userId.
ws_service_getGet serviceARead-onlyIdempotent
Get one service by id, including its type, status and expiry. Use ws_service_list first to find the id.
Inputs: serviceId (required), userId.
ws_service_listList servicesARead-onlyIdempotent
List the account's services (hosting, domains, VPS and so on). Returns the v1 envelope {items, pager}. Service ids from here are the candidates for the v2 tools' service argument.
Inputs: userId.
ws_user_getGet accountARead-onlyIdempotent
Get the account record: id, contact details, billing profiles, market and currency. SENSITIVE — the response includes the billing address, email address, phone number, and a verifyUrl containing a live account-verification key. Do not echo the full response to the user or store it; read the specific field needed.
Inputs: userId.
ws_vps_getGet VPSARead-onlyIdempotent
Get one VPS by id or name, including its specification, IP addresses and power state.
Inputs: vpsId (required), userId.
ws_vps_listList VPS instancesBRead-onlyIdempotent
List the VPS instances on the account.
Inputs: page, userId, pagesize.
ws_vps_snapshot_listList VPS snapshotsARead-onlyIdempotent
List the snapshots taken of a VPS, with their names and creation times.
Inputs: vpsId (required), userId.
ws_vps_statsVPS statisticsARead-onlyIdempotent
Usage statistics for a VPS. kind selects the series: cpu (processor load) or traffic (network transfer).
Inputs: kind (required), vpsId (required), userId.
ws_vps_vncGet VPS console accessARead-onlyIdempotent
Get VNC console access details for a VPS. SENSITIVE — the response may carry a one-time console URL or session credential that grants direct machine access. Hand it to the user who asked for it and nothing else: do not log it, do not repeat it in a summary, and treat it as expiring.
Inputs: vpsId (required), userId.
ws_zone_getGet DNS zoneBRead-onlyIdempotent
Get one DNS zone by domain name.
Inputs: domain (required), userId.
ws_zone_listList DNS zonesARead-onlyIdempotent
List the DNS zones on the account. For the records inside a zone use the v2 tool ws_dns_record_list — v1 record CRUD is deprecated and deliberately not exposed.
Inputs: page, userId, pagesize.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 30 tools
Each tool targets a distinct resource-action pair (e.g., list vs. get for hosting, databases, mailboxes, VPS, invoices). Even similar-sounding tools like ws_dns_zone_get and ws_zone_get differ by lookup key (service vs. domain), and ws_service_get vs. ws_hosting_get are clearly scoped by description.
All tools follow the consistent ws_verb_noun snake_case pattern (e.g., ws_dns_record_list, ws_hosting_vhost_get, ws_vps_snapshot_list). No style mixing or vague verbs.
With 30 tools, the surface is heavily over-populated for a typical MCP server. While the scope spans many resource types (DNS, FTP, hosting, DBs, mail, VPS, invoices), the count exceeds the 'heavy' 16-25 band and feels excessive even for a broad control-panel API.
The tool set is almost entirely read-only; there are no create, update, or delete operations for any resource (DNS records, FTP accounts, databases, mailboxes, VPS snapshots, etc.). The descriptions explicitly exclude actions like paying invoices and v1 record CRUD, leaving significant gaps for an expected management surface.
Maintenance
Related MCP Connectors
Manage your Servera hosting over MCP: VPS/VDS, DNS, firewall, backups, SSL, billing, tickets.
Manage your Servera hosting over MCP: VPS/VDS, DNS, firewall, backups, SSL, billing, tickets.
MCP server for DNSimple — domains, DNS zone records, availability, pricing and contacts.
Related MCP Servers
- AlicenseBqualityCmaintenanceMCP server to help manage a WHMCS installation.6224MIT
- AlicenseNot gradedqualityFmaintenanceA comprehensive MCP server for managing cPanel web hosting accounts via UAPI, enabling file, database, email, domain, cron, backup, and system monitoring operations.3MIT
- AlicenseBqualityDmaintenanceMCP server for the adm.tools / ukraine.com.ua hosting API, providing tools to manage hosting services, accounts, sites, and web apps.51MIT
- AlicenseAqualityDmaintenanceMCP server for the DreamHost API that enables DNS management (list, add, remove records) and API metacommands.51MIT