contabo-mcp
Provides tools covering the entire Contabo API, enabling AI agents to manage VPS/VDS instances, snapshots, images, object storage, private networks, firewalls, DNS, domains, secrets, users, and tags. Includes one tool per API operation, with optional read-only mode and tool filtering.
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., "@contabo-mcp List my Contabo VPS instances 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.
contabo-mcp
An MCP server that gives AI agents the entire Contabo API: VPS/VDS instances, snapshots, images, object storage, private networks, firewalls, DNS, domains, secrets, users, tags and troubleshooting. It is generated from Contabo's official OpenAPI spec, so every one of the 158 operations is available as a tool.
One tool per API operation, with typed JSON-schema inputs and
readOnly/destructiveannotationsOAuth2 handled for you: token fetched, cached, refreshed on expiry and on
401Safety switches: read-only mode, tool groups, exclusion list
Resilient: timeouts, retry with backoff on
429/5xxfor reads, response size capWorks with Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Cline, Codex, Gemini CLI, Zed, OpenCode and any stdio MCP client
Quick start
Requires Node.js 18.17+ and Contabo API credentials (my.contabo.com → Account → Security & Access → API: Client ID, Client Secret, API user, API password).
git clone https://github.com/Kirad20/contabo-mcp
cd contabo-mcp
npm install
npm test # offline smoke test, no credentials neededThen register the server in your agent. Example for Claude Code:
claude mcp add contabo \
-e CONTABO_CLIENT_ID=... -e CONTABO_CLIENT_SECRET=... \
-e CONTABO_API_USER=... -e CONTABO_API_PASSWORD=... \
-e CONTABO_READ_ONLY=1 \
-- node /absolute/path/to/contabo-mcp/src/index.jsReady-made configs for every supported agent are in examples/ and explained in docs/CONFIGURATION.md.
Start read-only.
CONTABO_READ_ONLY=1exposes only the 72 GET tools. Remove it only when you want the agent to create, change or delete resources (which can cost money or destroy data).
Related MCP server: Cloudways MCP Server
Try it
Once connected, ask your agent things like:
"List my Contabo instances and their status."
"Which of my VPS have no firewall assigned?"
"Create a snapshot of instance 12345 called
before-upgrade.""Add an A record for
app.example.compointing to my instance IP."
More in docs/USAGE.md.
Configuration at a glance
Variable | Purpose |
| Required. API credentials |
| Only GET tools |
| Only these tool groups |
| Drop the 17 audit-log tools |
| Drop specific tools |
| Shorter schemas (~45% fewer tokens) |
| Network behaviour |
Full list and details: docs/CONFIGURATION.md. The complete tool list is in docs/TOOLS.md.
Why filter tools?
All 158 tools together weigh ~165 KB of schema, which is a lot of context for the model. Pick the groups you need (CONTABO_GROUPS), enable CONTABO_COMPACT, or both. For example CONTABO_GROUPS="compute instances" CONTABO_COMPACT=1 loads 25 small tools.
Documentation
Doc | Contents |
Credentials, every env var, setup per agent | |
Calling conventions, pagination, example workflows | |
All 158 tools by group | |
Credential handling, least privilege, risks | |
Common errors and fixes | |
Architecture, updating the spec, tests | |
Release notes |
Disclaimer
Unofficial community project, not affiliated with Contabo GmbH. You are responsible for any resources created, changed or deleted through your credentials.
License
MIT, see LICENSE.
Available Tools
158 toolsassign_instance_firewallC
Add instance to a firewall [POST /v1/firewalls/{firewallId}/instances/{instanceId}] Add a specific instance to a firewall
Inputs: firewallId (required), instanceId (required), x-trace-id.
assign_instance_private_networkB
Add instance to a Private Network [POST /v1/private-networks/{privateNetworkId}/instances/{instanceId}] Add a specific instance to a Private Network
Inputs: instanceId (required), privateNetworkId (required), x-trace-id.
assign_ipB
Assign a VIP to an VPS/VDS/Bare Metal [POST /v1/vips/{ip}/{resourceType}/{resourceId}] Assign a VIP to a VPS/VDS/Bare Metal using the machine id.
Inputs: ip (required), resourceId (required), resourceType (required), x-trace-id.
bulk_delete_dns_zone_recordsBDestructiveIdempotent
Bulk delete DNS zone records [DELETE /v1/dns/zones/{zoneName}/records/bulk] Delete multiple zone records from a DNS Zone
Inputs: body (required), zoneName (required), x-trace-id.
cancel_domainC
Cancel a specific domain [POST /v1/domains/{domain}/cancel] Cancel a specific domain
Inputs: body (required), domain (required), x-trace-id.
cancel_ext_checkC
Cancel check [PATCH /v1/troubleshooting/checks/{checkId}] Cancel check
Inputs: body (required), checkId (required), x-trace-id.
cancel_ext_check_collectionC
Cancel check collection [PATCH /v1/troubleshooting/check-collections/{checkCollectionId}] Cancel check collection
Inputs: body (required), checkCollectionId (required), x-trace-id.
cancel_ext_remedyC
Cancel remedy [PATCH /v1/troubleshooting/remedies/{remedyId}] Cancel remedy
Inputs: body (required), remedyId (required), x-trace-id.
cancel_instanceB
Cancel specific instance by id [POST /v1/compute/instances/{instanceId}/cancel] Your are free to cancel a previously created instance at any time.
Inputs: body (required), instanceId (required), x-trace-id.
cancel_object_storageB
Cancels the specified object storage at the next possible date [PATCH /v1/object-storages/{objectStorageId}/cancel] Cancels the specified object storage at the next possible date. Please be aware of your contract periods.
Inputs: body (required), objectStorageId (required), x-trace-id.
check_set_new_hostARead-onlyIdempotent
Check if the instance can be moved to another host [GET /v1/compute/instances/{instanceId}/regionChange/check] Verifies preconditions with CMS before relocating the instance from its current host. Returns no content when the check succeeds. When CMS responds with an error list, returns that payload with the same HTTP status as CMS.
Inputs: instanceId (required), x-trace-id.
confirm_domain_transfer_outC
Confirm transfer out for a domain [POST /v1/domains/{domain}/transfer-out] Confirm transfer out for a domain
Inputs: domain (required), x-trace-id.
create_assignmentB
Create a new assignment for the tag [POST /v1/tags/{tagId}/assignments/{resourceType}/{resourceId}] Create a new tag assignment. This marks the specified resource with the specified tag for organizing purposes or to restrict access to that resource.
Inputs: tagId (required), resourceId (required), resourceType (required), x-trace-id.
create_custom_imageA
Provide a custom image [POST /v1/compute/images]
In order to provide a custom image please specify an URL from where the image can be directly downloaded. A custom image must be in either .iso or .qcow2 format. Other formats will be rejected. Please note that downloading can take a while depending on network speed resp. bandwidth and size of image. You can check the status by retrieving information about the image via a GET request. Download will be rejected if you have exceeded your limits.
Inputs: body (required), x-trace-id.
create_dns_zoneB
Create DNS zone [POST /v1/dns/zones] Creates a new DNS zone for a customer
Inputs: body (required), x-trace-id.
create_dns_zone_recordC
Create DNS zone record [POST /v1/dns/zones/{zoneName}/records] Create resource record in a zone
Inputs: body (required), zoneName (required), x-trace-id.
create_firewallB
Create a new firewall definition [POST /v1/firewalls] Create a new firewall definition by specifying its name and a set of rules. The status of the firewall determines whether the rules are active or not.
Inputs: body (required), x-trace-id.
create_handleC
Create specific handle [POST /v1/domains/handles] Create specific handle
Inputs: body (required), x-trace-id.
create_instanceC
Create a new instance [POST /v1/compute/instances] Create a new instance for your account with the provided parameters. ProductIdProductDisk Size V153Cloud VPS 4100 GB SSD V154Cloud VPS 6200 GB SSD V155Cloud VPS 8300 GB SSD V156Cloud VPS 12400 GB SSD V157Cloud VPS 16<td...
Inputs: body (required), x-trace-id.
create_object_storageA
Create a new object storage [POST /v1/object-storages]
Create / purchase a new object storage in your account. Please note that you can only buy one object storage per location. You can actually increase the object storage space via POST to /v1/object-storages/{objectStorageId}/resize
Inputs: body (required), x-trace-id.
create_private_networkC
Create a new Private Network [POST /v1/private-networks] Create a new Private Network in your account.
Inputs: body (required), x-trace-id.
create_ptr_recordB
Create a new PTR Record using ip address [POST /v1/dns/ptrs] Create a new PTR Record using ip address. Only IPv6 can be created
Inputs: body (required), x-trace-id.
create_roleA
Create a new role [POST /v1/roles]
Create a new role. In order to get a list availbale api enpoints (apiName) and their actions please refer to the GET api-permissions endpoint. For specifying resources please enter tag ids. For those to take effect please assign them to a resource in the tag management api.
Inputs: body (required), x-trace-id.
create_secretB
Create a new secret [POST /v1/secrets] Create a new secret in your account with attributes name, type and value. Attribute type can be password or ssh.
Inputs: body (required), x-trace-id.
create_snapshotB
Create a new instance snapshot [POST /v1/compute/instances/{instanceId}/snapshots] Create a new snapshot for instance, with name and description attributes
Inputs: body (required), instanceId (required), x-trace-id.
create_tagB
Create a new tag [POST /v1/tags] Create a new tag in your account with attribute name and optional attribute color.
Inputs: body (required), x-trace-id.
create_userA
Create a new user [POST /v1/users] Create a new user with required attributes firstName, lastName, email, enabled, totp (=Two-factor authentication 2FA), admin (=access to all endpoints and resources), accessAllResources and roles. You can't specify any password / secrets for the user. For security reasons the user will have to specify secrets on his own.
Inputs: body (required), x-trace-id.
delete_assignmentADestructiveIdempotent
Delete existing tag assignment [DELETE /v1/tags/{tagId}/assignments/{resourceType}/{resourceId}] Tag assignment will be removed from the specified resource. If this tag is being used for access restrictions the affected users will no longer be able to access that resource.
Inputs: tagId (required), resourceId (required), resourceType (required), x-trace-id.
delete_dns_zoneCDestructiveIdempotent
Delete a DNS zone. [DELETE /v1/dns/zones/{zoneName}] Delete a DNS Zone using zone name.
Inputs: zoneName (required), x-trace-id.
delete_dns_zone_recordCDestructiveIdempotent
Delete a DNS zone record [DELETE /v1/dns/zones/{zoneName}/records/{recordId}] Delete a DNZ Zone's record
Inputs: recordId (required), zoneName (required), x-trace-id.
delete_firewallADestructiveIdempotent
Delete existing firewall by id [DELETE /v1/firewalls/{firewallId}] Delete existing firewall by id. A firewall cannot be deleted if there are instances attached to it.
Inputs: firewallId (required), x-trace-id.
delete_imageBDestructiveIdempotent
Delete an uploaded custom image by its id [DELETE /v1/compute/images/{imageId}] Your are free to delete a previously uploaded custom images at any time
Inputs: imageId (required), x-trace-id.
delete_private_networkADestructiveIdempotent
Delete existing Private Network by id [DELETE /v1/private-networks/{privateNetworkId}] Delete existing Virtual Private Cloud by id and automatically unassign all instances from it
Inputs: privateNetworkId (required), x-trace-id.
delete_ptr_recordADestructiveIdempotent
Delete a PTR Record using ip address [DELETE /v1/dns/ptrs/{ipAddress}] Delete a PTR Record using ip address. Only IPv6 can be deleted
Inputs: ipAddress (required), x-trace-id.
delete_roleADestructiveIdempotent
Delete existing role by id [DELETE /v1/roles/{roleId}] You can't delete a role if it is still assigned to a user. In such cases please remove the role from the users.
Inputs: roleId (required), x-trace-id.
delete_secretADestructiveIdempotent
Delete existing secret by id [DELETE /v1/secrets/{secretId}] You can remove a specific secret from your account.
Inputs: secretId (required), x-trace-id.
delete_snapshotCDestructiveIdempotent
Delete existing snapshot by id [DELETE /v1/compute/instances/{instanceId}/snapshots/{snapshotId}] Delete existing instance snapshot by id
Inputs: instanceId (required), snapshotId (required), x-trace-id.
delete_tagADestructiveIdempotent
Delete existing tag by id [DELETE /v1/tags/{tagId}] Your tag can be deleted if it is not assigned to any resource on your account. Check tag assigments before deleting tag.
Inputs: tagId (required), x-trace-id.
delete_userADestructiveIdempotent
Delete existing user by id [DELETE /v1/users/{userId}]
By deleting a user he will not be able to access any endpoints or resources any longer. In order to temporarily disable a user please update its enabled attribute.
Inputs: userId (required), x-trace-id.
generate_client_secretCIdempotent
Generate new client secret [PUT /v1/users/client/secret] Generate and get new client secret.
Inputs: x-trace-id.
generate_sso_tokenB
Generate one time SSO token [POST /v1/users/sso-token] Generate an one time SSO token for the authenticated user account.
Inputs: x-trace-id.
get_auth_codeC
Get auth code for a domain [POST /v1/domains/{domain}/generate-auth-code] Get auth code for a domain by id
Inputs: domain (required), x-trace-id.
get_ext_checkARead-onlyIdempotent
Get check [GET /v1/troubleshooting/checks/{checkId}] Get a single check by id
Inputs: checkId (required), x-trace-id.
get_ext_check_collectionBRead-onlyIdempotent
Get check collection [GET /v1/troubleshooting/check-collections/{checkCollectionId}] Get a single check collection by id
Inputs: checkCollectionId (required), x-trace-id, excludeCheckStatuses.
get_ext_check_collection_templateBRead-onlyIdempotent
Get check [GET /v1/troubleshooting/check-collection-templates/{checkCollectionTemplateId}] Get a single check collection template by id
Inputs: checkCollectionTemplateId (required), x-trace-id.
get_ext_remedyCRead-onlyIdempotent
Get remedy [GET /v1/troubleshooting/remedies/{remedyId}] Get a single remedy by id
Inputs: remedyId (required), x-trace-id.
get_object_storage_credentialsBRead-onlyIdempotent
Get S3 compatible object storage credentials. [GET /v1/users/{userId}/object-storages/{objectStorageId}/credentials/{credentialId}]
Get S3 compatible object storage credentials for accessing it via S3 compatible tools like aws cli.
Inputs: userId (required), credentialId (required), objectStorageId (required), x-trace-id.
instance_rescueA
Rescue a compute instance / resource identified by its id [POST /v1/compute/instances/{instanceId}/actions/rescue] You can reboot your instance in rescue mode to resolve system issues. Rescue system is Linux based and its booted instead of your regular operating system. The disk containing your operating sytstem, software and your data is already mounted for you to access and repair/modify files. After a reboot your compute instance will boot your operating system. Please note that this is for advanced users.
Inputs: body (required), instanceId (required), x-trace-id.
instance_reset_passwordB
Reset password for a compute instance / resource referenced by an id [POST /v1/compute/instances/{instanceId}/actions/resetPassword] Reset password for a compute instance / resource referenced by an id. This will reset the current password to the password that you provided in the body of this request.
Inputs: body (required), instanceId (required), x-trace-id.
instance_restartB
Restart a compute instance / resource identified by its id. [POST /v1/compute/instances/{instanceId}/actions/restart] To restart a compute instance that has been identified by its id, you should perform a restart action on it.
Inputs: instanceId (required), x-trace-id.
instance_shutdownA
Shutdown compute instance / resource by its id [POST /v1/compute/instances/{instanceId}/actions/shutdown] Shutdown an compute instance / resource. This is similar to pressing the power button on a physical machine. This will send an ACPI event for the guest OS, which should then proceed to a clean shutdown.
Inputs: instanceId (required), x-trace-id.
instance_startB
Start a compute instance / resource identified by its id [POST /v1/compute/instances/{instanceId}/actions/start] Starting a compute instance / resource is like powering on a real server. If the compute instance / resource is already started nothing will happen. You may check the current status anytime when getting information about a compute instance / resource.
Inputs: instanceId (required), x-trace-id.
instance_stopA
Stop compute instance / resource by its id [POST /v1/compute/instances/{instanceId}/actions/stop] Stopping a compute instance / resource is like powering off a real server. So please be aware that data may be lost. Alternatively you may log in and shut your compute instance / resource gracefully via the operating system. If the compute instance / resource is already stopped nothing will happen. You may check the current status anytime when getting information about a compute instance / resource.
Inputs: instanceId (required), x-trace-id.
list_domainsBRead-onlyIdempotent
List all domains [GET /v1/domains] List and filter all your domains
Inputs: sld, tld, page, size, +4 more.
list_ext_check_collectionsBRead-onlyIdempotent
List check collections [GET /v1/troubleshooting/check-collections] List and filter all check collections
Inputs: page, size, orderBy, objectId, +8 more.
list_ext_check_collection_templatesBRead-onlyIdempotent
List check collection templates [GET /v1/troubleshooting/check-collection-templates] List and filter all check collection templates
Inputs: page, size, orderBy, objectType, +5 more.
list_ext_checksCRead-onlyIdempotent
List check [GET /v1/troubleshooting/checks] List and filter all check
Inputs: page, size, status, orderBy, +9 more.
list_ext_remediesCRead-onlyIdempotent
List remedy [GET /v1/troubleshooting/remedies] List and filter all remedy
Inputs: page, size, status, orderBy, +9 more.
list_handlesBRead-onlyIdempotent
List all handles [GET /v1/domains/handles] List and filter all your handles
Inputs: name, page, size, search, +7 more.
list_object_storage_credentialsBRead-onlyIdempotent
Get list of S3 compatible object storage credentials for user. [GET /v1/users/{userId}/object-storages/credentials]
Get list of S3 compatible object storage credentials for accessing it via S3 compatible tools like aws cli.
Inputs: userId (required), page, size, orderBy, +4 more.
list_pending_actionsARead-onlyIdempotent
List pending domain actions [GET /v1/domains/pending-actions] List the calling customer's domains with an unacknowledged outbound transfer (ACK/NACK) pending. Live OpusDNS read for OpusDNS-routed customers; empty payload (no upstream call) for everyone else.
Inputs: x-trace-id.
list_user_accountsCRead-onlyIdempotent
List of your accounts [GET /v1/me/accounts] List of your accounts
Inputs: page, size, email, default, +2 more.
make_default_accountC
Make user account default [PATCH /v1/me/account/{tenantId}/{customerId}] Make user account default
Inputs: body (required), tenantId (required), customerId (required), x-trace-id.
order_domainC
Create or transfer a domain [POST /v1/domains] Create or transfer a domain
Inputs: body (required), x-trace-id.
patch_firewallC
Update a firewall by id [PATCH /v1/firewalls/{firewallId}] Update a firewall by id in your account.
Inputs: body (required), firewallId (required), x-trace-id.
patch_instanceC
Update specific instance [PATCH /v1/compute/instances/{instanceId}] Update specific instance by instanceId.
Inputs: body (required), instanceId (required), x-trace-id.
patch_private_networkC
Update a Private Network by id [PATCH /v1/private-networks/{privateNetworkId}] Update a Private Network by id in your account.
Inputs: body (required), privateNetworkId (required), x-trace-id.
put_firewallBIdempotent
Update specific firewall rules [PUT /v1/firewalls/{firewallId}] Set rules for a specific firewall. Currently only inbound rules are allowed to be configured.
Inputs: body (required), firewallId (required), x-trace-id.
regenerate_object_storage_credentialsC
Regenerates secret key of specified user for the S3 compatible object storages. [PATCH /v1/users/{userId}/object-storages/{objectStorageId}/credentials/{credentialId}] Regenerates secret key of specified user for the a specific S3 compatible object storages.
Inputs: userId (required), credentialId (required), objectStorageId (required), x-trace-id.
reinstall_instanceBIdempotent
Reinstall specific instance [PUT /v1/compute/instances/{instanceId}] You can reinstall a specific instance with a new image and optionally add ssh keys, a root password or cloud-init.
Inputs: body (required), instanceId (required), x-trace-id.
remove_handleCDestructiveIdempotent
Remove specific handle [DELETE /v1/domains/handles/{handleId}] Remove specific handle
Inputs: handleId (required), x-trace-id.
request_email_changeA
Request email change [POST /v1/users/{userId}/mail-change-requests] Request an email change for the specified user. Available to account owners and sub-users alike, but only for their own identity: the userId must be the subject of the access token.
Inputs: userId (required), x-trace-id.
request_recovery_codes_resetA
Request recovery codes reset [POST /v1/users/{userId}/recovery-codes-reset-requests] Marks the user to generate new recovery codes on next login. Only for the own identity: the userId must be the subject of the access token.
Inputs: userId (required), x-trace-id.
request_region_changeA
Request instance region change [POST /v1/compute/instances/{instanceId}/regionChange] Starts a region change for the instance via CMS. Returns the support ticket number when the operation was accepted.
Inputs: body (required), instanceId (required), x-trace-id.
resend_email_verificationC
Resend email verification [POST /v1/users/{userId}/resend-email-verification] Resend email verification for a specific user
Inputs: userId (required), x-trace-id, redirectUrl.
reset_passwordC
Send reset password email [POST /v1/users/{userId}/reset-password] Send reset password email for a specific user
Inputs: userId (required), x-trace-id, redirectUrl.
retrieve_api_permissions_listARead-onlyIdempotent
List of API permissions [GET /v1/roles/api-permissions] List all available API permissions. This list serves as a reference for specifying roles. As endpoints differ in their possibilities not all actions are available for each endpoint.
Inputs: page, size, apiName, orderBy, +1 more.
retrieve_assignmentBRead-onlyIdempotent
Get specific assignment for the tag [GET /v1/tags/{tagId}/assignments/{resourceType}/{resourceId}] Get attributes for a specific tag assignment in your account. For this the resource type and resource id is required.
Inputs: tagId (required), resourceId (required), resourceType (required), x-trace-id.
retrieve_assignment_listBRead-onlyIdempotent
List tag assignments [GET /v1/tags/{tagId}/assignments] List and filter all existing assignments for a tag in your account
Inputs: tagId (required), page, size, orderBy, +2 more.
retrieve_assignments_audits_listBRead-onlyIdempotent
List history about your assignments (audit) [GET /v1/tags/assignments/audits] List and filters the history about your assignments.
Inputs: page, size, tagId, endDate, +6 more.
retrieve_available_instance_productsARead-onlyIdempotent
Get the available products of a specific instance [GET /v1/compute/instances/{instanceId}/products/available]
Get all products the instance can be upgraded to, excluding the currently assigned one. Use the offerId of the desired product to submit the upgrade.
Inputs: instanceId (required), x-trace-id.
retrieve_custom_images_statsARead-onlyIdempotent
List statistics regarding the customer's custom images [GET /v1/compute/images/stats] List statistics regarding the customer's custom images such as the number of custom images uploaded, used disk space, free available disk space and total available disk space
Inputs: x-trace-id.
retrieve_data_center_listBRead-onlyIdempotent
List data centers [GET /v1/data-centers] List all data centers and their corresponding regions.
Inputs: name, page, size, slug, +4 more.
retrieve_dns_audits_listBRead-onlyIdempotent
List history about your DNS Zones (audit) [GET /v1/dns/zones/audits] List and filters the history about your DNS Zones .
Inputs: name, page, size, endDate, +5 more.
retrieve_dns_zoneARead-onlyIdempotent
Retrieve a DNS Zone by zone name [GET /v1/dns/zones/{zoneName}] Get all attributes for a specific DNS Zone
Inputs: zoneName (required), x-trace-id.
retrieve_dns_zone_records_listBRead-onlyIdempotent
List a DNS Zone's records [GET /v1/dns/zones/{zoneName}/records] Get all the records of a DNS Zone
Inputs: zoneName (required), page, size, search, +2 more.
retrieve_dns_zones_listCRead-onlyIdempotent
List DNS zones [GET /v1/dns/zones] Get a list of all zones
Inputs: page, size, orderBy, tenantId, +3 more.
retrieve_domainCRead-onlyIdempotent
List specific domain [GET /v1/domains/{domain}] List specific domain
Inputs: domain (required), x-trace-id.
retrieve_domains_audits_listBRead-onlyIdempotent
List history about your Domains (audit) [GET /v1/domains/audits] List and filters the history about your Domains.
Inputs: page, size, domain, endDate, +5 more.
retrieve_firewallARead-onlyIdempotent
Get specific firewall by its id [GET /v1/firewalls/{firewallId}] Get data for a specific firewall on your account.
Inputs: firewallId (required), name, page, size, +3 more.
retrieve_firewall_audits_listBRead-onlyIdempotent
List history about your Firewalls (audit) [GET /v1/firewalls/audits] List and filters the history about your Firewalls.
Inputs: page, size, endDate, orderBy, +5 more.
retrieve_firewall_listCRead-onlyIdempotent
List all firewalls [GET /v1/firewalls] List and filter all firewalls on your account
Inputs: name, page, size, orderBy, +2 more.
retrieve_handleCRead-onlyIdempotent
Get specific handle [GET /v1/domains/handles/{handleId}] Get specific handle
Inputs: handleId (required), x-trace-id.
retrieve_handles_audits_listBRead-onlyIdempotent
List history about your handles (audit) [GET /v1/domains/handles/audits] List and filters the history about your handles.
Inputs: page, size, endDate, orderBy, +5 more.
retrieve_imageARead-onlyIdempotent
Get details about a specific image by its id [GET /v1/compute/images/{imageId}] Get details about a specific image. This could be either a standard or custom image. In case of an custom image you can also check the download status
Inputs: imageId (required), x-trace-id.
retrieve_image_audits_listBRead-onlyIdempotent
List history about your custom images (audit) [GET /v1/compute/images/audits] List and filters the history about your custom images.
Inputs: page, size, endDate, imageId, +5 more.
retrieve_image_listBRead-onlyIdempotent
List available standard and custom images [GET /v1/compute/images] List and filter all available standard images provided by Contabo and your uploaded custom images.
Inputs: gpu, name, page, size, +4 more.
retrieve_instanceBRead-onlyIdempotent
Get specific instance by id [GET /v1/compute/instances/{instanceId}] Get attributes values to a specific instance on your account.
Inputs: instanceId (required), x-trace-id.
retrieve_instances_actions_audits_listBRead-onlyIdempotent
List history about your actions (audit) triggered via the API [GET /v1/compute/instances/actions/audits] List and filters the history about your actions your triggered via the API.
Inputs: page, size, endDate, orderBy, +5 more.
retrieve_instances_audits_listCRead-onlyIdempotent
List history about your instances (audit) [GET /v1/compute/instances/audits] List and filters the history about your instances.
Inputs: page, size, endDate, orderBy, +5 more.
retrieve_instances_listBRead-onlyIdempotent
List instances [GET /v1/compute/instances] List and filter all instances in your account
Inputs: name, page, size, region, +15 more.
retrieve_object_storageBRead-onlyIdempotent
Get specific object storage by its id [GET /v1/object-storages/{objectStorageId}] Get data for a specific object storage on your account.
Inputs: objectStorageId (required), x-trace-id.
retrieve_object_storage_audits_listBRead-onlyIdempotent
List history about your object storages (audit) [GET /v1/object-storages/audits] List and filters the history about your object storages.
Inputs: page, size, endDate, orderBy, +5 more.
retrieve_object_storage_listBRead-onlyIdempotent
List all your object storages [GET /v1/object-storages] List and filter all object storages in your account
Inputs: page, size, region, orderBy, +4 more.
retrieve_object_storages_statsARead-onlyIdempotent
List usage statistics about the specified object storage [GET /v1/object-storages/{objectStorageId}/stats] List usage statistics about the specified object storage such as the number of objects uploaded / created, used object storage space. Please note that the usage statistics are updated regularly and are not live usage statistics.
Inputs: objectStorageId (required), x-trace-id.
retrieve_preset_rulesBRead-onlyIdempotent
Get all preset rules [GET /v1/firewalls/preset-rules]
Inputs: name, page, size, orderBy, +1 more.
retrieve_private_networkARead-onlyIdempotent
Get specific Private Network by id [GET /v1/private-networks/{privateNetworkId}] Get attributes values to a specific Private Network on your account.
Inputs: privateNetworkId (required), x-trace-id.
retrieve_private_network_audits_listBRead-onlyIdempotent
List history about your Private Networks (audit) [GET /v1/private-networks/audits] List and filters the history about your Private Networks.
Inputs: page, size, endDate, orderBy, +5 more.
retrieve_private_network_listBRead-onlyIdempotent
List Private Networks [GET /v1/private-networks] List and filter all Private Networks in your account
Inputs: name, page, size, region, +4 more.
retrieve_ptr_recordARead-onlyIdempotent
Retrieve a PTR Record by ip address [GET /v1/dns/ptrs/{ipAddress}] Get all attributes for a specific PTR Record
Inputs: ipAddress (required), x-trace-id.
retrieve_ptr_records_listBRead-onlyIdempotent
List PTR records [GET /v1/dns/ptrs] Get a list of all PTR records, either customer or a list of IPs is required
Inputs: ips, page, size, search, +4 more.
retrieve_record_audits_listBRead-onlyIdempotent
List history about your DNS Records (audit) [GET /v1/dns/records/audits] List and filter the history of changes made to your DNS Records.
Inputs: page, size, endDate, orderBy, +5 more.
retrieve_roleARead-onlyIdempotent
Get specific role by id [GET /v1/roles/{roleId}] Get attributes of specific role.
Inputs: roleId (required), x-trace-id.
retrieve_role_audits_listCRead-onlyIdempotent
List history about your roles (audit) [GET /v1/roles/audits] List and filter the history about your roles.
Inputs: page, size, roleId, endDate, +5 more.
retrieve_role_listBRead-onlyIdempotent
List roles [GET /v1/roles] List and filter all your roles. A role allows you to specify permission to api endpoints and resources like compute.
Inputs: name, page, size, type, +4 more.
retrieve_secretBRead-onlyIdempotent
Get specific secret by id [GET /v1/secrets/{secretId}] Get attributes values for a specific secret on your account.
Inputs: secretId (required), x-trace-id.
retrieve_secret_audits_listCRead-onlyIdempotent
List history about your secrets (audit) [GET /v1/secrets/audits] List and filters the history about your secrets.
Inputs: page, size, endDate, orderBy, +5 more.
retrieve_secret_listBRead-onlyIdempotent
List secrets [GET /v1/secrets] List and filter all secrets in your account.
Inputs: name, page, size, type, +2 more.
retrieve_snapshotBRead-onlyIdempotent
Retrieve a specific snapshot by id [GET /v1/compute/instances/{instanceId}/snapshots/{snapshotId}] Get all attributes for a specific snapshot
Inputs: instanceId (required), snapshotId (required), x-trace-id.
retrieve_snapshot_listBRead-onlyIdempotent
List snapshots [GET /v1/compute/instances/{instanceId}/snapshots] List and filter all your snapshots for a specific instance
Inputs: instanceId (required), name, page, size, +2 more.
retrieve_snapshots_audits_listCRead-onlyIdempotent
List history about your snapshots (audit) triggered via the API [GET /v1/compute/snapshots/audits] List and filters the history about your snapshots your triggered via the API.
Inputs: page, size, endDate, orderBy, +6 more.
retrieve_tagCRead-onlyIdempotent
Get specific tag by id [GET /v1/tags/{tagId}] Get attributes values to a specific tag on your account.
Inputs: tagId (required), x-trace-id.
retrieve_tag_audits_listCRead-onlyIdempotent
List history about your assignments (audit) [GET /v1/tags/audits] List and filters the history about your assignments.
Inputs: page, size, tagId, endDate, +5 more.
retrieve_tag_listARead-onlyIdempotent
List tags [GET /v1/tags] List and filter all tags in your account
Inputs: name, page, size, orderBy, +1 more.
retrieve_userBRead-onlyIdempotent
Get specific user by id [GET /v1/users/{userId}] Get attributes for a specific user.
Inputs: userId (required), x-trace-id.
retrieve_user_audits_listBRead-onlyIdempotent
List history about your users (audit) [GET /v1/users/audits] List and filter the history about your users.
Inputs: page, size, userId, endDate, +5 more.
retrieve_user_clientCRead-onlyIdempotent
Get client [GET /v1/users/client] Get idm client.
Inputs: x-trace-id.
retrieve_user_is_password_setBRead-onlyIdempotent
Get user is password set status [GET /v1/users/is-password-set] Get info about idm user if the password is set.
Inputs: userId, x-trace-id.
retrieve_user_listBRead-onlyIdempotent
List users [GET /v1/users] List and filter all your users.
Inputs: page, size, email, owner, +5 more.
retrieve_vipBRead-onlyIdempotent
Get specific VIP by ip [GET /v1/vips/{ip}] Get attributes values to a specific VIP on your account.
Inputs: ip (required), x-trace-id.
retrieve_vip_audits_listBRead-onlyIdempotent
List history about your VIPs (audit) [GET /v1/vips/audits] List and filters the history about your VIPs.
Inputs: page, size, vipId, endDate, +5 more.
retrieve_vip_listCRead-onlyIdempotent
List VIPs [GET /v1/vips] List and filter all vips in your account
Inputs: ip, ips, page, size, +10 more.
revoke_cancel_domainC
Revoke cancellation for a specific domain [POST /v1/domains/{domain}/revoke-cancellation] Revoke cancellation for a specific domain
Inputs: domain (required), x-trace-id.
revoke_domain_transfer_outCDestructiveIdempotent
Revoke transfer out for a domain [DELETE /v1/domains/{domain}/transfer-out] Revoke transfer out for a domain
Inputs: domain (required), x-trace-id.
rollback_snapshotB
Revert the instance to a particular snapshot based on its identifier [POST /v1/compute/instances/{instanceId}/snapshots/{snapshotId}/rollback] Rollback the instance to a specific snapshot. In case the snapshot is not the latest one, it will automatically delete all the newer snapshots of the instance
Inputs: body (required), instanceId (required), snapshotId (required), x-trace-id.
set_default_handleC
Set default handle [PATCH /v1/domains/handles/{handleId}/default] Set default handle
Inputs: handleId (required), x-trace-id.
start_ext_checkC
Start check [POST /v1/troubleshooting/checks] Start a new check
Inputs: body (required), x-trace-id.
start_ext_check_collectionC
Start check collection [POST /v1/troubleshooting/check-collections] Start a new check collection
Inputs: body (required), x-trace-id.
start_ext_remedyC
Start remedy [POST /v1/troubleshooting/remedies] Start a new remedy
Inputs: body (required), x-trace-id.
suggest_domainsBRead-onlyIdempotent
Suggest domains [GET /v1/domains/suggestions] Return available domain-name suggestions for a query across a TLD set.
Inputs: query (required), tlds, limit, premium, +1 more.
switch_accountC
Switch user account [POST /v1/me/action/switchAccount] Switch user account
Inputs: body (required), x-trace-id.
unassign_instance_firewallADestructiveIdempotent
Remove instance from a firewall [DELETE /v1/firewalls/{firewallId}/instances/{instanceId}] Remove a specific instance from a firewall
Inputs: firewallId (required), instanceId (required), x-trace-id.
unassign_instance_private_networkBDestructiveIdempotent
Remove instance from a Private Network [DELETE /v1/private-networks/{privateNetworkId}/instances/{instanceId}] Remove a specific instance from a Private Network
Inputs: instanceId (required), privateNetworkId (required), x-trace-id.
unassign_ipCDestructiveIdempotent
Unassign a VIP to a VPS/VDS/Bare Metal [DELETE /v1/vips/{ip}/{resourceType}/{resourceId}] Unassign a VIP from an VPS/VDS/Bare Metal using the machine id.
Inputs: ip (required), resourceId (required), resourceType (required), x-trace-id.
update_dns_zone_recordC
Update DNS zone record [PATCH /v1/dns/zones/{zoneName}/records/{recordId}] Create resource record in a zone
Inputs: body (required), recordId (required), zoneName (required), x-trace-id.
update_domainA
Update a specific domain [PATCH /v1/domains/{domain}] Update nameservers and handles for a specific domain
Inputs: body (required), domain (required), x-trace-id.
update_handleCIdempotent
Update specific handle [PUT /v1/domains/handles/{handleId}] Update specific handle
Inputs: body (required), handleId (required), x-trace-id.
update_imageB
Update custom image name by its id [PATCH /v1/compute/images/{imageId}] Update name of the custom image
Inputs: body (required), imageId (required), x-trace-id.
update_object_storageB
Modifies the display name of object storage [PATCH /v1/object-storages/{objectStorageId}] Modifies the display name of object storage. Display name must be unique.
Inputs: body (required), objectStorageId (required), x-trace-id.
update_ptr_recordCIdempotent
Edit a PTR Record by ip address [PUT /v1/dns/ptrs/{ipAddress}] Edit attributes for a specific PTR Record
Inputs: body (required), ipAddress (required), x-trace-id.
update_roleBIdempotent
Update specific role by id [PUT /v1/roles/{roleId}] Update attributes to your role. Attributes are optional. If not set, the attributes will retain their original values.
Inputs: body (required), roleId (required), x-trace-id.
update_secretA
Update specific secret by id [PATCH /v1/secrets/{secretId}] Update attributes to your secret. Attributes are optional. If not set, the attributes will retain their original values. Only name and value can be updated.
Inputs: body (required), secretId (required), x-trace-id.
update_snapshotA
Update specific snapshot by id [PATCH /v1/compute/instances/{instanceId}/snapshots/{snapshotId}] Update attributes of a snapshot. You may only specify the attributes you want to change. If an attribute is not set, it will retain its original value.
Inputs: body (required), instanceId (required), snapshotId (required), x-trace-id.
update_tagB
Update specific tag by id [PATCH /v1/tags/{tagId}] Update attributes to your tag. Attributes are optional. If not set, the attributes will retain their original values.
Inputs: body (required), tagId (required), x-trace-id.
update_userA
Update specific user by id [PATCH /v1/users/{userId}] Update attributes of a user. You may only specify the attributes you want to change. If an attribute is not set, it will retain its original value.
Inputs: body (required), userId (required), x-trace-id.
upgrade_instanceB
Upgrading instance capabilities [POST /v1/compute/instances/{instanceId}/upgrade] In order to enhance your instance with additional features you can purchase add-ons. Currently only firewalling and private network addon is allowed.
Inputs: body (required), instanceId (required), x-trace-id.
upgrade_object_storageA
Upgrade object storage size resp. update autoscaling settings. [POST /v1/object-storages/{objectStorageId}/resize] Upgrade object storage size. You can also adjust the autoscaling settings for your object storage. Autoscaling allows you to automatically purchase storage capacity on a monthly basis up to the specified limit.
Inputs: body (required), objectStorageId (required), x-trace-id.
validate_domain_availabilityB
Check domain availablility [POST /v1/registries-domains/{domain}/check-availability] Check if a specific domain is available or not
Inputs: domain (required), x-trace-id.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 158 tools
The tools are grouped around distinct resources (compute, DNS, domains, users, firewalls, object storage, tags, etc.), so many are clearly separable by resource. However, several boundaries are fuzzy: patch_firewall vs put_firewall both update firewalls, retrieve/list/get synonyms overlap, and audit tools such as retrieve_tag_audits_list and retrieve_assignments_audits_list are hard to distinguish without close reading.
Most names use snake_case and include a resource, which provides a readable pattern. But verb conventions are mixed: retrieve_*, list_*, get_*, patch_*, put_*, update_*, and action-style names like instance_start coexist, and some names omit the resource while others include it.
The server exposes 158 tools, far beyond a manageable tool set even for a broad cloud API. While the underlying API is large, this count creates severe selection and context-loading problems for an agent.
The surface covers a very broad cloud-provider domain with CRUD, lifecycle actions, assignments, audits, troubleshooting, credentials, and ancillary resources like images, snapshots, DNS, domains, tags, users, roles, firewalls, and object storage. Obvious core workflows and lifecycle operations appear to be present.
Related MCP Connectors
Manage Vozora VPS servers, SSH keys, firewalls, DNS and usage from an AI agent.
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
Provides capabilities that let LLM agents perform a range of infrastructure management tasks.
Every Canopy public API operation as a tool, run as you after a browser sign-in or on an API key.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI assistants to interact with Coolify for complete infrastructure management including applications, databases, servers, deployments, and team operations. Provides 100% API coverage with 64 tools for managing the entire Coolify ecosystem through natural language.188 npm6MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage Cloudways infrastructure, including servers, applications, monitoring, and security via the Cloudways API.-
- AlicenseNot gradedqualityBmaintenanceEnables full operational control over Contabo VPS/VDS infrastructure through natural language, including instances, DNS, snapshots, and more with 57 tools.MIT
- FlicenseNot gradedqualityCmaintenanceEnables LLMs to manage a self-hosted Coolify instance, including applications, databases, services, servers, projects, deployments, environment variables, tags, teams, private keys, and S3 backup storages via the Coolify REST API.-