telnyx-mcp-server

ImRonAI/telnyx-mcp-server

3.1

If you are the rightful owner of telnyx-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Telnyx MCP Server provides a full implementation of the Telnyx API, offering extensive telephony, messaging, and communication services through a Model Context Protocol server.

Tools
3
Resources
0
Prompts
0

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.