telnyx

This MCP server provides a Telnyx-powered Local Model Context Protocol interface. It exposes a collection of tools for managing AI agents, phone numbers, voice calls, messages, and Telnyx cloud storage features, enabling MCP clients (such as Claude Desktop, Cursor, Windsurf, and OpenAI Agents) to orchestrate communications and AI-assisted workflows through Telnyx services. You can enable or disable specific tool groups (Assistant, Call Control, Messaging, Phone Numbers, Connections, Cloud Storage, Embeddings, Secrets) to tailor the server to your needs. To use it, configure Claude or your MCP client to launch the server with uvx from your local telnyx-mcp-server folder, using the provided --from path and the telnyx-mcp-server executable name. Ensure your TELNYX_API_KEY is available in the environment to authenticate with Telnyx APIs. You can then invoke commands like creating AI assistants, sending messages, making calls, or managing phone numbers via the MCP client’s UI or prompts configured for the Telnyx MCP server.

Prerequisites:

• Python environment and uvx installed (uvx is the Python package manager for MCP servers).
• Git (optional, for cloning the repository).

Installation steps:

1. Install uvx (your system may vary by OS):

   • Curl-based install: curl -LsSf https://astral.sh/uv/install.sh | sh
   • Homebrew (on macOS): brew install uv
   • See uv repository for other methods

2. Clone the Telnyx MCP Server repository (optional, for local development): git clone https://github.com/team-telnyx/telnyx-mcp-server.git cd telnyx-mcp-server

3. Prepare configuration:

   • Create a configuration snippet similar to: { "mcpServers": { "Telnyx": { "command": "uvx", "args": ["--from", "/path/to/telnyx-mcp-server", "telnyx-mcp-server"], "env": { "TELNYX_API_KEY": "<insert-your-api-key-here>" } } } }

4. Run the server (example, adjust paths as needed): uvx --from /path/to/telnyx-mcp-server telnyx-mcp-server

Notes:

• Replace /path/to/telnyx-mcp-server with the actual local path to the repository.
• The TELNYX_API_KEY environment variable is required for authenticating with Telnyx services.

Tips and considerations:

• This MCP server is Python-based and marked as deprecated in favor of the official TypeScript version. If you can migrate, consider using the telnyx-node MCP server for long-term support.
• You can enable or disable tool groups via MCP client settings or environment variables (e.g., TELNYX_MCP_TOOLS to limit tools, TELNYX_MCP_EXCLUDE_TOOLS to exclude specific ones).
• Webhook support and ngrok integration are described in the README. Ensure you understand the security implications of exposing webhooks and manage your ngrok tokens accordingly.
• If the MCP server fails to initialize, check that uvx is correctly installed and that the TELNYX_API_KEY is valid. Logs will indicate missing env vars or misconfigurations.