KosmoKrator

developer

Svix MCP Integration for OpenAI Agents SDK

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

7 functions 5 read 2 write API token auth
Submit Svix feedback View package source

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

Svix MCP Config for OpenAI Agents SDK

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

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

Run the Gateway Manually

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

Why Use KosmoKrator Here

Scoped tools

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

Svix Tools Visible to OpenAI Agents

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

MCP toolSource functionTypeDescription
integration__svix__svix_list_applications svix.svix_list_applications Read List all Svix applications. Returns application IDs, names, and UIDs that you can use to manage endpoints and messages.
integration__svix__svix_get_application svix.svix_get_application Read Get details of a specific Svix application by its ID, including name, UID, and created timestamp.
integration__svix__svix_create_application svix.svix_create_application Write Create a new Svix application. Each application represents a webhook sender with its own set of endpoints.
integration__svix__svix_list_messages svix.svix_list_messages Read List messages for a Svix application. Returns message IDs, event types, payloads, and delivery status.
integration__svix__svix_list_endpoints svix.svix_list_endpoints Read List webhook endpoints for a Svix application. Returns endpoint IDs, URLs, and descriptions.
integration__svix__svix_create_endpoint svix.svix_create_endpoint Write Create a new webhook endpoint for a Svix application. Webhook events will be delivered to the specified URL.
integration__svix__svix_get_current_user svix.svix_get_current_user Read Get the current authenticated Svix user and dashboard usage information.

Related Svix Pages

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