Skip the install. Get this working in under 2 minutes.
Start a free trial on cloud.anythingmcp.com, add the Telnyx in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.
Summary
Let your AI work with Telnyx: check balance and usage, list and search phone numbers, send SMS and MMS, place calls that speak a message, read call recordings and detail records, look up numbers, send and check one-time codes with Verify, and review your AI assistants.
Try asking
Example prompts for Telnyx
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Telnyx, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
Telnyx
Let your AI work with Telnyx: check balance and usage, list and search phone numbers, send SMS and MMS, place calls that speak a message, read call recordings and detail records, look up numbers, send and check one-time codes with Verify, and review your AI assistants.
Setup
- Sign in to the Mission Control Portal at
https://portal.telnyx.com. - Open Account settings → Keys & Credentials → API Keys and click Create API Key. The key starts with
KEY, and Telnyx shows it only once. - Paste it into
TELNYX_API_KEYas Telnyx shows it, without the word Bearer, and install the connector. The key is sent only to api.telnyx.com. - Check the setup with
telnyx_get_balance: it is free and shows your balance, credit limit and currency.
Who sees what: the key acts for the whole Telnyx account, balance included. Share the MCP server only with people who may spend money on it.
Costs money and reaches real people, so the AI asks first: Telnyx bills telnyx_send_message (SMS and MMS), telnyx_dial_call (per minute), telnyx_speak_text (text to speech) and telnyx_send_verification (per verification). Before each of them the AI shows you the recipient, the sender and the content and waits for your yes. telnyx_lookup_number is billed per lookup, so the AI tells you before it looks up many numbers. Sending, calling and buying need a funded account.
Switched off at install: telnyx_order_phone_numbers, which buys numbers with an upfront price and a monthly fee per number. An administrator turns it on deliberately; the AI then shows every number with its costs and buys only after you confirm. Searching for numbers with telnyx_search_available_numbers is free.
SMS: a number sends SMS only when it is assigned to a messaging profile (telnyx_list_messaging_profiles shows the profiles and the countries each one may send to). A new message starts as queued; telnyx_get_message shows the delivery status per recipient later. Media links turn a message into an MMS (US and Canada).
Calls need a Call Control application: set one up in the Mission Control Portal and assign the number you call from to it. telnyx_list_call_control_applications gives the connection_id that telnyx_dial_call needs. The AI dials, checks with telnyx_get_call_status until the call is answered, speaks your message with telnyx_speak_text and ends the call with telnyx_hangup_call. A time limit on the dial caps the cost. Call events go to the application's webhook URL, which this connector does not receive. Recordings: telnyx_list_recordings and telnyx_get_recording (download links expire after a few minutes).
Verify: create a Verify profile once in the portal under Verify; telnyx_list_verify_profiles lists it. telnyx_send_verification sends a code by SMS, voice call or WhatsApp, and telnyx_check_verification_code checks what the person typed.
Usage and cost: telnyx_search_detail_records lists single messages and calls with their cost; telnyx_get_usage_report_options and telnyx_get_usage_report give totals per product for up to 31 days. AI assistants are read-only: telnyx_list_ai_assistants and telnyx_get_ai_assistant.
Numbers: always in E.164, that is +, the country code and the number without spaces (+4915112345678).
Common errors: 401 (10009): the key is wrong, deleted or was pasted with a prefix; create a new one in the portal. 403: the account may not use this feature yet (for example sending to a country or buying numbers before account verification), or the key lacks permission. 404 (10005): no such resource on this account. 422: a parameter is invalid, for example the sender has no messaging profile, the call is not answered yet or a number is not in E.164. 429: too many requests; wait and retry.
The connector does not cover number porting, number configuration and release, SIP trunking, TeXML, conferences, fax, WhatsApp templates, 10DLC brand and campaign registration, creating or changing AI assistants, or webhooks.
Prerequisites: TELNYX_API_KEY
Install the connector locally
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Open http://localhost:3000/connectors/store, pick Telnyx and paste in the env vars listed under Prerequisites.
Available tools
| Tool | What it does |
|---|---|
telnyx_get_balance | Read the account balance: balance, pending, credit_limit, available_credit and currency |
telnyx_list_phone_numbers | List the phone numbers the account owns, newest first: id, phone_number (E.164), status, phone_number_type, country, the voice connection… |
telnyx_get_phone_number | Read one owned phone number by its id (from telnyx_list_phone_numbers): status, type, country, voice connection, messaging profile… |
telnyx_search_available_numbers | Search phone numbers that can be bought, by country, area, digits, type and features |
telnyx_order_phone_numbers | Buy phone numbers found with telnyx_search_available_numbers |
telnyx_get_number_order | Read a number order by its id: status (pending, success, failure), the numbers with their own status and whether the regulatory… |
telnyx_send_message | Send an SMS or MMS from a Telnyx number |
telnyx_get_message | Read one message by its id: direction, from, to with per-recipient delivery status (queued, sending, sent, delivered, sending_failed… |
telnyx_list_messaging_profiles | List the messaging profiles: id, name, enabled, webhook_url, whitelisted_destinations (countries the profile may send to), daily spend… |
telnyx_list_call_control_applications | List the Call Control applications (voice connections): id, application_name, active, webhook_event_url and outbound settings.… |
telnyx_dial_call | Place an outbound phone call through a Call Control application |
telnyx_get_call_status | Read the status of a call by its call_control_id: is_alive (false once it ended), call_duration in seconds, start_time and end_time |
telnyx_speak_text | Speak text to the other party on an answered call |
telnyx_hangup_call | Hang up a call that is still in progress |
telnyx_search_detail_records | Search detail records (CDRs and MDRs): one record per message, call leg, verification, recording and so on, with direction, numbers… |
telnyx_get_usage_report_options | List the products of the usage report and, for each, the dimensions and metrics telnyx_get_usage_report accepts (for example product… |
telnyx_get_usage_report | Get aggregated usage and cost for one product over at most 31 days, broken out by dimensions (e.g. date, direction, country) with metrics… |
telnyx_list_recordings | List call recordings, newest first: id, from, to, duration_millis, channels, status, start and end time and download_urls (mp3 and wav… |
telnyx_get_recording | Read one call recording by its id with fresh download_urls (mp3, wav), duration, channels and the call it belongs to |
telnyx_lookup_number | Look up a phone number: country, national format, E.164 form, and with type carrier the carrier name, line type (mobile, landline, voip)… |
telnyx_list_verify_profiles | List the Verify profiles: id, name, language and the settings per channel (sms, call, whatsapp, flashcall) such as code length and… |
telnyx_send_verification | Send a one-time code to a phone number by SMS, voice call or WhatsApp through a Verify profile |
telnyx_check_verification_code | Check the code a person entered against the latest verification sent to that number |
telnyx_get_verification | Read a verification by its id: phone_number, channel type, status (pending, accepted, invalid, expired, error) and when it was created |
telnyx_list_ai_assistants | List the account's Telnyx AI assistants (voice and chat agents): id, name, description, model, greeting, enabled features and creation date |
telnyx_get_ai_assistant | Read one AI assistant by its id: name, model, instructions (system prompt), greeting, tools, voice and transcription settings, telephony… |
Example prompts
- "What is our Telnyx balance, and how much did we spend on messaging this month, by country?"
- "Send an SMS from our Berlin number to +4915112345678 saying the order is ready for pickup. Show me sender, recipient and text before you send it."
- "Call +4915112345678 from our support line, say that the technician arrives at 3 pm, then hang up. Keep the call under one minute."
- "Find three mobile numbers in Germany that can send SMS and show me the upfront and monthly cost of each."
- "Which of yesterday's messages were not delivered? Check the detail records and show status and cost."
Next steps
Was this guide helpful?
