TelnyxCAUTION
Official Telnyx Local Model Context Protocol (MCP) Server that enables interaction with powerful telephony, messaging, and AI assistant APIs. This server allows MCP clients like Claude Desktop, Cursor, Windsurf, OpenAI Agents and others to manage phone numbers, send messages, make calls, and create
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
⚠️ DEPRECATED: This Python-based MCP server is deprecated. Please migrate to the official TypeScript version: New Repository: https://github.com/team-telnyx/telnyx-node/tree/master/packages/mcp-server
Official Telnyx Local Model Context Protocol (MCP) Server that enables interaction with powerful telephony, messaging, and AI assistant APIs. This server allows MCP clients like Claude Desktop, Cursor, Windsurf, OpenAI Agents and others to manage phone numbers, send messages, make calls, and create AI assistants.
Quickstart with Claude Desktop
- Get your API key from the Telnyx Portal.
- Install
uvx(Python package manager), install withcurl -LsSf https://astral.sh/uv/install.sh | sh,brew install uvor see theuvrepo for additional install methods. - Go to Claude > Settings > Developer > Edit Config > claudedesktopconfig.json to include the following:
{
"mcpServers": {
"Telnyx": {
"command": "uvx",
"args": ["--from", "git+https://github.com/team-telnyx/telnyx-mcp-server.git", "telnyx-mcp-server"],
"env": {
"TELNYX_API_KEY": ""
}
}
}
}If you're using Windows, you will have to enable "Developer Mode" in Claude Desktop to use the MCP server. Click "Help" in the hamburger menu at the top left and select "Enable Developer Mode".
Running After Download
- Get your API key from the Telnyx Portal.
- Install
uvx(Python package manager), install withcurl -LsSf https://astral.sh/uv/install.sh | sh,brew install uvor see theuvrepo for additional install methods.
- Clone the Git Repository
Use Git to download the Telnyx MCP Server locally:
git clone https://github.com/team-telnyx/telnyx-mcp-server.git cd telnyx-mcp-server
- Configure and Run with uvx
In your Claud
4ebe6df11cdcOBSERVED · 2026-10-09Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.
claude mcp add telnyx-mcp-server --env NGROK_AUTHTOKEN=${NGROK_AUTHTOKEN} --env TELNYX_API_KEY=${TELNYX_API_KEY} -- uvx telnyx-mcp-server{
"mcpServers": {
"telnyx-mcp-server": {
"command": "uvx",
"args": [
"telnyx-mcp-server"
],
"env": {
"NGROK_AUTHTOKEN": "${NGROK_AUTHTOKEN}",
"TELNYX_API_KEY": "${TELNYX_API_KEY}"
}
}
}
}Exposed tools (46)
24 read · 19 write · 3 destructive. Blast radius: 3 tools can delete or overwrite — an agent that can be talked into calling a tool can be talked into calling this one.
| Tool | Risk | Description |
|---|---|---|
cloud_storage_create_bucket | write | Create a new bucket. |
cloud_storage_delete_object | destructive | Delete an object from cloud storage. |
cloud_storage_download_file | read | Download a file from cloud storage. |
cloud_storage_get_bucket_location | read | Get the region where a bucket is located. |
cloud_storage_list_buckets | read | List all buckets across all regions. |
cloud_storage_list_objects | read | List objects in a bucket with optional prefix filtering. |
cloud_storage_upload_file | write | Upload a file to cloud storage. |
create_assistant | write | Create a new AI Assistant. The user will provide some details (sometimes |
create_call_control_application | write | Create a call control application. |
create_embeddings | write | Embed a bucket that containe files. |
create_integration_secret | write | Create an integration secret. |
create_messaging_profile | write | Create a messaging profile. |
delete_integration_secret | destructive | Delete an integration secret. |
embed_url | read | Scrape and embed a given URL. For a given website, this tool will scrape |
get_assistant | read | Get an AI Assistant by ID. |
get_assistant_texml | read | Get an assistant |
get_call_control_application | read | Retrieve a specific call control application. |
get_connection | read | Get a connection by ID. |
get_message | read | Retrieve a message by ID. |
get_messaging_profile | read | Retrieve a messaging profile by ID. |
get_phone_number | read | Get a phone number by ID. |
get_webhook_events | read | |
hangup | read | Hang up a call. |
initiate_phone_number_order | write | Initiate a phone number order. |
list_assistants | read | List all AI Assistants. |
list_available_phone_numbers | read | List available phone numbers. |
list_call_control_applications | read | List call control applications. |
list_connections | read | List connections. |
list_embedded_buckets | read | List user embedded buckets. |
list_integration_secrets | read | List integration secrets. |
list_messaging_profiles | read | List messaging profiles. |
list_phone_numbers | read | List phone numbers. |
make_call | read | Make a call. |
mcp_telnyx_delete_assistant | destructive | Delete an AI Assistant. |
playback_start | write | Start audio playback on a call. |
playback_stop | write | Stop audio playback on a call. |
send_dtmf | write | Send DTMF tones on a call. |
send_message | write | Send a message. |
speak | read | Speak text on a call using text-to-speech. |
start_assistant_call | write | Start a call using an AI Assistant with a phone number. |
transfer | write | Transfer a call to a new destination. |
update_assistant | write | Update an AI Assistant. Once there is an agent created, you can talk the |
update_connection | write | Update a connection. |
update_messaging_profile | write | Update a messaging profile. |
update_phone_number | write | Update a phone number. |
update_phone_number_messaging_settings | write | Update the messaging profile and/or messaging product of a phone number. |
Trust audit
CAUTIONgrade B · trust 84/100 Install with care. The audit found things worth knowing before you trust its output.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | FAIL |
| L3 | Class-specific surface | WARN |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (1 observation(s))
- Network
- none-observed
- Shell
- none-observed
- Dependencies
- not all pinned
- Secrets in source
- none-found
Findings (6)
<img width="704" alt="Screenshot Webhook" src="https://github.com/user-attachments/assets/2e1f4a47-df24-4e35-acdf-765ef4a71578" />
cloud_storage_delete_object, delete_integration_secret, mcp_telnyx_delete_assistant
fastapi, ngrok
2. Install `uvx` (Python package manager), install with `curl -LsSf https://astral.sh/uv/install.sh | sh` , `brew install uv` or see the `uv` repo for additional install methods.
2. Install `uvx` (Python package manager), install with `curl -LsSf https://astral.sh/uv/install.sh | sh` , `brew install uv` or see the `uv` repo for additional install methods.
Gates applied: no_behavioural_pass, no_license.
4ebe6df11cdcfull audit observations/trust-audit/mcp-server/team-telnyx__telnyx.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-09 | 4ebe6df11cdc | CAUTION | B | 84 | first audit |
Questions
What is the Telnyx MCP server?
Official Telnyx Local Model Context Protocol (MCP) Server that enables interaction with powerful telephony, messaging, and AI assistant APIs. This server allows MCP clients like Claude Desktop, Cursor, Windsurf, OpenAI Agents and others to manage phone numbers, send messages, make calls, and create
What tools does Telnyx expose?
46 in total: 24 read-only, 19 that write, and 3 that can delete or overwrite (cloud_storage_delete_object, delete_integration_secret, mcp_telnyx_delete_assistant). Every one is listed on this page with its risk.
Is Telnyx safe to connect to an agent?
With care. The audit graded it B (84/100) and found 6 things worth knowing before you trust this server, listed below with the exact line each was found on. Separately from the audit: 3 of its tools can destroy data, so scope the token you give it to what you actually need.
What credentials does Telnyx need?
It reads NGROK_AUTHTOKEN and TELNYX_API_KEY from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.
How current is this page?
The grade is for one exact copy of the source (4ebe6df11cdc), read on 2026-10-09. The repository is watched and re-audited when it changes.