Telnyx MCP Server
Full Implementation of the Telnyx API as a Model Context Protocol (MCP) server, providing comprehensive access to Telnyx's telephony, messaging, and communication services.
Features
- 822 API endpoints from Telnyx API v2.0.0
- Comprehensive telephony services: Call control, conferencing, recording
- Messaging capabilities: SMS, MMS, group messaging, short codes
- Fax functionality: Send, receive, and manage fax communications
- Number management: Phone number search, purchase, porting
- SIM card management: IoT and cellular connectivity
- Infrastructure services: IP management, storage, authentication
Quick Start
Prerequisites
- Python 3.12+
- Telnyx API key
Local Development
# Set your API key
export TELNYX_API_KEY="your_api_key_here"
# Start the MCP server
./scripts/start_telnyx_mcp.sh
# Test the server
./scripts/test_telnyx_mcp.sh
Claude Code Integration
Use the configuration in config/telnyx-server.json to add this server to Claude Code.
API Coverage
The server provides MCP tools for:
- Call Control:
mcp__telnyx__DialCall,mcp__telnyx__AnswerCall,mcp__telnyx__BridgeCall - Messaging:
mcp__telnyx__SendMessage,mcp__telnyx__ListMessages - Fax Services:
mcp__telnyx__SendFax,mcp__telnyx__ListFaxes,mcp__telnyx__ViewFax - Number Management:
mcp__telnyx__ListPhoneNumbers,mcp__telnyx__RetrievePhoneNumber - SIM Management:
mcp__telnyx__GetSimCards,mcp__telnyx__UpdateSimCard
Deployment
Smithery Platform
Deploy using the included smithery.yaml configuration for hosted MCP server.
Docker
docker build -t telnyx-mcp-server .
docker run -e TELNYX_API_KEY=your_key -p 8080:8080 telnyx-mcp-server
Environment Variables
TELNYX_API_KEY- Your Telnyx API key (required)API_NAME- API name (default: "telnyx")API_BASE_URL- Telnyx API base URL (default: "https://api.telnyx.com/v2")LOG_LEVEL- Logging level (default: "INFO")
Support
For issues with the Telnyx API, see Telnyx Documentation. For MCP server issues, check the logs or create an issue in this repository.