KosmoKrator

productivity

Podio MCP Integration for OpenAI Agents SDK

Connect Podio to OpenAI Agents SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

7 functions 7 read 0 write Manual OAuth token auth
Submit Podio feedback View package source

Connect Podio 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.

Podio MCP Config for OpenAI Agents SDK

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

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

Run the Gateway Manually

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

Why Use KosmoKrator Here

Scoped tools

Expose only Podio 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.

Podio Tools Visible to OpenAI Agents

OpenAI Agents sees stable MCP tool names generated from the Podio integration catalog.

MCP toolSource functionTypeDescription
integration__podio__podio_list_spaces podio.podio_list_spaces Read List all workspaces (spaces) in a Podio organization. Returns space IDs, names, URLs, and membership details. Use this to discover available workspaces before exploring their apps and items.
integration__podio__podio_get_space podio.podio_get_space Read Get detailed information about a specific Podio workspace, including its name, description, URL, and settings. Use the space ID obtained from podio_list_spaces.
integration__podio__podio_list_apps podio.podio_list_apps Read List all apps in a Podio workspace. Returns app IDs, names, item counts, and configuration. Use this to discover available apps before querying their items.
integration__podio__podio_get_app podio.podio_get_app Read Get detailed information about a specific Podio app, including its field definitions, layout, and configuration. Use this to understand the data structure before listing or filtering items.
integration__podio__podio_list_items podio.podio_list_items Read List and filter items in a Podio app. Supports filtering by field values, sorting, and pagination. Use podio_get_app first to understand the available fields for filtering.
integration__podio__podio_get_item podio.podio_get_item Read Get detailed information about a specific Podio item, including all field values, references, and metadata. Use the item ID obtained from podio_list_items.
integration__podio__podio_get_current_user podio.podio_get_current_user Read Get the status of the currently authenticated Podio user, including profile information, active organization memberships, and account details.

Related Podio Pages

Podio CLIUse direct JSON commands instead of MCP discovery. Podio MCPFull gateway reference and MCP tool names. KosmoKrator for OpenAI AgentsClient-level gateway setup.