Skip to main content
Glama

contabo-mcp

License: MIT

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 / destructive annotations

  • OAuth2 handled for you: token fetched, cached, refreshed on expiry and on 401

  • Safety switches: read-only mode, tool groups, exclusion list

  • Resilient: timeouts, retry with backoff on 429/5xx for reads, response size cap

  • Works 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 needed

Then 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.js

Ready-made configs for every supported agent are in examples/ and explained in docs/CONFIGURATION.md.

Start read-only. CONTABO_READ_ONLY=1 exposes 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.com pointing to my instance IP."

More in docs/USAGE.md.

Configuration at a glance

Variable

Purpose

CONTABO_CLIENT_ID, CONTABO_CLIENT_SECRET, CONTABO_API_USER, CONTABO_API_PASSWORD

Required. API credentials

CONTABO_READ_ONLY=1

Only GET tools

CONTABO_GROUPS=dns,firewalls

Only these tool groups

CONTABO_EXCLUDE_AUDITS=1

Drop the 17 audit-log tools

CONTABO_EXCLUDE_TOOLS=delete_tag,...

Drop specific tools

CONTABO_COMPACT=1

Shorter schemas (~45% fewer tokens)

CONTABO_TIMEOUT_MS, CONTABO_MAX_RETRIES, CONTABO_MAX_RESPONSE_CHARS

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

CONFIGURATION.md

Credentials, every env var, setup per agent

USAGE.md

Calling conventions, pagination, example workflows

TOOLS.md

All 158 tools by group

SECURITY.md

Credential handling, least privilege, risks

TROUBLESHOOTING.md

Common errors and fixes

DEVELOPMENT.md

Architecture, updating the spec, tests

CHANGELOG.md

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 tools
assign_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_recordsB
DestructiveIdempotent

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_hostA
Read-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_assignmentA
DestructiveIdempotent

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_zoneC
DestructiveIdempotent

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_recordC
DestructiveIdempotent

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_firewallA
DestructiveIdempotent

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_imageB
DestructiveIdempotent

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_networkA
DestructiveIdempotent

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_recordA
DestructiveIdempotent

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_roleA
DestructiveIdempotent

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_secretA
DestructiveIdempotent

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_snapshotC
DestructiveIdempotent

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_tagA
DestructiveIdempotent

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_userA
DestructiveIdempotent

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_secretC
Idempotent

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_checkA
Read-onlyIdempotent

Get check [GET /v1/troubleshooting/checks/{checkId}] Get a single check by id

Inputs: checkId (required), x-trace-id.

get_ext_check_collectionB
Read-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_templateB
Read-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_remedyC
Read-onlyIdempotent

Get remedy [GET /v1/troubleshooting/remedies/{remedyId}] Get a single remedy by id

Inputs: remedyId (required), x-trace-id.

get_object_storage_credentialsB
Read-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_domainsB
Read-onlyIdempotent

List all domains [GET /v1/domains] List and filter all your domains

Inputs: sld, tld, page, size, +4 more.

list_ext_check_collectionsB
Read-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_templatesB
Read-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_checksC
Read-onlyIdempotent

List check [GET /v1/troubleshooting/checks] List and filter all check

Inputs: page, size, status, orderBy, +9 more.

list_ext_remediesC
Read-onlyIdempotent

List remedy [GET /v1/troubleshooting/remedies] List and filter all remedy

Inputs: page, size, status, orderBy, +9 more.

list_handlesB
Read-onlyIdempotent

List all handles [GET /v1/domains/handles] List and filter all your handles

Inputs: name, page, size, search, +7 more.

list_object_storage_credentialsB
Read-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_actionsA
Read-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_accountsC
Read-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_firewallB
Idempotent

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_instanceB
Idempotent

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_handleC
DestructiveIdempotent

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_listA
Read-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_assignmentB
Read-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_listB
Read-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_listB
Read-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_productsA
Read-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_statsA
Read-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_listB
Read-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_listB
Read-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_zoneA
Read-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_listB
Read-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_listC
Read-onlyIdempotent

List DNS zones [GET /v1/dns/zones] Get a list of all zones

Inputs: page, size, orderBy, tenantId, +3 more.

retrieve_domainC
Read-onlyIdempotent

List specific domain [GET /v1/domains/{domain}] List specific domain

Inputs: domain (required), x-trace-id.

retrieve_domains_audits_listB
Read-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_firewallA
Read-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_listB
Read-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_listC
Read-onlyIdempotent

List all firewalls [GET /v1/firewalls] List and filter all firewalls on your account

Inputs: name, page, size, orderBy, +2 more.

retrieve_handleC
Read-onlyIdempotent

Get specific handle [GET /v1/domains/handles/{handleId}] Get specific handle

Inputs: handleId (required), x-trace-id.

retrieve_handles_audits_listB
Read-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_imageA
Read-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_listB
Read-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_listB
Read-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_instanceB
Read-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_listB
Read-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_listC
Read-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_listB
Read-onlyIdempotent

List instances [GET /v1/compute/instances] List and filter all instances in your account

Inputs: name, page, size, region, +15 more.

retrieve_object_storageB
Read-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_listB
Read-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_listB
Read-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_statsA
Read-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_rulesB
Read-onlyIdempotent

Get all preset rules [GET /v1/firewalls/preset-rules]

Inputs: name, page, size, orderBy, +1 more.

retrieve_private_networkA
Read-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_listB
Read-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_listB
Read-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_recordA
Read-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_listB
Read-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_listB
Read-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_roleA
Read-onlyIdempotent

Get specific role by id [GET /v1/roles/{roleId}] Get attributes of specific role.

Inputs: roleId (required), x-trace-id.

retrieve_role_audits_listC
Read-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_listB
Read-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_secretB
Read-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_listC
Read-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_listB
Read-onlyIdempotent

List secrets [GET /v1/secrets] List and filter all secrets in your account.

Inputs: name, page, size, type, +2 more.

retrieve_snapshotB
Read-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_listB
Read-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_listC
Read-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_tagC
Read-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_listC
Read-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_listA
Read-onlyIdempotent

List tags [GET /v1/tags] List and filter all tags in your account

Inputs: name, page, size, orderBy, +1 more.

retrieve_userB
Read-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_listB
Read-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_clientC
Read-onlyIdempotent

Get client [GET /v1/users/client] Get idm client.

Inputs: x-trace-id.

retrieve_user_is_password_setB
Read-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_listB
Read-onlyIdempotent

List users [GET /v1/users] List and filter all your users.

Inputs: page, size, email, owner, +5 more.

retrieve_vipB
Read-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_listB
Read-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_listC
Read-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_outC
DestructiveIdempotent

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_domainsB
Read-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_firewallA
DestructiveIdempotent

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_networkB
DestructiveIdempotent

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_ipC
DestructiveIdempotent

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_handleC
Idempotent

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_recordC
Idempotent

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_roleB
Idempotent

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

    C2.9/5.0

    Scored across 158 tools

    Disambiguation3/5

    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.

    Naming Consistency3/5

    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.

    Tool Count1/5

    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.

    Completeness5/5

    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

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables 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.
      18
      8 npm
      6
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to manage Cloudways infrastructure, including servers, applications, monitoring, and security via the Cloudways API.
      -
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables 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.
      -