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.

Telnyx MCP Server