Official one-stop shop for AI Agents and developers building with Telnyx.
$git clone https://github.com/team-telnyx/aiInstalls into the current project.
Install ai by running `git clone https://github.com/team-telnyx/ai`, then use it for the current task and follow its documentation at https://github.com/team-telnyx/ai.
| 1 | # Telnyx AI |
| 2 | |
| 3 | This repo is the one-stop shop for AI Agents and AI-first developers building with Telnyx. |
| 4 | |
| 5 | > [!NOTE] |
| 6 | > This repository is a work in progress under active development. We are continuously improving based on testing and feedback. Contributions and feedback encouraged! |
| 7 | |
| 8 | ## Table of contents |
| 9 | |
| 10 | - [Telnyx Plugins](#plugins) - Install the Telnyx plugin for Claude Code, Cursor, or Gemini CLI to give your coding assistant Telnyx MCP server access and Telnyx Agent Skills. |
| 11 | |
| 12 | - [Agent Toolkit](#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 in [Python](#python) and [TypeScript](#typescript). |
| 13 | |
| 14 | - [Agent Skills](#agent-skills) - give AI coding assistants accurate, up-to-date context about Telnyx APIs and SDKs. |
| 15 | |
| 16 | - [Agent CLI](#agent-cli) - provision and build on Telnyx infrastructure in a single command. |
| 17 | |
| 18 | - [Model Context Protocol (MCP)](#model-context-protocol-mcp) - use Telnyx's generic API MCP proxy or app-layer MCP Apps. |
| 19 | |
| 20 | - [Guides](#guides) - step-by-step tutorials for common workflows |
| 21 | |
| 22 | |
| 23 | ## Plugins and Extenstion |
| 24 | |
| 25 | Install the unified Telnyx plugin to give your AI coding assistant Telnyx MCP server access and 228 Agent Skills covering messaging, voice, numbers, AI, IoT, WebRTC, Twilio migration, and more. |
| 26 | |
| 27 | Empowers coding agents to generate correct, production-ready code without relying on pre-training or fragile doc retrieval. |
| 28 | |
| 29 | ### Claude Code Plugin |
| 30 | |
| 31 | **Step 1.** Add the Telnyx marketplace (one-time setup): |
| 32 | |
| 33 | ```bash |
| 34 | /plugin marketplace add team-telnyx/ai |
| 35 | ``` |
| 36 | |
| 37 | **Step 2.** Install the plugins you need — pick one or more: |
| 38 | |
| 39 | ```bash |
| 40 | /plugin install telnyx-whatsapp@telnyx # WhatsApp Business API |
| 41 | /plugin install telnyx-voice@telnyx # Voice API (call control, AMD, recording, etc.) |
| 42 | /plugin install telnyx-messaging@telnyx # SMS / MMS |
| 43 | /plugin install telnyx-tts@telnyx # Text-to-speech |
| 44 | /plugin install telnyx-stt@telnyx # Speech-to-text |
| 45 | /plugin install telnyx-verify@telnyx # Phone verification / 2FA |
| 46 | /plugin install telnyx-numbers@telnyx # Number management |
| 47 | /plugin install telnyx-webrtc@telnyx # WebRTC |
| 48 | /plugin install telnyx-ai@telnyx # AI inference |
| 49 | /plugin install telnyx-platform@telnyx # Platform services (numbers, billing, MCP) |
| 50 | ``` |
| 51 | |
| 52 | ### Gemini CLI extension |
| 53 | |
| 54 | ```sh |
| 55 | gemini extensions install https://github.com/team-telnyx/ai |
| 56 | ``` |
| 57 | |
| 58 | ### OpenCode |
| 59 | |
| 60 | Install the Telnyx plugin for [OpenCode](https://opencode.ai) to add Telnyx as a model provider with automatic auth and a TUI for managing hosted models. |
| 61 | |
| 62 | ```sh |
| 63 | # Local (current project only) |
| 64 | opencode plugin @telnyx/opencode |
| 65 | |
| 66 | # Global (all projects) |
| 67 | opencode plugin -g @telnyx/opencode |
| 68 | ``` |
| 69 | |
| 70 | See [`plugins/opencode/README.md`](/plugins/opencode/README.md) for full setup and configuration. |
| 71 | |
| 72 | ### Cursor |
| 73 | |
| 74 | > [!NOTE] |
| 75 | > Note: Our Cursor Marketplace listing is pending. |
| 76 | |
| 77 | In the meantime, install skills via the [Skills CLI](#agent-skills). |
| 78 | |
| 79 | Add the Telnyx MCP server to your project's `.cursor/mcp.json`: |
| 80 | ```json |
| 81 | { |
| 82 | "mcpServers": { |
| 83 | "telnyx": { |
| 84 | "type": "http", |
| 85 | "url": "https://api.telnyx.com/v2/mcp" |
| 86 | } |
| 87 | } |
| 88 | } |
| 89 | ``` |
| 90 | |
| 91 | ### Harnesses |
| 92 | |
| 93 | Finalized Telnyx harness plugin repositories for OpenClaw and Hermes integrations: |
| 94 | |
| 95 | **OpenClaw** |
| 96 | |
| 97 | | Name | Description | Link | |
| 98 | | --- | --- | --- | |
| 99 | | Voice Call | Telnyx-first Voice Call provider plugin for OpenClaw realtime voice agents | [Repository](https://github.com/team-telnyx/telnyx-openclaw-voice-call) | |
| 100 | | Text-to-Speech | Telnyx TTS speech provider for OpenClaw — carrier-grade voice synthesis | [Repository](https://github.com/team-telnyx/telnyx-openclaw-tts) | |
| 101 | | Speech-to-Text | Telnyx STT provider for OpenClaw audio transcription | [Repository](https://github.com/team-telnyx/telnyx-openclaw-stt) | |
| 102 | | Embeddings | Telnyx embedding provider for OpenClaw memory search | [Repository](https://github.com/team-telnyx/telnyx-openclaw-embeddings) | |
| 103 | | Intelligence | Telnyx AI text-inference provider plugin for OpenClaw | [Repository](https://github.com/team-telnyx/telnyx-openclaw-intelligence) | |
| 104 | | SMS Channel | OpenClaw channel plugin for SMS/MMS via Telnyx Messaging API | [Repository](https://github.com/team-telnyx/telnyx-openclaw-sms-channel) | |
| 105 | |
| 106 | **Hermes** |
| 107 | |
| 108 | | Name | Description | Link | |
| 109 | | --- | --- | --- | |
| 110 | | Intelligence | Telnyx AI text-inference provider plugin for Hermes | [Repository](https://github.com/team-telnyx/telnyx-hermes-intelligence) | |
| 111 | | Text-to-Speech | Telnyx TTS speech-provider plugin for Hermes — WebSocket streaming, NaturalHD, and KokoroTTS voices | [Repository](https://github.com/team-telnyx/telnyx-hermes-tts) | |
| 112 | | Speech-to-Text | Telnyx STT transcription-provider plugin for Hermes — streaming speech recognition | [Repository](http |