MCP Server

The IONOS CLOUD MCP Server connects your AI client or AI agent to your IONOS CLOUD account using the Model Context Protocol (MCP). It runs as a local binary on your machine and makes API calls directly to IONOS CLOUD, not through any AI provider. It provides access to 100+ tools across Compute Engine, Managed Kubernetes, , Cloud DNS, Certificate Manager, Billing, and Activity Log.

Note: The server is read-only by default. Unless you opt in, all tools are inspection and query operations and the server cannot create, update, or delete resources. Write tools for Compute Engine and Managed Kubernetes are available behind the IONOS_MCP_TOOL_SCOPE environment variable. For more information, see Write Operations.

Why IONOS CLOUD MCP

• Read-only by default: Out of the box, these tools are inspection-only. The server cannot create, modify, or delete any resource. This makes it safe to connect to production accounts and share with teams. Write tools exist but must be enabled deliberately, and every create, delete, and disruptive action needs a two-step confirmation. For more information, see Write Operations.

• Local binary: IONOS CLOUD API calls go directly from the MCP server to IONOS CLOUD. They are not proxied through Anthropic, Microsoft, or any third-party relay. The AI client sends tool outputs to its model backend for inference; review your AI client's privacy policy for details.

• 100+ tools across 7 products: Compute Engine, Managed Kubernetes, IONOS CLOUD Object Storage, Cloud DNS, Billing, Certificate Manager, and Activity Log.

• Open source (Apache 2.0): Inspect the source, contribute, or extend at github.com/ionos-cloud/ionoscloud-mcp.

• Pairs with the IONOS CLOUD Documentation MCP: Add https://docs.ionos.com/cloud/~gitbook/mcp to your config to give your AI assistant live account data and full product documentation in the same session. For more information, see Overview.

• Discoverable on the major MCP registries: Available on the Official MCP Registry, Smithery, mcp.so, Glama, the Cursor Directory, mcpservers.org, PulseMCP, MCPMarket, and awesome-mcp-servers so you can find and install it from within your AI client.

Product Overview

IONOS CLOUD MCP Server

Learn how the MCP Server works, what products it covers, and how its tool scopes work.

Quick Links

Quick Start

Install the binary and connect your first AI client in minutes.

Connect to an AI Client

Per-client setup guides for Claude Desktop, Claude Code, Cline, Continue, Cursor, Gemini CLI, JetBrains, Kiro, OpenCode, VS Code, Windsurf, and Zed.

Configuration

Authentication, environment variables, opt-in write operations, and selective tool loading.

Use Cases

Explore infrastructure audits, security checks, billing analysis, FinOps pipelines, and agentic workflows.

Troubleshooting

Fix connection issues, missing tools, authentication errors, and rate-limit problems.

Tool Reference

A complete list of all tools across Compute Engine, Managed Kubernetes, , Cloud DNS, Billing, Certificate Manager, and Activity Log.

Tutorials

Step-by-step instructions for deploying IONOS CLOUD MCP Server workflows.

Developer Tools

IONOS CLOUD MCP Server on GitHub

Source code, releases, issues, and contribution guide.

IONOS CLOUD REST API

Complete REST API reference for the products the MCP server wraps.

Model Context Protocol

The open standard the server implements: specification, SDKs, and compatible clients.

Report Issues or Request Features

Open a GitHub issue to report a bug or request a feature. Community-visible requests help prioritise the roadmap.

Supported products

Product	Tools	What you can do
Compute Engine	50 read, 69 write	List and inspect data centers, servers, volumes, NICs, LANs, load balancers, NAT gateways, security groups, and more. With write tools enabled, also create, update, and delete them
Managed Kubernetes	8 read, 8 write	List and inspect Kubernetes clusters, node pools, nodes, and available versions. With write tools enabled, also create, scale, upgrade, and delete them
IONOS CLOUD Object Storage	23	List buckets and objects, inspect bucket configuration (CORS, encryption, lifecycle, replication), and check access keys
Cloud DNS	14	List and inspect zones, records, reverse records, secondary zones, and DNSSEC keys
Billing	15	View invoices, usage, traffic, the product pricing catalog, and the FOCUS v1.3 mapping
Certificate Manager	6	List and inspect certificates, auto-certificates, and providers
Activity Log	2	Query the full audit trail: who did what, when, on which resource

Supported AI clients

Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, Gemini CLI, Kiro, JetBrains AI Assistant, Continue, Zed, Cline, OpenCode, and any other MCP-compatible client.

FAQ

FAQ

Answers to common questions about security, credentials, write operations, clients, and rate limits.