Environment Variables

All MCP server configuration is done through environment variables passed in your AI client's MCP server configuration.

Variables

Variable	Required	Description
IONOS_TOKEN	Yes	IONOS CLOUD API token. Authenticates all Compute Engine, Cloud DNS, Billing, Certificate Manager, IONOS CLOUD Object Storage, and Activity Log API requests.
IONOS_S3_ACCESS_KEY	No	Object Storage access key. Required for Object Storage data-plane tools (listing objects, reading bucket configuration).
IONOS_S3_SECRET_KEY	No	Object Storage secret key. Required together with IONOS_S3_ACCESS_KEY.
IONOS_MCP_LOAD_MODE	No	Controls how the server registers tools at startup. Accepted values: eager (default — all tools registered immediately), lazy (only the 37 always-on tools and 2 loader sentinels register; Compute and Object Storage register on demand), router (reserved for a future release; not yet implemented). For more information, see Selective Tool Loading.

Example

{
  "mcpServers": {
    "ionoscloud": {
      "command": "/path/to/ionoscloud-mcp",
      "env": {
        "IONOS_TOKEN": "your-api-token",
        "IONOS_S3_ACCESS_KEY": "your-access-key",
        "IONOS_S3_SECRET_KEY": "your-secret-key"
      }
    }
  }
}