KosmoKrator

productivity

IONOS Cloud MCP Integration for Claude Agent SDK

Connect IONOS Cloud to Claude Agent SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

7 functions 7 read 0 write Bearer token auth
Submit IONOS Cloud feedback View package source

Connect IONOS Cloud to Claude Agent SDK

Give Claude Agent SDK workflows access to KosmoKrator integrations through a local MCP server.

Add a KosmoKrator stdio MCP server to the Claude Agent SDK options. The gateway is local, scoped to this integration, and starts with --write=deny so Claude Agent SDK can inspect read-capable tools without receiving write access by default.

IONOS Cloud MCP Config for Claude Agent SDK

Use a narrow integration list so the agent does not load unrelated tools.

{
  "mcpServers": {
    "kosmokrator-ionos": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=ionos",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=ionos --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only IONOS Cloud instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

IONOS Cloud Tools Visible to Claude Agent SDK

Claude Agent SDK sees stable MCP tool names generated from the IONOS Cloud integration catalog.

MCP toolSource functionTypeDescription
integration__ionos__ionos_list_servers ionos.ionos_list_servers Read List all servers in the IONOS Cloud account. Returns IDs, names, cores, RAM, VM state, and boot volume information.
integration__ionos__ionos_get_server ionos.ionos_get_server Read Get details for a specific IONOS Cloud server by ID. Returns full server information including cores, RAM, VM state, volumes, and NICs.
integration__ionos__ionos_list_volumes ionos.ionos_list_volumes Read List all block storage volumes in the IONOS Cloud account. Returns IDs, names, size, type, zone, and state.
integration__ionos__ionos_list_lans ionos.ionos_list_lans Read List all local area networks (LANs) in the IONOS Cloud account. Returns IDs, names, public flag, and connected servers.
integration__ionos__ionos_list_nics ionos.ionos_list_nics Read List all network interface cards (NICs) in the IONOS Cloud account. Returns IDs, names, MAC addresses, IPs, and LAN associations.
integration__ionos__ionos_list_images ionos.ionos_list_images Read List all available images in the IONOS Cloud account. Returns IDs, names, size, OS type, location, and public status.
integration__ionos__ionos_get_current_user ionos.ionos_get_current_user Read Get information about the current authenticated IONOS Cloud user, including email, name, and account status.

Related IONOS Cloud Pages

IONOS Cloud CLIUse direct JSON commands instead of MCP discovery. IONOS Cloud MCPFull gateway reference and MCP tool names. KosmoKrator for Claude Agent SDKClient-level gateway setup.