# Telnyx — how to use (mcp.ai)

Connect your Telnyx account and use 30 tools for phone and SMS straight from your AI agent. Connect with your own API key. Telnyx is a communications platform offering voice, messaging, and data services through a global private network.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_telnyx?ms=1787293500000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `telnyx_create_network`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/telnyx`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/telnyx/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/telnyx/create/network` — Tool to create a new network. Use when you need to provision a fresh network resource before connecting devices.
  - body: { name: string }
- `POST https://api.mcp.ai/api/telnyx/create/notification/channel` — Tool to create a notification channel. Use when you need to register a channel (SMS, voice, email, or webhook) to receive notifications. E.g., create a webhook channel for event callbacks.
  - body: { channel_type_id: string, channel_destination: string, notification_profile_id: string }
- `POST https://api.mcp.ai/api/telnyx/create/notification/profile` — Tool to create a notification profile. Use when you need to register a new profile to group notification channels (SMS and voice) and define notification settings. Must be called before TELNYX_CREATE_
  - body: { name: string }
- `POST https://api.mcp.ai/api/telnyx/create/notification/setting` — Tool to add a notification setting. Use after creating the event condition, profile, and channel. All three UUID parameters must be fetched dynamically from their respective list/create endpoints; har
  - body: { parameters?: object[], notification_channel_id: string, notification_profile_id: string, notification_event_condition_id: string }
- `POST https://api.mcp.ai/api/telnyx/delete/network` — Tool to delete a network by ID. Use when you have obtained the network's identifier and need to remove it permanently.
  - body: { network_id: string }
- `POST https://api.mcp.ai/api/telnyx/delete/notification/channel` — Tool to delete a notification channel by ID. Use when you have the channel's identifier and need to remove it permanently.
  - body: { notification_channel_id: string }
- `POST https://api.mcp.ai/api/telnyx/delete/notification/profile` — Tool to delete a notification profile by ID. Use when you have the profile's identifier and need to remove it permanently.
  - body: { notification_profile_id: string }
- `POST https://api.mcp.ai/api/telnyx/delete/notification/setting` — Tool to delete a notification setting by ID. Use when you need to permanently remove an existing notification setting before reconfiguration.
  - body: { notification_setting_id: string }
- `POST https://api.mcp.ai/api/telnyx/get/black/box/test/results` — Tool to retrieve black box test results from Telnyx SETI Observability. Use when you need to check service health and test results, optionally filtering by product.
  - body: { filter?: object }
- `POST https://api.mcp.ai/api/telnyx/get/user/balance` — Tool to retrieve the current user account balance and credit details. Use after authenticating your account to check available balance.
- `POST https://api.mcp.ai/api/telnyx/list/audit/logs` — Tool to retrieve a list of audit log entries for your account. Use when you need to review recent resource changes with optional pagination and date filters.
  - body: { sort?: string, page_size?: integer, page_number?: integer, filter_created_after?: string, filter_created_before?: string }
- `POST https://api.mcp.ai/api/telnyx/list/connections` — Tool to retrieve all connections in your account. Use when you need to list connections with pagination, filtering, and sorting.
  - body: { sort?: string, page_size?: integer, page_number?: integer, connection_name_contains?: string, outbound_voice_profile_id?: integer }
- `POST https://api.mcp.ai/api/telnyx/list/dynamic/emergency/endpoints` — Tool to list dynamic emergency endpoints. Use when you need to retrieve dynamic emergency endpoint records, optionally filtered by status or country. Example: "List all activated endpoints in US".
  - body: { status?: string, page_size?: integer, page_number?: integer, country_code?: string }
- `POST https://api.mcp.ai/api/telnyx/list/global/ip/health/check/types` — Tool to list all available global IP health check types. Use when you need to retrieve supported health check types for global IP configurations.
- `POST https://api.mcp.ai/api/telnyx/list/messaging/profiles` — Tool to list messaging profiles. Use when you need to retrieve messaging profiles with optional pagination.
  - body: { page_size?: integer, page_number?: integer }
- `POST https://api.mcp.ai/api/telnyx/list/messaging/url/domains` — Tool to list configured messaging URL domains. Use when you need to retrieve messaging URL domains for a profile.
  - body: { page_size?: integer, page_number?: integer, filter_profile_id?: string }
- `POST https://api.mcp.ai/api/telnyx/list/mobile/network/operators` — Tool to list available mobile network operators. Use when you need to discover operators optionally filtered by country code, operator name, or with pagination.
  - body: { page_size?: integer, page_number?: integer, country_code?: string, operator_name?: string }
- `POST https://api.mcp.ai/api/telnyx/list/network/interfaces` — Tool to list all network interfaces for a specified network. Use after retrieving a network's ID to enumerate its interfaces.
  - body: { page_size?: integer, network_id: string, filter_name?: string, filter_type?: string, page_number?: integer, filter_status?: string }
- `POST https://api.mcp.ai/api/telnyx/list/networks` — Tool to list all networks in your account. Use when you need to retrieve networks with optional pagination and filtering.
  - body: { page_size?: integer, filter_name?: string, page_number?: integer }
- `POST https://api.mcp.ai/api/telnyx/list/notification/channels` — Tool to list all notification channels. Use when you need to retrieve and paginate existing notification channels, optionally filtering by channel type.
  - body: { page_size?: integer, page_number?: integer, filter_channel_type_id?: string }
- `POST https://api.mcp.ai/api/telnyx/list/notification/event/conditions` — Tool to list all notification event conditions. Use when you need to retrieve and paginate notification event conditions, optionally filtering by associated record type.
  - body: { page_size?: integer, page_number?: integer, filter_associated_record_type_eq?: string }
- `POST https://api.mcp.ai/api/telnyx/list/notification/events` — Tool to list all notification events with their IDs. Use to dynamically retrieve notification_event_condition_id values before configuring webhook subscriptions — IDs are account-specific and must not
  - body: { page_size?: integer, page_number?: integer }
- `POST https://api.mcp.ai/api/telnyx/list/notification/profiles` — Tool to list all notification profiles. Use when you need to retrieve and paginate your notification profiles with optional pagination.
  - body: { page_size?: integer, page_number?: integer }
- `POST https://api.mcp.ai/api/telnyx/list/phone/numbers` — Tool to list phone numbers associated with your account. Use when you need to retrieve and filter your phone numbers with optional pagination and sorting.
  - body: { sort?: string, page_size?: integer, page_number?: integer, filter_status?: string, filter_phone_number?: string, filter_connection_id?: string, filter_national_destination_code?: string }
- `POST https://api.mcp.ai/api/telnyx/list/sso/authentication/providers` — Tool to retrieve all configured SSO authentication providers. Use after authenticating to enumerate your organization's SSO providers.
  - body: { sort?: string, page_size?: integer, page_number?: integer }
- `POST https://api.mcp.ai/api/telnyx/retrieve/network` — Tool to retrieve details of a specific network by ID. Use after obtaining the network's identifier to fetch its current attributes before update or delete operations.
  - body: { network_id: string }
- `POST https://api.mcp.ai/api/telnyx/retrieve/notification/channel` — Tool to retrieve a notification channel by ID. Use after you have a channel ID and need its details, such as name, type, and status.
  - body: { id: string }
- `POST https://api.mcp.ai/api/telnyx/retrieve/notification/profile` — Tool to retrieve a notification profile by ID. Use after obtaining the profile ID when you need details about its webhook endpoints and subscribed events.
  - body: { id: string }
- `POST https://api.mcp.ai/api/telnyx/retrieve/notification/setting` — Tool to retrieve a notification setting by ID. Use after obtaining the notification setting ID to fetch its details, such as status, parameters, and associated channel.
  - body: { id: string }
- `POST https://api.mcp.ai/api/telnyx/update/network` — Tool to update details of an existing network. Use when you have a network's identifier and need to modify its name or tags.
  - body: { name?: string, tags?: string[], network_id: string }

## Example prompts
- "What can I do in Telnyx?"
- "Show me a summary of my Telnyx account"

## More
- Page: https://mcp.ai/telnyx
- Agent spec (llms.txt): https://mcp.ai/telnyx/llms.txt
- Postman collection: https://mcp.ai/telnyx/postman.json