{
  "markdown": "# Telnyx AI\n\nThis 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.\n\n> [!NOTE]\n> This repository is a work in progress under active development. We are continuously improving based on testing and feedback. Contributions and feedback encouraged!\n\n## Table of contents\n\n- [Telnyx Plugins](#plugins-and-extensions) - Set up your coding assistant: Telnyx Agent Skills plugins for Claude Code and Cursor, the hosted Telnyx MCP server via the Gemini CLI extension, and a Telnyx model-provider plugin for OpenCode.\n\n- [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).\n  \n- [Agent Skills](#agent-skills) - give AI agents accurate, up-to-date context about Telnyx APIs and SDKs, plus account-management skills for signup and payments (MPP and x402 account funding).\n  \n- [Agent CLI](#agent-cli) - provision and build on Telnyx infrastructure in a single command.\n\n- [Model Context Protocol (MCP)](#model-context-protocol-mcp) - use Telnyx's generic API MCP proxy or app-layer MCP Apps.\n\n- [Guides](#guides) - step-by-step tutorials for common workflows\n\n- [Edge Compute](#edge-compute) - agent workflows and handoff tooling for Telnyx Edge Compute functions\n\n- [Maintainers](#maintainers) - who maintains this repo and how to reach them\n\n## Plugins and Extensions\n\nInstall 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](/plugins/README.md#which-plugin-do-i-need). For direct Telnyx API access from your assistant, also add the hosted MCP server — see [MCP](#model-context-protocol-mcp).\n\nEmpowers agents to generate correct, production-ready code — and to manage their own accounts — without relying on pre-training or fragile doc retrieval.\n\n### Claude Code Plugin\n\n**Step 1.** Add the Telnyx marketplace (one-time setup):\n\n```bash\n/plugin marketplace add team-telnyx/ai\n```\n\n**Step 2.** Install the plugins you need — pick one or more:\n\n```bash\n/plugin install telnyx-messaging@telnyx  # SMS / MMS\n/plugin install telnyx-voice@telnyx      # Voice API (call control, AMD, recording, etc.)\n/plugin install telnyx-whatsapp@telnyx   # WhatsApp Business API\n/plugin install telnyx-email@telnyx      # Email API\n/plugin install telnyx-tts@telnyx        # Text-to-speech\n/plugin install telnyx-stt@telnyx        # Speech-to-text\n/plugin install telnyx-verify@telnyx     # Phone verification / 2FA\n/plugin install telnyx-numbers@telnyx    # Number management, 10DLC, porting\n/plugin install telnyx-webrtc@telnyx     # WebRTC and client SDKs\n/plugin install telnyx-ai@telnyx         # AI inference, assistants, and Meeting Bot\n/plugin install telnyx-platform@telnyx   # Account, fax, IoT, networking, SIP, storage, TeXML, OAuth, Twilio migration\n```\n\n### Gemini CLI extension\n\n ```sh\n  gemini extensions install https://github.com/team-telnyx/ai\n```\n\n### OpenCode\n\nInstall 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.\n\n```sh\n# Local (current project only)\nopencode plugin @telnyx/opencode\n\n# Global (all projects)\nopencode plugin -g @telnyx/opencode\n```\n\nSee [`plugins/opencode/README.md`](/plugins/opencode/README.md) for full setup and configuration.\n\n### Cursor                                                \n\n> [!NOTE]\n> Note: Our Cursor Marketplace listing is pending. \n\nIn the meantime, install skills via the [Skills CLI](#agent-skills).\n\nAdd the Telnyx MCP server to your project's `.cursor/mcp.json`:                                                                                                \n```json       \n  {                                                         \n    \"mcpServers\": {\n      \"telnyx\": {\n        \"type\": \"http\",\n        \"url\": \"https://api.telnyx.com/v2/mcp\"\n      }\n    }\n  }\n```\n\n### Agent Plugins manifest (any compatible client)\n\nThe repo root also carries an [Agent Plugins](https://agent-plugins.org/specification) manifest — [`plugin.json`](/plugin.json) + [`mcp.json`](/mcp.json) — so clients that speak that format can install the whole repo as one plugin: every `skills/*/SKILL.md` is bundled automatically and `mcp.json` declares the hosted Telnyx MCP server (`https://api.telnyx.com/v2/mcp`, Streamable HTTP).\n\n**Authentication.** Agent Plugins v1 has no portable credential mechanism — the spec forbids embedding secrets in `headers`/`env` and leaves authorization to the client — so `mcp.json` ships no credentials. Discovery calls (`initialize`, `tools/list`, `resources/*`) work unauthenticated; `tools/call` requires `Authorization: Bearer <TELNYX_API_KEY>`. Supply the key through your client's own credential/header settings for the `telnyx` server, or, if your client cannot attach headers to plugin-provided servers, run the [`@telnyx/mcp`](/tools/mcp) proxy (`npx -y @telnyx/mcp --api-key=YOUR_TELNYX_API_KEY`) which adds the header for you. Get a key via the portal or [`telnyx.com/agent-signup.md`](https://telnyx.com/agent-signup.md).\n\n### Harnesses\n\nFinalized Telnyx harness plugin repositories for OpenClaw and Hermes integrations:\n\n**OpenClaw**\n\n| Name | Description | Link |\n| --- | --- | --- |\n| Voice Call | Telnyx-first Voice Call provider plugin for OpenClaw realtime voice agents | [Repository](https://github.com/team-telnyx/telnyx-openclaw-voice-call) |\n| Text-to-Speech | Telnyx TTS speech provider for OpenClaw — carrier-grade voice synthesis | [Repository](https://github.com/team-telnyx/telnyx-openclaw-tts) |\n| Speech-to-Text | Telnyx STT provider for OpenClaw audio transcription | [Repository](https://github.com/team-telnyx/telnyx-openclaw-stt) |\n| Embeddings | Telnyx embedding provider for OpenClaw memory search | [Repository](https://github.com/team-telnyx/telnyx-openclaw-embeddings) |\n| Intelligence | Telnyx AI text-inference provider plugin for OpenClaw | [Repository](https://github.com/team-telnyx/telnyx-openclaw-intelligence) |\n| SMS Channel | OpenClaw channel plugin for SMS/MMS via Telnyx Messaging API | [Repository](https://github.com/team-telnyx/telnyx-openclaw-sms-channel) |\n\n**Hermes**\n\n| Name | Description | Link |\n| --- | --- | --- |\n| Intelligence | Telnyx AI text-inference provider plugin for Hermes | [Repository](https://github.com/team-telnyx/telnyx-hermes-intelligence) |\n| 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) |\n| Speech-to-Text | Telnyx STT transcription-provider plugin for Hermes — streaming speech recognition | [Repository](https://github.com/team-telnyx/telnyx-hermes-stt) |\n| SMS | Telnyx SMS/MMS platform adapter for Hermes Agent | [Repository](https://github.com/team-telnyx/telnyx-hermes-sms) |\n\nHermes voice-call support is in progress and will be added once finalized.\n\n## Agent Toolkit\n\nIntegrate Telnyx APIs with popular agent frameworks through function calling — available in [Python](/tools/python) and [TypeScript](/tools/typescript).\n\n### Python\n\n```sh\npip install telnyx-agent-toolkit\n```\n\n```python\nfrom telnyx_agent_toolkit.openai.toolkit import TelnyxAgentToolkit\n\ntoolkit = TelnyxAgentToolkit(\n    api_key=\"KEY_...\",\n    configuration={\n        \"actions\": {\n            \"messaging\": {\"send_sms\": True},\n            \"numbers\": {\"search_phone_numbers\": True, \"buy_phone_number\": True}\n        }\n    }\n)\n\ntools = toolkit.get_openai_tools()\n```\n\nWorks with OpenAI's Agent SDK, LangChain, and CrewAI. See [Python docs](/tools/python) for full usage and [examples](/tools/python/examples).\n\n### TypeScript\n\n```sh\nnpm install @telnyx/agent-toolkit\n```\n\n```typescript\nimport { TelnyxAgentToolkit } from \"@telnyx/agent-toolkit/langchain\";\n\nconst toolkit = new TelnyxAgentToolkit(process.env.TELNYX_API_KEY!, {\n  configuration: {\n    actions: {\n      messaging: { send_sms: true },\n      numbers: { search_phone_numbers: true, buy_phone_number: true },\n    },\n  },\n});\n\nconst tools = toolkit.getLangChainTools();\n```\n\nWorks with LangChain and Vercel's AI SDK. See [TypeScript docs](/tools/typescript) for full usage.\n\n## Agent Skills\n\nInstall individual skills for your coding assistant via the [Skills CLI](https://github.com/vercel-labs/skills):\n\n```sh\nnpx skills add team-telnyx/ai --skill <SKILL> --agent <AGENT>\n```\n\nSkills cover two areas: **building with Telnyx** (messaging, voice, numbers, AI inference, WebRTC, Twilio migration, and more) and **account management** (programmatic [signup](https://telnyx.com/agent-signup.md), plus funding an account via MPP or x402 payments).\n\nSkills are also published on telnyx.com for runtime discovery at [`/.well-known/agent-skills/index.json`](https://telnyx.com/.well-known/agent-skills/index.json).\n\n> [!NOTE]\n> See [Skills](/skills/README.md) for full install instructions and a comprehensive list of available skills\n\n\n## Agent CLI\n\nComposite 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.\n\n```sh\ntelnyx-agent setup-sms        # Buy number + create messaging profile + assign\ntelnyx-agent setup-voice       # Create SIP connection + buy number + assign\ntelnyx-agent setup-ai          # Create AI assistant + buy number + wire together\ntelnyx-agent setup-porting     # Check portability + create porting order + submit\ntelnyx-agent status            # Account health overview\n```\n\nEvery command supports `--json` for machine-readable output.\n\nSee [Agent CLI](/cli)\n\n\n## Model Context Protocol (MCP)\n\nTelnyx hosts a remote MCP server at `https://api.telnyx.com/v2/mcp`.\n\nTo run a local Telnyx MCP server using npx:\n\n```sh\nnpx -y @telnyx/mcp --api-key=YOUR_TELNYX_API_KEY\n```\n\nSee [MCP](/tools/mcp) for more details about the generic API MCP proxy.\n\n### MCP Apps\n\n[`tools/mcp-apps`](/tools/mcp-apps) contains app-layer MCP servers with MCP Apps UI resources for focused Telnyx workflows. These are separate from the generic `@telnyx/mcp` proxy above.\n\nCurrent apps:\n\n- Number Intelligence (`tools/mcp-apps/apps/number-intelligence`)\n- Usage & Cost Explorer (`tools/mcp-apps/apps/usage-cost-explorer`)\n- Voice Monitor (`tools/mcp-apps/apps/voice-monitor`)\n\nFrom `tools/mcp-apps`, use `npm install`, `npm run typecheck`, `npm run build`, and `npm test`.\n\n## Guides\n\nCurl-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.\n\nSee [Guides](/guides) for the full list.\n\n## Edge Compute\n\nUse this repo for agent workflows against Telnyx Edge Compute: the [Agent CLI](/cli) ships `edge-doctor` (readiness checks), `setup-edge-mcp`, and `setup-edge-webhook` for wiring a deployed function into MCP and webhook flows — the [Edge Compute guide](/guides/edge-compute.md) walks through the full workflow, from auth to a live endpoint.\n\nTo create, deploy, and manage the functions themselves (secrets, bindings, lifecycle), use the `telnyx-edge` CLI from [`team-telnyx/edge-compute`](https://github.com/team-telnyx/edge-compute). For agent flows, prefer API-key auth (`telnyx-edge auth api-key set <key>`).\n\n\n## Maintainers\n\nMaintained by the Telnyx AI‑FDE team: [@aisling404](https://github.com/aisling404), [@Oliver-Zimmerman](https://github.com/Oliver-Zimmerman), [@aaronjo-Telnyx](https://github.com/aaronjo-Telnyx), and [@gbattistel](https://github.com/gbattistel) (see [CODEOWNERS](/.github/CODEOWNERS)). The fastest way to reach us is an [issue](https://github.com/team-telnyx/ai/issues); for security reports, see [SECURITY.md](/.github/SECURITY.md).\n\n## License\n\n[MIT](LICENSE)\n",
  "bytes": 12253,
  "sha": "e2ef976ef190d518a52b005f5d8e7f8e083f1e2e49b035d5796101121af1b21b",
  "repo_slug": "team-telnyx/ai",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_team_telnyx_ai_76ca5533/readme"
}