KosmoKrator

communication

Telnyx MCP Integration for Generic MCP Clients

Connect Telnyx to Generic MCP Clients 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 Generic MCP Clients

Connect any stdio-compatible MCP client to local KosmoKrator integration tools.

Register kosmo mcp:serve as the command for a local stdio MCP server. The gateway is local, scoped to this integration, and starts with --write=deny so MCP clients can inspect read-capable tools without receiving write access by default.

Telnyx MCP Config for Generic MCP Clients

Start with read-only write policy and expand only for trusted projects.

{
  "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 MCP clients

MCP clients 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 MCP clientsClient-level gateway setup.