A
licenseNot graded
qualityD
maintenanceA Model Context Protocol server implementation that enables AI assistants to interact with RetellAI's voice services for managing calls, agents, phone numbers, and voice options.
141 npm
40
ISC
W3J Telnyx MCP
by mnjbold
Enables the voice agent builder to use OpenAI models (e.g., gpt-4o) for natural language understanding and generation in AI assistants, powering conversational voice agents on Telnyx.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@W3J Telnyx MCPDeploy the AI receptionist from my-agent/spec.yaml"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
W3J Telnyx MCP
MCP server exposing the full Telnyx API as Model Context Protocol tools, plus an autonomous voice agent builder that deploys live AI receptionists from a YAML spec.
Quick start
# Install
git clone https://github.com/mnjbold/w3j-telnyx-mcp.git
cd w3j-telnyx-mcp
uv venv .venv --python 3.12 --seed
source .venv/bin/activate # Linux/macOS
# or: .venv\Scripts\Activate.ps1 (Windows)
uv sync --all-extras
# Health check
python -m telnyx_mcp.utils.env
python -m telnyx_mcp.clients.telnyx_client
# Start MCP server (stdio — for Claude Desktop / Cursor / Windsurf)
python -m telnyx_mcp.server
# Start MCP server (HTTP — for remote MCP clients)
python -m telnyx_mcp.server --transport http --host 0.0.0.0 --port 8765
# Deploy an agent from YAML
python agent_builder/builder.py agents/my-agent/spec.yaml --dry-run
python agent_builder/builder.py agents/my-agent/spec.yamlRelated MCP server: Telnyx MCP Server
What you get
Tool surface | Tools |
| search, order, list, get, update |
| dial, transfer, hangup, answer, reject, start/stop AI assistant, recordings |
| CRUD AI Assistants |
| Call Control Apps, Outbound Voice Profiles, Messaging Profiles, Voice Clones |
| send SMS |
| balance, account summary, health check |
Deploy a voice agent
# From YAML spec
python agent_builder/builder.py agents/w3j-llc-concierge/spec.yaml# agents/my-agent/spec.yaml
name: My Agent
instructions: |
You are a friendly receptionist for Acme Corp...
country_code: US
area_code: "415"
buy_number: true
webhook_url: https://your-server/webhooks/telnyx
model: openai/gpt-4o
voice: Telnyx.KokoroTTS.af_heartCI/CD
Push to main → GitHub Actions CI runs pytest + type check + lint.
See .github/workflows/ci.yml.
License
MIT
This server cannot be deployed
Maintenance
ActivitySlowing
ResponsivenessNo issues
Related MCP Connectors
Give your AI a real phone: place calls, send SMS, fetch recordings and transcripts. Local or hosted.
- ChamadeOAuthio.chamade
Voice and chat for AI agents — Discord, Teams, Meet, Slack, Zoom, Telegram, WhatsApp, NC Talk, SIP
Create voice-agent scenarios, pull session analytics, place SIP calls, schedule meeting bots.
Phone, SMS & email for AI agents — one remote MCP endpoint, OAuth login, zero install.
Related MCP Servers
Telnyx MCP Serverofficial
FlicenseBqualityFmaintenanceEnables interaction with Telnyx's telephony, messaging, and AI assistant APIs to manage phone numbers, send messages, make calls, and create AI assistants. Includes webhook support for real-time event handling and comprehensive tools for voice, SMS, cloud storage, and embeddings.4625-- FlicenseBqualityDmaintenanceEnables interaction with Retell AI's voice and chat agent platform. Build, deploy, and manage AI phone agents, configure conversation flows, handle calls/chats, and manage phone numbers through natural language.52-
- AlicenseAqualityDmaintenanceManage voice AI agents, make calls, run campaigns, and control phone numbers through natural language.5813 npm1MIT