KosmoKrator

communication

Agora MCP Integration for OpenAI Agents SDK

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

7 functions 5 read 2 write API key auth
Submit Agora feedback View package source

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

Agora MCP Config for OpenAI Agents SDK

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

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

Run the Gateway Manually

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

Why Use KosmoKrator Here

Scoped tools

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

Agora Tools Visible to OpenAI Agents

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

MCP toolSource functionTypeDescription
integration__agora__agora_list_projects agora.agora_list_projects Read List all Agora projects. Returns project IDs, names, and their current status.
integration__agora__agora_get_project agora.agora_get_project Read Get details of a specific Agora project by ID, including its name, App ID, App Certificate, and status.
integration__agora__agora_create_project agora.agora_create_project Write Create a new Agora project. Specify a project name and optional configuration such as recording settings and authentication mode.
integration__agora__agora_list_recordings agora.agora_list_recordings Read List cloud recordings from Agora with optional filters. Supports filtering by channel name, resource ID, and time range.
integration__agora__agora_get_recording agora.agora_get_recording Read Get details of a specific Agora cloud recording by its session ID (sid), including status, file list, and download URLs.
integration__agora__agora_start_recording agora.agora_start_recording Write Start a cloud recording for an Agora channel. Specify the channel name, UID, and recording configuration such as container format, storage settings, and layout.
integration__agora__agora_get_current_user agora.agora_get_current_user Read Get information about the current authenticated Agora user.

Related Agora Pages

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