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., "@aeza-mcp show me my Aeza servers and their current 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.
MCP server for the Aeza API: servers, backups, networks, DNS, billing and support as tools for an AI agent, one tool per API operation.
The tools are not baked in. On startup the server reads the API's OpenAPI spec and builds them from it, so it follows the API without a new release.
The server speaks MCP over stdio and needs Node 20 or newer:
claude mcp add aeza -e AEZA_API_KEY=<key> -- npx -y aeza-mcpFor clients configured with JSON:
{
"mcpServers": {
"aeza": {
"command": "npx",
"args": ["-y", "aeza-mcp"],
"env": { "AEZA_API_KEY": "<key>", "AEZA_READ_ONLY": "1" }
}
}
}With Bun, bunx aeza-mcp does the same without Node.
Related MCP server: Plesk MCP Server
Variable | Default | |
| API key of the account. Without it only public endpoints work | |
| everything but | Comma-separated toolsets to expose, or |
| off |
|
| off |
|
|
| Longer results are cut, lists at an item boundary with a note on how many items are missing |
|
|
The spec is cached in ~/.cache/aeza-mcp (or $XDG_CACHE_HOME/aeza-mcp). Each start makes one small request, GET /version, and compares it with the cached spec's version; the 160 KB spec itself is downloaded only when they differ. A start takes about a second the first time and half a second after that.
When the API cannot be reached, the cached spec is used. With no cache either, the server exits with an error.
When the spec changes, the tools change with it, and the server says so on stderr (API spec updated: 60644150 -> …). Nobody reviews that change, so a new endpoint is callable as soon as Aeza documents it.
Sections of the API this server has not seen before go to the other toolset, which is off by default, so a new kind of tool appears only when you opt in.
An operation the server cannot make sense of is skipped with a line on stderr; the rest keep working.
Counts are for the spec as of November 2026.
Toolset | Tools | Read-only | Deleting | Covers |
| 53 | 20 | 7 | Servers: power, reinstall, rescue, stats, prolongation, backups, IPs and PTR, SSH keys, extra resources |
| 8 | 7 | 0 | Products, groups and types; price calculation and ordering |
| 15 | 8 | 2 | Domains and DNS records, availability and delegation checks |
| 18 | 11 | 2 | Transactions, invoices, payment methods, recurrent payments, withdrawals |
| 28 | 8 | 5 | Profile, API keys, sessions, SSO links, companies, notifications |
| 19 | 9 | 0 | Tickets, messages, ratings, file uploads |
| 16 | 9 | 0 | Referral program, gifts, bonuses, gift codes |
| 8 | 7 | 0 | Health, version, error catalog, alerts |
| 19 | 7 | 1 | Plumbing of the web panel (login flows, websocket tokens, web push, consents); off by default |
| 0 | 0 | 0 | API sections added after this list was written; off by default |
Deleting tools are the API's DELETE operations plus reinstalling a server and restoring a backup, which wipe its disk just as surely; they are left out unless AEZA_ALLOW_DELETE=1. The default set is 149 tools, about 66 KB of tool definitions. Clients that load every definition into the model's context up front do better with a narrower AEZA_TOOLSETS, for example services,catalog,domains (67 tools, 33 KB).
A tool is named after its API section and operation: services_get_list, domains_create_record, service_backups_restore. Path and query parameters are top-level arguments, the request body goes under body:
{ "name": "domains_create_record", "arguments": { "domainId": 1, "body": { "type": "A", "name": "www", "content": "192.0.2.1" } } }Arguments are validated against the spec before anything is sent. API errors come back as tool errors with the API's status, error code and details. Rate-limited requests (the API allows 10 per second) are retried.
Tools that are not read-only act on the real account: orders and prolongations spend its balance, deleting or reinstalling a server destroys its data. They are annotated as destructive so clients can ask for confirmation; AEZA_READ_ONLY=1 removes them entirely. Deleting tools, reinstalling a server and restoring a backup are not exposed at all until you opt in with AEZA_ALLOW_DELETE=1; without it the model is told they are disabled and how to enable them.
bun install
bun start # run the server from source
bun run typecheck
bun test
bun publish # typechecks, tests and builds dist/ firstFile | |
| Downloads and caches the spec |
| Turns the spec into tool definitions: names, toolsets, JSON Schemas, and fixes for what the spec gets wrong |
| HTTP calls: API key, serialization, errors, retries |
| The MCP server |
| Snapshot of the real spec that the tests run against |
Created in T3 Code.
Create account payment method POST /account/payment-methods
Inputs: body (required).
Get account payment method by id GET /account/payment-methods/{id}
Inputs: id (required).
Get account payment methods GET /account/payment-methods
Inputs: sort, limit, filter, offset.
Change password PUT /accounts/me/password
Inputs: body (required).
Initiate phone change PUT /accounts/me/phone
Inputs: body (required).
Confirm change phone POST /accounts/me/phone/confirm
Inputs: body (required).
Get account info GET /accounts/me
Inputs: no named parameters.
Partially update current account (interface lang/theme, profile; legal only if billing region is RU). Currency is not changed here. PATCH /accounts/me
Inputs: body (required).
Send an email code to confirm a security setting change POST /accounts/me/security-confirmations
Inputs: body (required).
Verify an email code without consuming it POST /accounts/me/security-confirmations/verify
Inputs: body (required).
Create a new API key POST /api-keys
Inputs: body (required).
Edit your existing api key data PATCH /api-keys/{id}
Inputs: id (required), body (required).
Get all API keys GET /api-keys
Inputs: no named parameters.
Billing invoices create POST /billing/invoices
Inputs: body (required).
Billing invoices get invoice GET /billing/invoices/{id}
Inputs: id (required).
Billing payment methods get exchange rates GET /billing/payment-methods/{method}/exchange-rates
Inputs: method (required).
Get available payment methods Returns list of payment methods available for the authenticated user based on their region and account type GET /billing/payment-methods
Inputs: no named parameters.
Get transaction list GET /billing/transactions
Inputs: sort, limit, filter, offset.
Get transaction by id GET /billing/transactions/{id}
Inputs: id (required).
Bonuses activate POST /bonuses/{id}/activate
Inputs: id (required).
Bonuses activate bonus case POST /bonuses/bonus-case/{id}/activate
Inputs: id (required).
Get bonuses list GET /bonuses
Inputs: no named parameters.
Create company POST /companies
Inputs: body (required).
Own company invoices GET /companies/{id}/invoices
Inputs: id (required), sort, limit, filter, +1 more.
Own company (attached to account) GET /companies/own
Inputs: no named parameters.
Request KYB POST /companies/{id}/kyb/request
Inputs: id (required).
Request reseller status for company POST /companies/{id}/reseller/request
Inputs: id (required).
Update company PATCH /companies/{id}
Inputs: id (required), body (required).
Check domain availability POST /domains/check
Inputs: body (required).
Checks whether the given domain belongs to the caller, is registered in billing, and is fully delegated to our nameservers. POST /domains/check-delegation
Inputs: body (required).
Domains create POST /domains
Inputs: body (required).
Domains create record POST /domains/{domainId}/records
Inputs: body (required), domainId (required).
Domains edit record PATCH /domains/{domainId}/records/{recordId}
Inputs: body (required), domainId (required), recordId (required).
Domains get GET /domains/{id}
Inputs: id (required).
Get expected nameservers for domain delegation GET /domains/nameservers
Inputs: no named parameters.
Domains get list GET /domains
Inputs: sort, limit, filter, offset.
Domains get record GET /domains/{domainId}/records/{recordId}
Inputs: domainId (required), recordId (required).
Domains get records list GET /domains/{domainId}/records
Inputs: domainId (required), sort, limit, filter, +1 more.
Get supported DNS record types and validation filters GET /domains/record-types
Inputs: no named parameters.
Domains schedule ns check POST /domains/{id}/schedule-ns-check
Inputs: id (required).
Confirms ownership of a pending_verification zone by matching the _verify TXT record against its authoritative nameservers. POST /domains/{id}/verify
Inputs: id (required).
Get all user feature flags GET /feature-flags
Inputs: no named parameters.
Create presigned url to upload file POST /files
Inputs: body (required).
Save uploaded file POST /files/save
Inputs: body (required).
Gifts buy gift POST /gifts
Inputs: body (required).
Edit gift PUT /gifts/{id}
Inputs: id (required), body (required).
Gifts get by code GET /gifts/by-code/{code}
Inputs: code (required).
Get gift styles GET /gifts/styles
Inputs: no named parameters.
Gifts get owned gifts GET /gifts
Inputs: no named parameters.
Gifts regen POST /gifts/{id}/regen
Inputs: id (required).
Gifts use code POST /gifts/by-code/{code}/use
Inputs: code (required).
Leakcheck leack check GET /leakcheck/aeza
Inputs: no named parameters.
Get list of user notifications GET /notifications
Inputs: sort, limit, filter, offset.
Get notification by ID GET /notifications/{id}
Inputs: id (required).
Mark all notifications as read POST /notifications/read
Inputs: no named parameters.
Mark notification as read POST /notifications/{id}/read
Inputs: id (required).
Other get errors GET /errors
Inputs: no named parameters.
Other get health GET /health
Inputs: no named parameters.
Other get info GET /info
Inputs: no named parameters.
Other get version GET /version
Inputs: no named parameters.
Unsubscribe from unwanted mailings. POST /unsubscribe
Inputs: body (required).
Use giftcode POST /promo/giftcodes/{code}/use
Inputs: code (required).
Recurrent payments create recurrent payment config POST /billing/recurrent-payments/configure
Inputs: body (required).
Recurrent payments get current recurrent payment config GET /billing/recurrent-payments/config
Inputs: no named parameters.
Recurrent payments update recurrent payment config PATCH /billing/recurrent-payments/config
Inputs: body (required).
Get rolling earned stats of all the account referral programs (one point per day) GET /referral-programs/daily-stats
Inputs: no named parameters.
Get default referral program GET /referral-programs
Inputs: no named parameters.
Get referral program operations history GET /referral-programs/history
Inputs: sort, limit, filter, offset.
Get referral tiers GET /referral-programs/tiers
Inputs: no named parameters.
Get top referral programs GET /referral-programs/top
Inputs: no named parameters.
Create backup POST /services/{serviceId}/backups
Inputs: body (required), serviceId (required).
Disable backups POST /services/{serviceId}/backups/disable
Inputs: serviceId (required).
Enable backups POST /services/{serviceId}/backups/enable
Inputs: body (required), serviceId (required).
Get backups price GET /services/{serviceId}/backups/price
Inputs: serviceId (required).
Get backups GET /services/{serviceId}/backups
Inputs: serviceId (required), sort, limit, filter, +1 more.
Set schedule for service POST /services/{serviceId}/backups/schedule
Inputs: body (required), serviceId (required).
Get service product groups list GET /services/groups
Inputs: type.
Get service products list GET /services/products
Inputs: type, group.
Get PM module commands schema (client view) Returns a list of commands supported by the specified PM module GET /services/products/commands-schema
Inputs: pm (required).
Get PM module parameters schema (client view) Returns a list of product-determining parameters of the specified PM module GET /services/products/parameters-schema
Inputs: pm (required).
Change service password POST /services/{id}/change-password
Inputs: id (required), body (required).
Pay and switch service to another product in the same group POST /services/{id}/change-product
Inputs: id (required), body (required).
Create vnc connection POST /services/{id}/remote/vnc
Inputs: id (required).
Edit your service data PATCH /services/{id}
Inputs: id (required), body (required).
Enter to rescue mode POST /services/{id}/rescue
Inputs: id (required).
Get service by id GET /services/{id}
Inputs: id (required).
Get prorated price for switching service to another product in the same group GET /services/{id}/change-product
Inputs: id (required), productId (required).
Get service computed parameters GET /services/{id}/computed-parameters
Inputs: id (required).
Get services that are about to expire GET /services/expiring
Inputs: no named parameters.
Get services list GET /services
Inputs: sort, limit, filter, offset.
Get service price breakdown GET /services/{id}/price
Inputs: id (required).
Get computed total price for each payment term from product rawPrices GET /services/{id}/prices
Inputs: id (required).
Get service usage stats GET /services/{id}/stats/{statType}
Inputs: id (required), toDate (required), fromDate (required), statType (required), +1 more.
Get goto link for service POST /services/{id}/goto
Inputs: id (required).
Leave rescue mode POST /services/{id}/rescue/leave
Inputs: id (required).
Services limits get list GET /services/limits
Inputs: no named parameters.
Migrate service to new product from legacy product POST /services/{id}/migrate
Inputs: id (required).
Buy IPv4 address for service POST /services/{serviceId}/networks/ipv4
Inputs: body (required), serviceId (required).
Change (replace) IPv4 address for a one-time payment POST /services/{serviceId}/networks/ipv4/{externalId}/change
Inputs: body (required), serviceId (required), externalId (required).
Edit PTR record POST /services/{serviceId}/networks/ipv4/{externalId}/edit-ptr
Inputs: body (required), serviceId (required), externalId (required).
Services networks ipv4 get list GET /services/{serviceId}/networks/ipv4
Inputs: serviceId (required).
Services networks ipv4 get price GET /services/{serviceId}/networks/ipv4/price
Inputs: serviceId (required).
Services networks ipv6 get list GET /services/{serviceId}/networks/ipv6
Inputs: serviceId (required).
Make netork as main POST /services/{serviceId}/networks/ipv4/{externalId}/make-main
Inputs: serviceId (required), externalId (required).
Services operating systems get list GET /services/operating-systems
Inputs: sort, limit, filter, offset.
Services operating systems get recipes list GET /services/operating-systems/recipes
Inputs: no named parameters.
Create service order POST /services/orders
Inputs: body (required).
Get price for product with parameters GET /services/orders/price
Inputs: productId (required), termCount, paymentTerm, isBackupsEnabled, +1 more.
Prolong service POST /services/{id}/prolong
Inputs: id (required), body (required).
Prolong multiple services POST /services/prolong/bulk
Inputs: body (required).
Add additional resources to service POST /services/{id}/additional-resources
Inputs: id (required), body (required).
Get additional resources price POST /services/{id}/additional-resources/get-price
Inputs: id (required), body (required).
Get service resources information GET /services/{id}/resources
Inputs: id (required).
Restart service POST /services/{id}/ctl/restart
Inputs: id (required), body (required).
Resume service POST /services/{id}/ctl/resume
Inputs: id (required).
Send command to service pm with service POST /services/{id}/command/{command}
Inputs: id (required), body (required), command (required).
Send command to service pm POST /services/command/{command}
Inputs: pm (required), body (required), command (required).
Create SSH key POST /services/ssh-keys
Inputs: body (required).
Edit SSH key PATCH /services/ssh-keys/{sshKeyId}
Inputs: body (required), sshKeyId (required).
Get SSH key by id GET /services/ssh-keys/{sshKeyId}
Inputs: sshKeyId (required).
Get SSH keys list GET /services/ssh-keys
Inputs: sort, limit, filter, offset.
Get service static info by key GET /services/static-links
Inputs: key (required).
Suspend service POST /services/{id}/ctl/suspend
Inputs: id (required), body (required).
Get service product types list GET /services/types
Inputs: limit, offset.
Get active sessions GET /sessions
Inputs: no named parameters.
Get sso links GET /sso
Inputs: no named parameters.
Link sso-method to account POST /sso
Inputs: body (required).
Mark ticket as solved POST /support/tickets/{id}/archive
Inputs: id (required).
Active support categories for ticket creation form GET /support/categories
Inputs: no named parameters.
Create ticket POST /support/tickets
Inputs: body (required).
Get average support first response time (sec) over last 7 days GET /support/average-response-time
Inputs: no named parameters.
Get ticket list GET /support/tickets
Inputs: no named parameters.
Get ticket messages GET /support/tickets/{id}/messages
Inputs: id (required).
Get ticket info GET /support/tickets/{id}
Inputs: id (required).
Get opened ticket count GET /support/tickets/count
Inputs: no named parameters.
Send message to gpt POST /support/gpt
Inputs: body (required).
Get ticket rate info GET /support/tickets/{id}/rate
Inputs: id (required).
Get CloudTips recipients for a ticket GET /support/tickets/{id}/rate/tips/cloudtips
Inputs: id (required).
Get ticket tips GET /support/tickets/{id}/rate/tips
Inputs: id (required).
Rate ticket POST /support/tickets/{id}/rate
Inputs: id (required), body (required).
Tip ticket POST /support/tickets/{id}/rate/tips
Inputs: id (required), body (required).
Mark ticket as read POST /support/tickets/{id}/read
Inputs: id (required).
Send message to ticket POST /support/tickets/{id}/messages
Inputs: id (required), body (required).
Set reaction to support message PATCH /support/tickets/{id}/messages/{messageId}/reaction
Inputs: id (required), body (required), messageId (required).
Get active system alerts by slots GET /system/alerts
Inputs: slots (required).
Get withdraw limits GET /withdraws/limits
Inputs: no named parameters.
Get withdraws GET /withdraws
Inputs: limit, offset.
Get withdraw methods GET /withdraws/methods
Inputs: no named parameters.
Init new withdraw POST /withdraws
Inputs: body (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Verified, pay-per-use API tools for AI agents through one authenticated connection.
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
AI-callable tools for API mocking, testing, monitoring, security, and automation.
The OpenRouter for tools. One MCP connection gives any AI agent 254 hosted tools, pay per call.