IONOS Cloud

{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}

At a glance

  • Availability: Experimental (how to enable).
  • Authentication: API key.
  • Connection: The key from IONOS_TOKEN is sent as the Bearer prefixed Authorization header.
  • Provider documentation: Authentication reference.

Credentials

Set these per environment. See Connect an integration.

VariableRequiredDescription
IONOS_TOKENYesIONOS Cloud bearer token, generated via the Token Manager in the DCD or GET https://api.ionos.com/auth/v1/tokens/generate; same env var used by ionosctl and the IONOS SDKs Docs.

Setup

  1. Get an IONOS Cloud account: Sign up at https://cloud.ionos.com - new accounts typically include trial credit. Log into the Data Center Designer (DCD) at https://dcd.ionos.com.
  2. Generate a bearer token: In the DCD open Management > Token Manager and generate a token, or call GET https://api.ionos.com/auth/v1/tokens/generate with Basic auth (Base64 of username:password). Tokens are required if 2FA is enabled.
  3. Set the environment variable: Copy the token into your .env as IONOS_TOKEN.
  4. Verify access: Run List Data Centers (depth=1), then List Servers for one of the returned data center IDs.

Provider notes

  • All Cloud API v6 paths live under https://api.ionos.com/cloudapi/v6
  • The depth query parameter (0-10) controls how deeply nested resources are expanded; depth=0 returns only IDs
  • Stopping a server is a forceful power-off; shut down the OS first for clean stops
  • Write requests return 202 Accepted and complete asynchronously - check the server's vmState afterwards

Provider API reference.

Tools

ToolAccessDescription
List Data Centers<br /><code className="reference-identifier">ionos__list_datacenters</code>ReadList data centers
List Servers<br /><code className="reference-identifier">ionos__list_servers</code>ReadList servers
Get Server<br /><code className="reference-identifier">ionos__get_server</code>ReadGet server
Start Server<br /><code className="reference-identifier">ionos__start_server</code>WriteStart Enterprise server
Stop Server<br /><code className="reference-identifier">ionos__stop_server</code>WriteRequest Enterprise poweroff; release unreserved IPs
Reboot Server<br /><code className="reference-identifier">ionos__reboot_server</code>WriteHard reboot server
Get Request Status<br /><code className="reference-identifier">ionos__get_request_status</code>ReadPoll asynchronous request status

Verify the connection

Call a read tool such as ionos__list_datacenters with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.