Cursor

Prerequisites

• Cursor installed on your machine
• The ionoscloud-mcp binary built and available. For more information, see Quick Start
• An IONOS CLOUD API token. For least-privilege access, see Authentication to scope the token to only the tools you need.

Add the MCP server

Add the server to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "ionoscloud": {
      "command": "/usr/local/bin/ionoscloud-mcp",
      "env": {
        "IONOS_TOKEN": "your-api-token"
      }
    }
  }
}

To also enable Object Storage tools, add your Object Storage credentials:

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

Alternative: add the server from the Cursor UI

1

Open the Add MCP server dialog

In Cursor, open Settings (⌘ + , on macOS) > Features > MCP Servers > Add new MCP server.

2

Configure the server

Set Type to stdio (this tells Cursor to run the server as a local process) and Command to /usr/local/bin/ionoscloud-mcp.

3

Add credentials via mcp.json

The Cursor UI does not expose environment variables, so set IONOS_TOKEN (and optionally IONOS_S3_ACCESS_KEY / IONOS_S3_SECRET_KEY) in ~/.cursor/mcp.json as shown in the JSON examples above.

Verify the connection

1

Open a Cursor chat

Start a new chat in Cursor.

2

Test the connection

Type: List my IONOS CLOUD data centers.

Result: Cursor responds with a list of your data centers: names, locations, and IDs.

If Cursor responds that it cannot access that information, check Troubleshooting.

Note: All tools are registered at startup by default, so Compute Engine and Object Storage tools appear immediately. To reduce the startup tool count (for example, on clients with a tool-count cap), set IONOS_MCP_LOAD_MODE=lazy in the env block and call the ionos_load_compute_tools or ionos_load_objectstorage_tools sentinels on demand. For more information, see Selective Tool Loading.

For full Cursor MCP documentation, see docs.cursor.com/mcp.