# IONOS CLOUD MCP Server

Connects IONOS CLOUD to an AI assistant for infrastructure inspection and resource management, with write actions disabled until you opt in.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9
- Author: ionos-cloud
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ionos-cloud/ionoscloud-mcp
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/ionos-cloud-mcp-server

## What it does

IONOS CLOUD MCP Server exposes IONOS CLOUD account data to an MCP-compatible assistant. It can inspect Compute Engine, Kubernetes, Object Storage, DNS, Billing, Certificate Manager and Activity Log resources, including servers, clusters, buckets, records, invoices and events. The default setup keeps write tools off.

It runs as a local process or container, while API requests travel directly to IONOS over HTTPS. The Docker setup passes `IONOS_TOKEN`, `IONOS_S3_ACCESS_KEY`, `IONOS_S3_SECRET_KEY`, `IONOS_MCP_LOAD_MODE` and `IONOS_MCP_TOOL_SCOPE`. Create, update and delete actions require an explicit scope and confirmation flow. Without `IONOS_TOKEN`, the server cannot connect to the IONOS CLOUD account.

## Requirements
- Needs: Docker
- Environment variables: `IONOS_TOKEN`, `IONOS_S3_ACCESS_KEY`, `IONOS_S3_SECRET_KEY`, `IONOS_MCP_LOAD_MODE`, `IONOS_MCP_TOOL_SCOPE` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env IONOS_TOKEN=<IONOS_TOKEN> --env IONOS_S3_ACCESS_KEY=<IONOS_S3_ACCESS_KEY> --env IONOS_S3_SECRET_KEY=<IONOS_S3_SECRET_KEY> --env IONOS_MCP_LOAD_MODE=<IONOS_MCP_LOAD_MODE> --env IONOS_MCP_TOOL_SCOPE=<IONOS_MCP_TOOL_SCOPE> --transport stdio ionos-cloud-mcp-server -- docker run -i --rm -e IONOS_TOKEN -e IONOS_S3_ACCESS_KEY -e IONOS_S3_SECRET_KEY -e IONOS_MCP_LOAD_MODE -e IONOS_MCP_TOOL_SCOPE ghcr.io/ionos-cloud/ionoscloud-mcp:1.1.2
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add ionos-cloud-mcp-server --env IONOS_TOKEN=<IONOS_TOKEN> --env IONOS_S3_ACCESS_KEY=<IONOS_S3_ACCESS_KEY> --env IONOS_S3_SECRET_KEY=<IONOS_S3_SECRET_KEY> --env IONOS_MCP_LOAD_MODE=<IONOS_MCP_LOAD_MODE> --env IONOS_MCP_TOOL_SCOPE=<IONOS_MCP_TOOL_SCOPE> -- docker run -i --rm -e IONOS_TOKEN -e IONOS_S3_ACCESS_KEY -e IONOS_S3_SECRET_KEY -e IONOS_MCP_LOAD_MODE -e IONOS_MCP_TOOL_SCOPE ghcr.io/ionos-cloud/ionoscloud-mcp:1.1.2
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ionos-cloud-mcp-server": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "IONOS_TOKEN",
                "-e",
                "IONOS_S3_ACCESS_KEY",
                "-e",
                "IONOS_S3_SECRET_KEY",
                "-e",
                "IONOS_MCP_LOAD_MODE",
                "-e",
                "IONOS_MCP_TOOL_SCOPE",
                "ghcr.io/ionos-cloud/ionoscloud-mcp:1.1.2"
            ],
            "env": {
                "IONOS_TOKEN": "<IONOS_TOKEN>",
                "IONOS_S3_ACCESS_KEY": "<IONOS_S3_ACCESS_KEY>",
                "IONOS_S3_SECRET_KEY": "<IONOS_S3_SECRET_KEY>",
                "IONOS_MCP_LOAD_MODE": "<IONOS_MCP_LOAD_MODE>",
                "IONOS_MCP_TOOL_SCOPE": "<IONOS_MCP_TOOL_SCOPE>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ionos-cloud-mcp-server": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "IONOS_TOKEN",
                "-e",
                "IONOS_S3_ACCESS_KEY",
                "-e",
                "IONOS_S3_SECRET_KEY",
                "-e",
                "IONOS_MCP_LOAD_MODE",
                "-e",
                "IONOS_MCP_TOOL_SCOPE",
                "ghcr.io/ionos-cloud/ionoscloud-mcp:1.1.2"
            ],
            "env": {
                "IONOS_TOKEN": "<IONOS_TOKEN>",
                "IONOS_S3_ACCESS_KEY": "<IONOS_S3_ACCESS_KEY>",
                "IONOS_S3_SECRET_KEY": "<IONOS_S3_SECRET_KEY>",
                "IONOS_MCP_LOAD_MODE": "<IONOS_MCP_LOAD_MODE>",
                "IONOS_MCP_TOOL_SCOPE": "<IONOS_MCP_TOOL_SCOPE>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e IONOS_TOKEN=<IONOS_TOKEN> -e IONOS_S3_ACCESS_KEY=<IONOS_S3_ACCESS_KEY> -e IONOS_S3_SECRET_KEY=<IONOS_S3_SECRET_KEY> -e IONOS_MCP_LOAD_MODE=<IONOS_MCP_LOAD_MODE> -e IONOS_MCP_TOOL_SCOPE=<IONOS_MCP_TOOL_SCOPE> ionos-cloud-mcp-server docker run -i --rm -e IONOS_TOKEN -e IONOS_S3_ACCESS_KEY -e IONOS_S3_SECRET_KEY -e IONOS_MCP_LOAD_MODE -e IONOS_MCP_TOOL_SCOPE ghcr.io/ionos-cloud/ionoscloud-mcp:1.1.2
```
Replace <…> with your own values

## When to use it
- inspect IONOS CLOUD servers and network resources
- check Kubernetes clusters and node pools
- review DNS zones and records
- trace billing, traffic and resource usage
- manage certificates after enabling writes

## Example prompts
- Show the servers in my IONOS CLOUD account with their details.
- Review the DNS zones and records for this account.
- Summarize IONOS CLOUD invoices, traffic, and resource usage.

## Similar
- [cloud-infrastructure](https://affpapa.org/en/nevibecode/plugins/cloud-infrastructure.md) — plugin · ★ 41823
- [provider-upgrade](https://affpapa.org/en/nevibecode/skills/provider-upgrade.md) — skill · 848 installs
- [terraform-search-import](https://affpapa.org/en/nevibecode/skills/terraform-search-import.md) — skill · 4900 installs
- [lifecycle-crud](https://affpapa.org/en/nevibecode/skills/lifecycle-crud.md) — skill · 2600 installs
- [modal-serverless-gpu](https://affpapa.org/en/nevibecode/skills/modal-serverless-gpu.md) — skill · 954 installs
- [architecture-diagram](https://affpapa.org/en/nevibecode/skills/cocoon-ai-hello-at-cocoon-aico-architecture-diagram.md) — skill · 491 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md