KosmoKrator

productivity

IONOS Cloud MCP Integration for OpenAI Agents SDK

Connect IONOS Cloud to OpenAI Agents 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 OpenAI Agents SDK

Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway.

Start the KosmoKrator MCP gateway locally and point the OpenAI Agents SDK MCP tool at that process or wrapper. The gateway is local, scoped to this integration, and starts with --write=deny so OpenAI Agents can inspect read-capable tools without receiving write access by default.

IONOS Cloud MCP Config for OpenAI Agents SDK

Use headless JSON commands for CI-style execution and MCP for agent tool discovery.

{
  "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 OpenAI Agents

OpenAI Agents 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 OpenAI AgentsClient-level gateway setup.