Can I use Telnyx as a CLI?

Yes. KosmoKrator exposes a Telnyx CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Telnyx through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Telnyx tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Telnyx credentials stored?

Telnyx credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Telnyx MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

communication

Telnyx CLI for Shell Scripts

Use the Telnyx CLI for shell scripts with headless JSON commands, schema discovery, credentials, and permission controls.

7 functions 6 read 1 write API key auth

Submit Telnyx feedback View package source

Telnyx CLI for Shell Scripts

Call integration functions from shell scripts with stable JSON input and output.

Use shell scripts for small local automations that need one or more integration calls. The Telnyx CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# Telnyx CLI for Shell Scripts
kosmokrator integrations:configure telnyx --set api_key="$TELNYX_API_KEY" --enable --read allow --write ask --json
kosmo integrations:call telnyx.telnyx_list_phone_numbers '{"page_size":1,"page_number":1,"filter_phone_number":"example_filter_phone_number","filter_status":"example_filter_status"}' --json

Discovery Before Execution

Agents and scripts can inspect Telnyx docs and schemas before choosing a function.

kosmo integrations:docs telnyx --json
kosmo integrations:docs telnyx.telnyx_list_phone_numbers --json
kosmo integrations:schema telnyx.telnyx_list_phone_numbers --json
kosmo integrations:search "Telnyx" --json
kosmo integrations:list --json

Useful Telnyx CLI Functions

Function	Type	Parameters	Description
`telnyx.telnyx_list_phone_numbers`	Read	page_size, page_number, filter_phone_number, filter_status	List phone numbers on your Telnyx account. Returns phone number IDs, numbers in E.164 format, status, and billing details.
`telnyx.telnyx_get_phone_number`	Read	phone_number_id	Get details for a specific phone number by its ID. Returns the number, status, connection, and billing information.
`telnyx.telnyx_list_messages`	Read	page_size, page_number, direction, filter_source, filter_destination, filter_status	List SMS and MMS messages sent and received on your Telnyx account. Supports filtering by direction, phone number, and date range.
`telnyx.telnyx_send_sms`	Write	from, to, text, subject, media_urls, use_mms	Send an SMS or MMS message via Telnyx. Provide a sender phone number (from your Telnyx account), a destination number, and the message body.
`telnyx.telnyx_list_calls`	Read	page_size, page_number, filter_status	List voice calls made on your Telnyx account. Returns call session IDs, status, participants, and duration.
`telnyx.telnyx_get_call`	Read	call_session_id	Get details for a specific voice call by its call session ID. Returns participants, status, duration, and call metadata.
`telnyx.telnyx_list_call_records`	Read	page_size, page_number, filter_call_session_id, filter_conference_id	List call recordings stored on your Telnyx account. Returns recording IDs, associated call sessions, download URLs, duration, and creation timestamps.

Automation Notes

Use --json for machine-readable output.
Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
Configure read/write policy before unattended runs; use --force only for trusted automation.
Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.

Related Telnyx CLI Pages

CI Telnyx CLI for CI. Cron Jobs Telnyx CLI for cron jobs. Headless Automation Telnyx CLI for headless automation. Coding Agents Telnyx CLI for coding agents.