> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# IONOS Cloud

> Inspect IONOS Cloud virtual data centers and servers, and start or stop servers via the Cloud API

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: API key.
* **Connection**: The key from `IONOS_TOKEN` is sent as the `Bearer` prefixed `Authorization` header.
* **Docs**: [https://docs.ionos.com/cloud/reference/get-started](https://docs.ionos.com/cloud/reference/get-started)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

| Variable      | Required | Description                                                                                                                                                                                                                                                                              |
| ------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `IONOS_TOKEN` | Yes      | IONOS Cloud bearer token, generated via the Token Manager in the DCD or GET [https://api.ionos.com/auth/v1/tokens/generate](https://api.ionos.com/auth/v1/tokens/generate); same env var used by ionosctl and the IONOS SDKs [Docs](https://docs.ionos.com/cloud/reference/get-started). |

## Setup

1. **Get an IONOS Cloud account**: Sign up at [https://cloud.ionos.com](https://cloud.ionos.com) - new accounts typically include trial credit. Log into the Data Center Designer (DCD) at [https://dcd.ionos.com](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](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.

* All Cloud API v6 paths live under [https://api.ionos.com/cloudapi/v6](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: [https://api.ionos.com/docs/cloud/v6/](https://api.ionos.com/docs/cloud/v6/)

## Tools

| Tool               | Access | Description                                                                                                                                                                                                                                                                                       |
| ------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| List Data Centers  | Read   | List virtual data centers in the account; each data center contains servers, volumes, and networks                                                                                                                                                                                                |
| List Servers       | Read   | List servers inside a virtual data center                                                                                                                                                                                                                                                         |
| Get Server         | Read   | Get a server in a data center, including name, vmState, cores, RAM, and boot device                                                                                                                                                                                                               |
| Start Server       | Write  | Start (power on) an Enterprise server; CUBE servers cannot be started with this endpoint (they use suspend/resume instead)                                                                                                                                                                        |
| Stop Server        | Write  | Stop (power off) an Enterprise server; the server is forcefully powered off and billing for compute stops; public IPv4 addresses that are not reserved are returned to the IPv4 pool (reserved IPs are kept). CUBE servers cannot be stopped with this endpoint (they use suspend/resume instead) |
| Reboot Server      | Write  | Force a hard reboot of a server (equivalent to powering it down and back on) - recovers hung servers without a separate stop/start cycle; not a graceful OS reboot                                                                                                                                |
| Get Request Status | Read   | Poll the status of an asynchronous write operation (202 Accepted responses) until it reports DONE or FAILED; the request ID comes from the Location response header of the write call                                                                                                             |

## Example prompts

* List my IONOS Cloud virtual data centers and the servers inside each, with their power state.
* Find the IONOS server I name and stop it after confirming with me.