KosmoKrator

communication

Telnyx MCP Integration for OpenAI Agents SDK

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

7 functions 6 read 1 write API key auth
Submit Telnyx feedback View package source

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

Telnyx MCP Config for OpenAI Agents SDK

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

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

Run the Gateway Manually

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

Why Use KosmoKrator Here

Scoped tools

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

Telnyx Tools Visible to OpenAI Agents

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

MCP toolSource functionTypeDescription
integration__telnyx__telnyx_list_phone_numbers telnyx.telnyx_list_phone_numbers Read List phone numbers on your Telnyx account. Returns phone number IDs, numbers in E.164 format, status, and billing details.
integration__telnyx__telnyx_get_phone_number telnyx.telnyx_get_phone_number Read Get details for a specific phone number by its ID. Returns the number, status, connection, and billing information.
integration__telnyx__telnyx_list_messages telnyx.telnyx_list_messages Read List SMS and MMS messages sent and received on your Telnyx account. Supports filtering by direction, phone number, and date range.
integration__telnyx__telnyx_send_sms telnyx.telnyx_send_sms Write Send an SMS or MMS message via Telnyx. Provide a sender phone number (from your Telnyx account), a destination number, and the message body.
integration__telnyx__telnyx_list_calls telnyx.telnyx_list_calls Read List voice calls made on your Telnyx account. Returns call session IDs, status, participants, and duration.
integration__telnyx__telnyx_get_call telnyx.telnyx_get_call Read Get details for a specific voice call by its call session ID. Returns participants, status, duration, and call metadata.
integration__telnyx__telnyx_list_call_records telnyx.telnyx_list_call_records Read List call recordings stored on your Telnyx account. Returns recording IDs, associated call sessions, download URLs, duration, and creation timestamps.

Related Telnyx Pages

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