# Telnyx — MCP server on 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.

By: mcp.ai · official
Page: https://mcp.ai/telnyx

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_telnyx?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/telnyx/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/telnyx/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/telnyx/skill.md
Postman collection (v2.1): https://mcp.ai/telnyx/postman.json

## Tools
- telnyx_create_network(name: string) — Tool to create a new network. Use when you need to provision a fresh network resource before connecting devices.
- telnyx_create_notification_channel(channel_type_id: string, channel_destination: string, notification_profile_id: string) — 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.
- telnyx_create_notification_profile(name: string) — 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_
- telnyx_create_notification_setting(parameters?: object[], notification_channel_id: string, notification_profile_id: string, notification_event_condition_id: string) — 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
- telnyx_delete_network(network_id: string) — Tool to delete a network by ID. Use when you have obtained the network's identifier and need to remove it permanently.
- telnyx_delete_notification_channel(notification_channel_id: string) — Tool to delete a notification channel by ID. Use when you have the channel's identifier and need to remove it permanently.
- telnyx_delete_notification_profile(notification_profile_id: string) — Tool to delete a notification profile by ID. Use when you have the profile's identifier and need to remove it permanently.
- telnyx_delete_notification_setting(notification_setting_id: string) — Tool to delete a notification setting by ID. Use when you need to permanently remove an existing notification setting before reconfiguration.
- telnyx_get_black_box_test_results(filter?: object) — 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.
- telnyx_get_user_balance() — Tool to retrieve the current user account balance and credit details. Use after authenticating your account to check available balance.
- telnyx_list_audit_logs(sort?: string, page_size?: integer, page_number?: integer, filter_created_after?: string, filter_created_before?: string) — 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.
- telnyx_list_connections(sort?: string, page_size?: integer, page_number?: integer, connection_name_contains?: string, outbound_voice_profile_id?: integer) — Tool to retrieve all connections in your account. Use when you need to list connections with pagination, filtering, and sorting.
- telnyx_list_dynamic_emergency_endpoints(status?: string, page_size?: integer, page_number?: integer, country_code?: string) — 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".
- 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.
- telnyx_list_messaging_profiles(page_size?: integer, page_number?: integer) — Tool to list messaging profiles. Use when you need to retrieve messaging profiles with optional pagination.
- telnyx_list_messaging_url_domains(page_size?: integer, page_number?: integer, filter_profile_id?: string) — Tool to list configured messaging URL domains. Use when you need to retrieve messaging URL domains for a profile.
- telnyx_list_mobile_network_operators(page_size?: integer, page_number?: integer, country_code?: string, operator_name?: string) — Tool to list available mobile network operators. Use when you need to discover operators optionally filtered by country code, operator name, or with pagination.
- telnyx_list_network_interfaces(page_size?: integer, network_id: string, filter_name?: string, filter_type?: string, page_number?: integer, filter_status?: string) — Tool to list all network interfaces for a specified network. Use after retrieving a network's ID to enumerate its interfaces.
- telnyx_list_networks(page_size?: integer, filter_name?: string, page_number?: integer) — Tool to list all networks in your account. Use when you need to retrieve networks with optional pagination and filtering.
- telnyx_list_notification_channels(page_size?: integer, page_number?: integer, filter_channel_type_id?: string) — Tool to list all notification channels. Use when you need to retrieve and paginate existing notification channels, optionally filtering by channel type.
- telnyx_list_notification_event_conditions(page_size?: integer, page_number?: integer, filter_associated_record_type_eq?: string) — Tool to list all notification event conditions. Use when you need to retrieve and paginate notification event conditions, optionally filtering by associated record type.
- telnyx_list_notification_events(page_size?: integer, page_number?: integer) — 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
- telnyx_list_notification_profiles(page_size?: integer, page_number?: integer) — Tool to list all notification profiles. Use when you need to retrieve and paginate your notification profiles with optional pagination.
- telnyx_list_phone_numbers(sort?: string, page_size?: integer, page_number?: integer, filter_status?: string, filter_phone_number?: string, filter_connection_id?: string, filter_national_destination_code?: string) — 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.
- telnyx_list_sso_authentication_providers(sort?: string, page_size?: integer, page_number?: integer) — Tool to retrieve all configured SSO authentication providers. Use after authenticating to enumerate your organization's SSO providers.
- telnyx_retrieve_network(network_id: string) — 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.
- telnyx_retrieve_notification_channel(id: string) — 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.
- telnyx_retrieve_notification_profile(id: string) — 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.
- telnyx_retrieve_notification_setting(id: string) — 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.
- telnyx_update_network(name?: string, tags?: string[], network_id: string) — Tool to update details of an existing network. Use when you have a network's identifier and need to modify its name or tags.

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

## Links
Docs: https://mcp.ai/docs/mcps/telnyx
Website: https://mcp.ai/mcps/telnyx