# MCP Server

The <code class="expression">space.vars.ionos\_cloud\_mcp\_server</code> connects your AI client or AI agent to your <code class="expression">space.vars.ionos\_cloud</code> account using the [<mark style="color:blue;">Model Context Protocol</mark>](https://modelcontextprotocol.io/) (MCP). It runs as a local binary on your machine and makes API calls directly to <code class="expression">space.vars.ionos\_cloud</code>, not through any AI provider. It provides read-only access to [<mark style="color:blue;">100+ tools</mark>](/cloud/ai/mcp-server/tool-reference.md) across Compute Engine, IONOS CLOUD Object Storage, Cloud DNS, Certificate Manager, Billing, and Activity Log.

{% hint style="info" %}
**This release is read-only.** All tools are inspection and query operations; the server cannot create, update, or delete resources. For more information, see [<mark style="color:blue;">Overview</mark>](/cloud/ai/mcp-server/overview.md).
{% endhint %}

## Why IONOS CLOUD MCP

* **Read-only by design:** These tools are inspection-only. The server cannot create, modify, or delete any resource, making it safe to connect to production accounts and share with teams.
* **Local binary:** <code class="expression">space.vars.ionos\_cloud\_api</code> calls go directly from the MCP server to <code class="expression">space.vars.ionos\_cloud</code>. 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.
* [<mark style="color:blue;">**100+ tools**</mark>](/cloud/ai/mcp-server/tool-reference.md) **across 6 products:** Compute Engine, <code class="expression">space.vars.ionos\_cloud\_object\_storage</code>, Cloud DNS, Billing, Certificate Manager, and Activity Log.
* **Open source (**[<mark style="color:blue;">**Apache 2.0**</mark>](https://opensource.org/licenses/apache-2-0)**):** Inspect the source, contribute, or extend at [<mark style="color:blue;">github.com/ionos-cloud/ionoscloud-mcp</mark>](https://github.com/ionos-cloud/ionoscloud-mcp).
* **Pairs with the** <code class="expression">space.vars.ionos\_cloud</code> **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 [<mark style="color:blue;">Overview</mark>](/cloud/ai/mcp-server/overview.md#ionos-cloud-documentation-mcp).
* **Discoverable on the major MCP registries:** Available on the [<mark style="color:blue;">Official MCP Registry</mark>](https://registry.modelcontextprotocol.io/?q=ionos), [<mark style="color:blue;">mcp.so</mark>](https://mcp.so/server/ionos-cloud-mcp-server/ionos-cloud), and the [<mark style="color:blue;">Cursor Directory</mark>](https://cursor.directory/plugins/ionoscloud-mcp) so you can find and install it from inside your AI client.

## Product Overview

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><mark style="color:blue;"><strong>IONOS CLOUD MCP Server</strong></mark></td><td>Learn how the MCP Server works, what products it covers, and its read-only scope.</td><td><a href="/pages/WCe9StCvYUtJmVDC2ZkW">/pages/WCe9StCvYUtJmVDC2ZkW</a></td></tr></tbody></table>

## Quick Links

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><mark style="color:blue;"><strong>Quick Start</strong></mark></td><td>Install the binary and connect your first AI client in minutes.</td><td><a href="/pages/ioP37dKgBKTIdz36n3Td">/pages/ioP37dKgBKTIdz36n3Td</a></td></tr><tr><td><mark style="color:blue;"><strong>Connect to an AI Client</strong></mark></td><td>Per-client setup guides for Claude Desktop, Claude Code, Cline, Continue, Cursor, Gemini CLI, JetBrains, Kiro, OpenCode, VS Code, Windsurf, and Zed.</td><td><a href="/pages/nHJVtgGxAPNvLayjYyfz">/pages/nHJVtgGxAPNvLayjYyfz</a></td></tr><tr><td><mark style="color:blue;"><strong>Use Cases</strong></mark></td><td>Explore infrastructure audits, security checks, billing analysis, FinOps pipelines, and agentic workflows.</td><td><a href="/pages/T5Z2CilLYrNazGqr9ocb">/pages/T5Z2CilLYrNazGqr9ocb</a></td></tr><tr><td><mark style="color:blue;"><strong>Tool Reference</strong></mark></td><td>A complete list of all tools across Compute Engine, IONOS CLOUD Object Storage, Cloud DNS, Billing, Certificate Manager, and Activity Log.</td><td><a href="/pages/MceUWl9tyahIMPLfRmx5">/pages/MceUWl9tyahIMPLfRmx5</a></td></tr><tr><td><mark style="color:blue;"><strong>Troubleshooting</strong></mark></td><td>Fix connection issues, missing tools, authentication errors, and rate-limit problems.</td><td><a href="/pages/EUwHENDFHwOWA7qSMHvm">/pages/EUwHENDFHwOWA7qSMHvm</a></td></tr></tbody></table>

## Configuration and Troubleshooting

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><mark style="color:blue;"><strong>Authentication</strong></mark></td><td>Generate API tokens, set up Object Storage credentials, and apply minimum-privilege scoping.</td><td><a href="/pages/052WGty8BIjsspLYzWK9">/pages/052WGty8BIjsspLYzWK9</a></td></tr><tr><td><mark style="color:blue;"><strong>Selective Tool Loading</strong></mark></td><td>Control which tools load at startup to stay within AI client tool limits.</td><td><a href="/pages/FzYeoJmZoTUBW1ul6I28">/pages/FzYeoJmZoTUBW1ul6I28</a></td></tr><tr><td><mark style="color:blue;"><strong>Troubleshooting</strong></mark></td><td>Fix connection issues, missing tools, authentication errors, and rate-limit problems.</td><td><a href="/pages/EUwHENDFHwOWA7qSMHvm">/pages/EUwHENDFHwOWA7qSMHvm</a></td></tr><tr><td><mark style="color:blue;"><strong>FAQ</strong></mark></td><td>Answers to common questions about security, credentials, clients, and rate limits.</td><td><a href="/pages/jV70xsTXbMTCe8Q8zJRb">/pages/jV70xsTXbMTCe8Q8zJRb</a></td></tr></tbody></table>

## Developer Tools

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><mark style="color:blue;"><strong>IONOS CLOUD MCP Server on GitHub</strong></mark></td><td>Source code, releases, issues, and contribution guide.</td><td><a href="https://github.com/ionos-cloud/ionoscloud-mcp">https://github.com/ionos-cloud/ionoscloud-mcp</a></td></tr><tr><td><mark style="color:blue;"><strong>IONOS CLOUD REST API</strong></mark></td><td>Complete REST API reference for the products the MCP server wraps.</td><td><a href="https://api.ionos.com/docs/">https://api.ionos.com/docs/</a></td></tr><tr><td><mark style="color:blue;"><strong>Model Context Protocol</strong></mark></td><td>The open standard the server implements: specification, SDKs, and compatible clients.</td><td><a href="https://modelcontextprotocol.io/">https://modelcontextprotocol.io/</a></td></tr><tr><td><mark style="color:blue;"><strong>Report Issues or Request Features</strong></mark></td><td>Open a GitHub issue to report a bug or request a feature. Community-visible requests help prioritise the roadmap.</td><td><a href="https://github.com/ionos-cloud/ionoscloud-mcp/issues">https://github.com/ionos-cloud/ionoscloud-mcp/issues</a></td></tr></tbody></table>

## Supported products

| Product                                                                                                                             | Tools | What you can do                                                                                                          |
| ----------------------------------------------------------------------------------------------------------------------------------- | ----- | ------------------------------------------------------------------------------------------------------------------------ |
| [<mark style="color:blue;">Compute Engine</mark>](https://docs.ionos.com/cloud/compute-services/compute-engine)                     | 50    | List and inspect data centers, servers, volumes, NICs, LANs, load balancers, NAT gateways, security groups, and more     |
| [<mark style="color:blue;">IONOS CLOUD Object Storage</mark>](https://docs.ionos.com/cloud/backup-and-storage/ionos-object-storage) | 23    | List buckets and objects, inspect bucket configuration (CORS, encryption, lifecycle, replication), and check access keys |
| [<mark style="color:blue;">Cloud DNS</mark>](https://docs.ionos.com/cloud/network-services/cloud-dns)                               | 14    | List and inspect zones, records, reverse records, secondary zones, and DNSSEC keys                                       |
| [<mark style="color:blue;">Billing</mark>](https://docs.ionos.com/cloud/management/usage/cost-and-usage)                            | 15    | View invoices, usage, traffic, the product pricing catalog, and the FOCUS v1.3 mapping                                   |
| [<mark style="color:blue;">Certificate Manager</mark>](https://docs.ionos.com/cloud/security/certificate-manager)                   | 6     | List and inspect certificates, auto-certificates, and providers                                                          |
| [<mark style="color:blue;">Activity Log</mark>](https://docs.ionos.com/cloud/observability/activity-logs)                           | 2     | Query the full audit trail: who did what, when, on which resource                                                        |

## Supported AI clients

[<mark style="color:blue;">Claude Desktop</mark>](/cloud/ai/mcp-server/connect-to-an-ai-client/claude-desktop.md), [<mark style="color:blue;">Claude Code</mark>](/cloud/ai/mcp-server/connect-to-an-ai-client/claude-code.md), [<mark style="color:blue;">Cursor</mark>](/cloud/ai/mcp-server/connect-to-an-ai-client/cursor.md), [<mark style="color:blue;">VS Code</mark>](/cloud/ai/mcp-server/connect-to-an-ai-client/vs-code.md) (GitHub Copilot), [<mark style="color:blue;">Windsurf</mark>](/cloud/ai/mcp-server/connect-to-an-ai-client/windsurf.md), [<mark style="color:blue;">Gemini CLI</mark>](/cloud/ai/mcp-server/connect-to-an-ai-client/gemini-cli.md), [<mark style="color:blue;">Kiro</mark>](/cloud/ai/mcp-server/connect-to-an-ai-client/kiro.md), [<mark style="color:blue;">JetBrains AI Assistant</mark>](/cloud/ai/mcp-server/connect-to-an-ai-client/jetbrains.md), [<mark style="color:blue;">Continue</mark>](/cloud/ai/mcp-server/connect-to-an-ai-client/continue.md), [<mark style="color:blue;">Zed</mark>](/cloud/ai/mcp-server/connect-to-an-ai-client/zed.md), [<mark style="color:blue;">Cline</mark>](/cloud/ai/mcp-server/connect-to-an-ai-client/cline.md), [<mark style="color:blue;">OpenCode</mark>](/cloud/ai/mcp-server/connect-to-an-ai-client/opencode.md), and [<mark style="color:blue;">any other MCP-compatible client</mark>](/cloud/ai/mcp-server/connect-to-an-ai-client/other-clients.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ionos.com/cloud/ai/mcp-server.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.