Skip to content
Back to search

ai

Official one-stop shop for AI Agents and developers building with Telnyx.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026. Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/team-telnyx/ai with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/team-telnyx/ai'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/team-telnyx--ai/badge.svg)](/listings/team-telnyx--ai)

HTML

<a href="/listings/team-telnyx--ai"><img src="/api/listings/team-telnyx--ai/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 79 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "telnyx",
  3. "owner": {
  4. "name": "Telnyx",
  5. "email": "support@telnyx.com"
  6. },
  7. "metadata": {
  8. "description": "Official Telnyx plugin marketplace for AI coding agents — modular plugins for WhatsApp, Voice, SMS, Email, TTS, STT, Verify, AI, Numbers, WebRTC, and platform services",
  9. "version": "0.4.0"
  10. },
  11. "plugins": [
  12. {
  13. "name": "telnyx-whatsapp",
  14. "source": "./providers/claude/plugins/telnyx-whatsapp",
  15. "description": "Telnyx WhatsApp Business API — send messages, manage templates, WABAs, and phone numbers",
  16. "version": "0.4.0"
  17. },
  18. {
  19. "name": "telnyx-voice",
  20. "source": "./providers/claude/plugins/telnyx-voice",
  21. "description": "Telnyx Voice API — call control, DTMF, recording, noise suppression, AMD, deepfake detection, number masking, SIPREC, streaming",
  22. "version": "0.4.0"
  23. },
  24. {
  25. "name": "telnyx-messaging",
  26. "source": "./providers/claude/plugins/telnyx-messaging",
  27. "description": "Telnyx SMS/MMS — send, schedule, group MMS, delivery webhooks, opt-out handling, messaging profiles",
  28. "version": "0.4.0"
  29. },
  30. {
  31. "name": "telnyx-email",
  32. "source": "./providers/claude/plugins/telnyx-email",
  33. "description": "Telnyx Email — send transactional email, manage inboxes, configure sending domains, suppressions, and unsubscribe groups",
  34. "version": "0.1.0"
  35. },
  36. {
  37. "name": "telnyx-tts",
  38. "source": "./providers/claude/plugins/telnyx-tts",
  39. "description": "Telnyx Text-to-Speech — generate speech from text via Telnyx and third-party providers (AWS, Azure, ElevenLabs, MiniMax, Resemble, Rime, xAI)",
  40. "version": "0.4.0"
  41. },
  42. {
  43. "name": "telnyx-stt",
  44. "source": "./providers/claude/plugins/telnyx-stt",
  45. "description": "Telnyx Speech-to-Text — transcribe audio to text via OpenAI-compatible endpoint with model, language, and keyword biasing",
  46. "version": "0.4.0"
  47. },
  48. {
  49. "name": "telnyx-verify",
  50. "source": "./providers/claude/plugins/telnyx-verify",
  51. "description": "Telnyx Verify — phone verification via SMS, call, or flash call (2FA OTP)",
  52. "version": "0.4.0"
  53. },
  54. {
  55. "name": "telnyx-ai",
  56. "source": "./providers/claude/plugins/telnyx-ai",
  57. "description": "Telnyx AI — LLM inference, chat completions, embeddings, AI assistants, Meeting Bot, conversation insights",
  58. "version": "0.4.0"
  59. },
  60. {
  61. "name": "telnyx-numbers",
  62. "source": "./providers/claude/plugins/telnyx-numbers",
  63. "description": "Telnyx Numbers — search, buy, manage phone numbers, 10DLC compliance registration, number porting",
  64. "version": "0.4.0"
  65. },
  66. {
  67. "name": "telnyx-webrtc",
  68. "source": "./providers/claude/plugins/telnyx-webrtc",
  69. "description": "Telnyx WebRTC — browser-based real-time communications, video rooms, WebRTC client SDKs",
  70. "version": "0.4.0"
  71. },
  72. {
  73. "name": "telnyx-platform",
  74. "source": "./providers/claude/plugins/telnyx-platform",
  75. "description": "Telnyx Platform — account management, fax, IoT, networking, SIP, storage, TeXML, OAuth, Twilio migration, and other platform services",
  76. "version": "0.4.0"
  77. }
  78. ]
  79. }
README.md · README · 254 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Telnyx AI
  2. 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.
  3. > [!NOTE]
  4. > This repository is a work in progress under active development. We are continuously improving based on testing and feedback. Contributions and feedback encouraged!
  5. ## Table of contents
  6. - [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.
  7. - [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).
  8. - [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 (ACP, MPP, and x402 account funding).
  9. - [Agent CLI](#agent-cli) - provision and build on Telnyx infrastructure in a single command.
  10. - [Model Context Protocol (MCP)](#model-context-protocol-mcp) - use Telnyx's generic API MCP proxy or app-layer MCP Apps.
  11. - [Guides](#guides) - step-by-step tutorials for common workflows
  12. - [Edge Compute](#edge-compute) - agent workflows and handoff tooling for Telnyx Edge Compute functions
  13. - [Maintainers](#maintainers) - who maintains this repo and how to reach them
  14. ## Plugins and Extensions
  15. 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, ACP/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).
  16. Empowers agents to generate correct, production-ready code — and to manage their own accounts — without relying on pre-training or fragile doc retrieval.
  17. ### Claude Code Plugin
  18. **Step 1.** Add the Telnyx marketplace (one-time setup):
  19. ```bash
  20. /plugin marketplace add team-telnyx/ai
  21. ```
  22. **Step 2.** Install the plugins you need — pick one or more:
  23. ```bash
  24. /plugin install telnyx-messaging@telnyx # SMS / MMS
  25. /plugin install telnyx-voice@telnyx # Voice API (call control, AMD, recording, etc.)
  26. /plugin install telnyx-whatsapp@telnyx # WhatsApp Business API
  27. /plugin install telnyx-email@telnyx # Email API
  28. /plugin install telnyx-tts@telnyx # Text-to-speech
  29. /plugin install telnyx-stt@telnyx # Speech-to-text
  30. /plugin install telnyx-verify@telnyx # Phone verification / 2FA
  31. /plugin install telnyx-numbers@telnyx # Number management, 10DLC, porting
  32. /plugin install telnyx-webrtc@telnyx # WebRTC and client SDKs
  33. /plugin install telnyx-ai@telnyx # AI inference, assistants, and Meeting Bot
  34. /plugin install telnyx-platform@telnyx # Account, fax, IoT, networking, SIP, storage, TeXML, OAuth, Twilio migration
  35. ```
  36. ### Gemini CLI extension
  37. ```sh
  38. gemini extensions install https://github.com/team-telnyx/ai
  39. ```
  40. ### OpenCode
  41. 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.
  42. ```sh
  43. # Local (current project only)
  44. opencode plugin @telnyx/opencode
  45. # Global (all projects)
  46. opencode plugin -g @telnyx/opencode
  47. ```
  48. See [`plugins/opencode/README.md`](/plugins/opencode/README.md) for full setup and configuration.
  49. ### Cursor
  50. > [!NOTE]
  51. > Note: Our Cursor Marketplace listing is pending.
  52. In the meantime, install skills via the [Skills CLI](#agent-skills).
  53. Add the Telnyx MCP server to your project's `.cursor/mcp.json`:
  54. ```json
  55. {
  56. "mcpServers": {
  57. "telnyx": {
  58. "type": "http",
  59. "url": "https://api.telnyx.com/v2/mcp"
  60. }
  61. }
  62. }
  63. ```
  64. ### Agent Plugins manifest (any compatible client)
  65. The 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).
  66. **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).
  67. ### Harnesses
  68. Finalized Telnyx harness plugin repositories for OpenClaw and Hermes integrations:
  69. **OpenClaw**
  70. | Name | Description | Link |
  71. | --- | --- | --- |
  72. | Voice Call | Telnyx-first Voice Call provider plugin for OpenClaw realtime voice agents | [Repository](https://github.com/team-telnyx/telnyx-openclaw-voice-call) |
  73. | Text-to-Speech | Telnyx TTS speech provider for OpenClaw — carrier-grade voice synthesis | [Repository](https://github.com/team-telnyx/telnyx-openclaw-tts) |
  74. | Speech-to-Text | Telnyx STT provider for OpenClaw audio transcription | [Repository](https://github.com/team-telnyx/telnyx-openclaw-stt) |
  75. | Embeddings | Telnyx embedding provider for OpenClaw memory search | [Repository](https://github.com/team-telnyx/telnyx-openclaw-embeddings) |
  76. | Intelligence | Telnyx AI text-inference provider plugin for OpenClaw | [Repository](https://github.com/team-telnyx/telnyx-openclaw-intelligence) |
  77. | SMS Channel | OpenClaw channel plugin for SMS/MMS via Telnyx Messaging API | [Repository](https://github.com/team-telnyx/telnyx-openclaw-sms-channel) |
  78. **Hermes**
  79. | Name | Description | Link |
  80. | --- | --- | --- |
  81. | Intelligence | Telnyx AI text-inference provider plugin for Hermes | [Repository](https://github.com/team-telnyx/telnyx-hermes-intelligence) |
  82. | 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) |
  83. | Speech-to-Text | Telnyx STT transcription-provider plugin for Hermes — streaming speech recognition | [Repository](https://github.com/team-telnyx/telnyx-hermes-stt) |
  84. | SMS | Telnyx SMS/MMS platform adapter for Hermes Agent | [Repository](https://github.com/team-telnyx/telnyx-hermes-sms) |
  85. Hermes voice-call support is in progress and will be added once finalized.
  86. ## Agent Toolkit
  87. Integrate Telnyx APIs with popular agent frameworks through function calling — available in [Python](/tools/python) and [TypeScript](/tools/typescript).
  88. ### Python
  89. ```sh
  90. pip install telnyx-agent-toolkit
  91. ```
  92. ```python
  93. from telnyx_agent_toolkit.openai.toolkit import TelnyxAgentToolkit
  94. toolkit = TelnyxAgentToolkit(
  95. api_key="KEY_...",
  96. configuration={
  97. "actions": {
  98. "messaging": {"send_sms": True},
  99. "numbers": {"search_phone_numbers": True, "buy_phone_number": True}
  100. }
  101. }
  102. )
  103. tools = toolkit.get_openai_tools()
  104. ```
  105. Works with OpenAI's Agent SDK, LangChain, and CrewAI. See [Python docs](/tools/python) for full usage and [examples](/tools/python/examples).
  106. ### TypeScript
  107. ```sh
  108. npm install @telnyx/agent-toolkit
  109. ```
  110. ```typescript
  111. import { TelnyxAgentToolkit } from "@telnyx/agent-toolkit/langchain";
  112. const toolkit = new TelnyxAgentToolkit(process.env.TELNYX_API_KEY!, {
  113. configuration: {
  114. actions: {
  115. messaging: { send_sms: true },
  116. numbers: { search_phone_numbers: true, buy_phone_number: true },
  117. },
  118. },
  119. });
  120. const tools = toolkit.getLangChainTools();
  121. ```
  122. Works with LangChain and Vercel's AI SDK. See [TypeScript docs](/tools/typescript) for full usage.
  123. ## Agent Skills
  124. Install individual skills for your coding assistant via the [Skills CLI](https://github.com/vercel-labs/skills):
  125. ```sh
  126. npx skills add team-telnyx/ai --skill <SKILL> --agent <AGENT>
  127. ```
  128. Skills 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 ACP, MPP, or x402 payments).
  129. Skills 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).
  130. > [!NOTE]
  131. > See [Skills](/skills/README.md) for full install instructions and a comprehensive list of available skills
  132. ## Agent CLI
  133. 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.
  134. ```sh
  135. telnyx-agent setup-sms # Buy number + create messaging profile + assign
  136. telnyx-agent setup-voice # Create SIP connection + buy number + assign
  137. telnyx-agent setup-ai # Create AI assistant + buy number + wire together
  138. telnyx-agent setup-porting # Check portability + create porting order + submit
  139. telnyx-agent status # Account health overview
  140. ```
  141. Every command supports `--json` for machine-readable output.
  142. See [Agent CLI](/cli)
  143. ## Model Context Protocol (MCP)
  144. Telnyx hosts a remote MCP server at `https://api.telnyx.com/v2/mcp`.
  145. To run a local Telnyx MCP server using npx:
  146. ```sh
  147. npx -y @telnyx/mcp --api-key=YOUR_TELNYX_API_KEY
  148. ```
  149. See [MCP](/tools/mcp) for more details about the generic API MCP proxy.
  150. ### MCP Apps
  151. [`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.
  152. Current apps:
  153. - Number Intelligence (`tools/mcp-apps/apps/number-intelligence`)
  154. - Usage & Cost Explorer (`tools/mcp-apps/apps/usage-cost-explorer`)
  155. - Voice Monitor (`tools/mcp-apps/apps/voice-monitor`)
  156. From `tools/mcp-apps`, use `npm install`, `npm run typecheck`, `npm run build`, and `npm test`.
  157. ## Guides
  158. Curl-first operational guides for common Telnyx workflows — SMS messaging, voice call control, AI assistants, phone numbers, porting, verification, webhooks, 10DLC registration, WireGuard networking, ACP, MPP, and x402 account payments, and Edge Compute handoff patterns.
  159. See [Guides](/guides) for the full list.
  160. ## Edge Compute
  161. Use 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.
  162. To 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>`).
  163. ## Maintainers
  164. Maintained 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).
  165. ## License
  166. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.