KosmoKrator

communication

Telnyx MCP Integration for Claude Agent SDK

Connect Telnyx to Claude Agent 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 Claude Agent SDK

Give Claude Agent SDK workflows access to KosmoKrator integrations through a local MCP server.

Add a KosmoKrator stdio MCP server to the Claude Agent SDK options. The gateway is local, scoped to this integration, and starts with --write=deny so Claude Agent SDK can inspect read-capable tools without receiving write access by default.

Telnyx MCP Config for Claude Agent SDK

Use a narrow integration list so the agent does not load unrelated tools.

{
  "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 Claude Agent SDK

Claude Agent SDK 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 Claude Agent SDKClient-level gateway setup.