Telnyx
About
Official Telnyx remote MCP server for AI agents.
Details
- Author
- team-telnyx
- Categories
- Communication, Other, API
Jump to
Setup
Install Telnyx in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/team-telnyx/ai
Follow the installation instructions in the repository README, then restart your MCP client.
This repo is the one-stop shop for AI Agents and AI-first developers building with Telnyx — everything an agent needs to build production-grade applications and manage its account, from signup to funding.
[!NOTE] This repository is a work in progress under active development. We are continuously improving based on testing and feedback. Contributions and feedback encouraged!
-
Agent Toolkit- integrate Telnyx APIs with popular agent frameworks including OpenAI's Agent SDK, LangChain, CrewAI, and Vercel's AI SDK through function calling — available inPythonandTypeScript.
Agent CLI- provision and build on Telnyx infrastructure in a single command.
Model Context Protocol (MCP)- use Telnyx's generic API MCP proxy or app-layer MCP Apps.
Guides- step-by-step tutorials for common workflows
Edge Compute- agent workflows and handoff tooling for Telnyx Edge Compute functions
Maintainers- who maintains this repo and how to reach them
Install the Telnyx plugins you need to give your AI coding assistant Telnyx Agent Skills covering messaging, voice, numbers, AI, IoT, WebRTC, Twilio migration, account management (signup, MPP/x402 payments), and more. Plugins are split by product area so you only load the skills your project uses — see the"Which plugin do I need?" table. For direct Telnyx API access from your assistant, also add the hosted MCP server — seeMCP.
Empowers agents to generate correct, production-ready code — and to manage their own accounts — without relying on pre-training or fragile doc retrieval.
Step 1.Add the Telnyx marketplace (one-time setup):
Step 2.Install the plugins you need — pick one or more:
/plugin install telnyx-messaging@telnyx # SMS / MMS /plugin install telnyx-voice@telnyx # Voice API (call control, AMD, recording, etc.) /plugin install telnyx-whatsapp@telnyx # WhatsApp Business API /plugin install telnyx-email@telnyx # Email API /plugin install telnyx-tts@telnyx # Text-to-speech /plugin install telnyx-stt@telnyx # Speech-to-text /plugin install telnyx-verify@telnyx # Phone verification / 2FA /plugin install telnyx-numbers@telnyx # Number management, 10DLC, porting /plugin install telnyx-webrtc@telnyx # WebRTC and client SDKs /plugin install telnyx-ai@telnyx # AI inference and assistants /plugin install telnyx-platform@telnyx # Account, fax, IoT, networking, SIP, storage, TeXML, OAuth, Twilio migration
gemini extensions install https://github.com/team-telnyx/ai
Install the Telnyx plugin forOpenCodeto add Telnyx as a model provider with automatic auth and a TUI for managing hosted models.
# Local (current project only) opencode plugin @telnyx/opencode # Global (all projects) opencode plugin -g @telnyx/opencode
Seeplugins/opencode/README.mdfor full setup and configuration.
[!NOTE] Note: Our Cursor Marketplace listing is pending.
In the meantime, install skills via theSkills CLI.
Add the Telnyx MCP server to your project's.cursor/mcp.json:
{ "mcpServers": { "telnyx": { "type": "http", "url": "https://api.telnyx.com/v2/mcp" } } }
Agent Plugins manifest (any compatible client)
The repo root also carries anAgent Pluginsmanifest —plugin.json+mcp.json— so clients that speak that format can install the whole repo as one plugin: everyskills//SKILL.mdis bundled automatically andmcp.jsondeclares the hosted Telnyx MCP server (https://api.telnyx.com/v2/mcp, Streamable HTTP).
Authentication.Agent Plugins v1 has no portable credential mechanism — the spec forbids embedding secrets inheaders/envand leaves authorization to the client — somcp.jsonships no credentials. Discovery calls (initialize,tools/list,resources/) work unauthenticated;tools/callrequiresAuthorization: Bearer <TELNYX_API_KEY>. Supply the key through your client's own credential/header settings for thetelnyxserver, or, if your client cannot attach headers to plugin-provided servers, run the@telnyx/mcpproxy (npx -y @telnyx/mcp --api-key=YOUR_TELNYX_API_KEY) which adds the header for you. Get a key via the portal ortelnyx.com/agent-signup.md.
Finalized Telnyx harness plugin repositories for OpenClaw and Hermes integrations:
Hermes voice-call support is in progress and will be added once finalized.
Integrate Telnyx APIs with popular agent frameworks through function calling — available inPythonandTypeScript.
from telnyx_agent_toolkit.openai.toolkit import TelnyxAgentToolkit toolkit = TelnyxAgentToolkit( api_key="KEY_...", configuration={ "actions": { "messaging": {"send_sms": True}, "numbers": {"search_phone_numbers": True, "buy_phone_number": True} } } ) tools = toolkit.get_openai_tools()
Works with OpenAI's Agent SDK, LangChain, and CrewAI. SeePython docsfor full usage andexamples.
import { TelnyxAgentToolkit } from "@telnyx/agent-toolkit/langchain"; const toolkit = new TelnyxAgentToolkit(process.env.TELNYX_API_KEY!, { configuration: { actions: { messaging: { send_sms: true }, numbers: { search_phone_numbers: true, buy_phone_number: true }, }, }, }); const tools = toolkit.getLangChainTools();
Works with LangChain and Vercel's AI SDK. SeeTypeScript docsfor full usage.
Install individual skills for your coding assistant via theSkills CLI:
npx skills add team-telnyx/ai --skill <SKILL> --agent <AGENT>
Skills cover two areas:building with Telnyx(messaging, voice, numbers, AI inference, WebRTC, Twilio migration, and more) andaccount management(programmaticsignup, plus funding an account via MPP or x402 payments).
Skills are also published on telnyx.com for runtime discovery at/.well-known/agent-skills/index.json.
[!NOTE] SeeSkillsfor full install instructions and a comprehensive list of available skills
Composite commands that reduce multi-step Telnyx workflows to a single command. Built for AI agents and developers who want to provision infrastructure without orchestrating multiple API calls.
telnyx-agent setup-sms # Buy number + create messaging profile + assign telnyx-agent setup-voice # Create SIP connection + buy number + assign telnyx-agent setup-ai # Create AI assistant + buy number + wire together telnyx-agent setup-porting # Check portability + create porting order + submit telnyx-agent status # Account health overview
Every command supports--jsonfor machine-readable output.
Telnyx hosts a remote MCP server athttps://api.telnyx.com/v2/mcp.
To run a local Telnyx MCP server using npx:
npx -y @telnyx/mcp --api-key=YOUR_TELNYX_API_KEY
SeeMCPfor more details about the generic API MCP proxy.
- Number Intelligence (tools/mcp-apps/apps/number-intelligence)
- Usage & Cost Explorer (tools/mcp-apps/apps/usage-cost-explorer)
- Voice Monitor (tools/mcp-apps/apps/voice-monitor)
Fromtools/mcp-apps, usenpm install,npm run typecheck,npm run build, andnpm test.
Curl-first operational guides for common Telnyx workflows — SMS messaging, voice call control, AI assistants, phone numbers, porting, verification, webhooks, 10DLC registration, WireGuard networking, MPP and x402 account payments, and Edge Compute handoff patterns.
Use this repo for agent workflows against Telnyx Edge Compute: theAgent CLIshipsedge-doctor(readiness checks),setup-edge-mcp, andsetup-edge-webhookfor wiring a deployed function into MCP and webhook flows — theEdge Compute guidewalks through the full workflow, from auth to a live endpoint.
To create, deploy, and manage the functions themselves (secrets, bindings, lifecycle), use thetelnyx-edgeCLI fromteam-telnyx/edge-compute. For agent flows, prefer API-key auth (telnyx-edge auth api-key set <key>).
Maintained by the Telnyx AI‑FDE team:@aisling404,@Oliver-Zimmerman,@aaronjo-Telnyx, and@gbattistel(seeCODEOWNERS). The fastest way to reach us is anissue; for security reports, seeSECURITY.md.
Enables AI assistants to initiate and manage voice calls using Twilio and OpenAI.
Enables seamless integration with communication platform that allows you to reach your customers globally across any channel.
Platfone - Receive SMS & Virtual Numbers MCP
Virtual phone number platform for AI agents — rent numbers across 200+ countries, receive SMS, and manage the full activation lifecycle
Wavix is a global communications platform offering APIs for voice, SMS, 2FA, and phone numbers. Our MCP server brings these capabilities to AI agents and agentic workflows.
Self-hosted email and SMS platform for AI agents — each agent gets a real email address, phone number, inbox, and API key.
Send SMS messages using the Aligo SMS API.
A read-only MCP server for querying live Twilio data, powered by the CData JDBC Driver.
Send SMS, query delivery reports, manage senders / blacklists, register and check İYS (Turkish messaging consent registry) records through the iletiMerkezi BTK-licensed SMS API. 11 tools, runtime-fetched manifest stays in lock-step with the live API. Install: npx -y @iletimerkezi/mcp-server
A public MCP server that gives AI agents access to real UK carrier phone numbers for SMS verification. Agents can rent disposable or rental numbers, pay Lightning invoices, and read incoming SMS, all through standard MCP tool calls with no authentication required.
Get virtual phone numbers for SMS verification, OTP receipt, and number management.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
