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.
> /plugin marketplace add team-telnyx/ai
Repo: team-telnyx/ai
What's inside
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!
Telnyx Plugins - 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.
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 and TypeScript.
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).
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 — see MCP.
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):
/plugin marketplace add team-telnyx/ai
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 for OpenCode to 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
See plugins/opencode/README.md for full setup and configuration.
[!NOTE] Note: Our Cursor Marketplace listing is pending.
In the meantime, install skills via the Skills CLI.
Add the Telnyx MCP server to your project's .cursor/mcp.json:
{
"mcpServers": {
"telnyx": {
"type": "http",
"url": "https://api.telnyx.com/v2/mcp"
}
}
}
Finalized Telnyx harness plugin repositories for OpenClaw and Hermes integrations:
OpenClaw
| Name | Description | Link |
|---|---|---|
| Voice Call | Telnyx-first Voice Call provider plugin for OpenClaw realtime voice agents | Repository |
| Text-to-Speech | Telnyx TTS speech provider for OpenClaw — carrier-grade voice synthesis | Repository |
| Speech-to-Text | Telnyx STT provider for OpenClaw audio transcription | Repository |
| Embeddings | Telnyx embedding provider for OpenClaw memory search | Repository |
| Intelligence | Telnyx AI text-inference provider plugin for OpenClaw | Repository |
| SMS Channel | OpenClaw channel plugin for SMS/MMS via Telnyx Messaging API | Repository |
Hermes
| Name | Description | Link |
|---|---|---|
| Intelligence | Telnyx AI text-inference provider plugin for Hermes | Repository |
| Text-to-Speech | Telnyx TTS speech-provider plugin for Hermes — WebSocket streaming, NaturalHD, and KokoroTTS voices | Repository |
| Speech-to-Text | Telnyx STT transcription-provider plugin for Hermes — streaming speech recognition | Repository |
| SMS | Telnyx SMS/MMS platform adapter for Hermes Agent | Repository |
Hermes voice-call support is in progress and will be added once finalized.
Integrate Telnyx APIs with popular agent frameworks through function calling — available in Python and TypeScript.
pip install telnyx-agent-toolkit
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. See Python docs for full usage and examples.
npm install @telnyx/agent-toolkit
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. See TypeScript docs for full usage.
Install individual skills for your coding assistant via the Skills 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) and account management (programmatic signup, 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] See Skills for 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 --json for machine-readable output.
See Agent CLI
Telnyx hosts a remote MCP server at https://api.telnyx.com/v2/mcp.
To run a local Telnyx MCP server using npx:
npx -y @telnyx/mcp --api-key=YOUR_TELNYX_API_KEY
See MCP for more details about the generic API MCP proxy.
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.
Current apps:
tools/mcp-apps/apps/number-intelligence)tools/mcp-apps/apps/usage-cost-explorer)tools/mcp-apps/apps/voice-monitor)From tools/mcp-apps, use npm install, npm run typecheck, npm run build, and npm 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.
See Guides for the full list.
Use this repo for agent workflows against Telnyx Edge Compute: the Agent 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 walks through the full workflow, from auth to a live endpoint.
To create, deploy, and manage the functions themselves (secrets, bindings, lifecycle), use the telnyx-edge CLI from team-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 (see CODEOWNERS). The fastest way to reach us is an issue; for security reports, see SECURITY.md.
.claude/
.claude-plugin/
marketplace.json
CLAUDE.md
.cursor/
.cursor-plugin/
marketplace.json
rules/
main.mdc
.cursorrules
.github/
bin/
check-release-environment
publish-npm
publish-pypi
CODE_OF_CONDUCT.md
CODEOWNERS
CONTRIBUTING.md
ISSUE_TEMPLATE/
bug_report.yml
config.yml
feature_request.yml
SECURITY.md
workflows/
integration-tests.yml
publish-npm.yml
publish-pypi.yml
release-doctor.yml
.gitignore
.windsurf/
rules.md
agent.json
AGENTS.md
cli/
.gitignore
bin/
telnyx-agent.mjs
telnyx-agent.ts
LICENSE
package-lock.json
package.json
README.md
scripts/
postinstall.ts
src/
client.ts
commands/
ai-anthropic-message.ts
ai-assistants.ts
ai-chat.ts
ai-embed.ts
call-control.ts
call-dial.ts
call-status.ts
capabilities.ts
edge-doctor.ts
fax-send.ts
fund-account.ts
messaging-profiles.ts
numbers.ts
porting-orders.ts
rcs-capabilities.ts
rcs-send.ts
schedule-sms.ts
send-group-mms.ts
send-sms.ts
setup-10dlc.ts
setup-ai.ts
setup-edge-mcp.ts
setup-edge-webhook.ts
setup-iot.ts
setup-porting.ts
setup-sms.ts
setup-verify.ts
setup-voice.ts
setup-whatsapp.ts
setup-wireguard.ts
sim-cards.ts
sms-status.ts
status.ts
stt-providers.ts
stt.ts
tts-voices.ts
tts.ts
verify-check.ts
verify-send.ts
voice-connections.ts
whatsapp-send.ts
whatsapp-templates.ts
edge-cli.ts
friction.ts
index.ts
platform-release.ts
semantic-version.ts
telemetry.ts
telnyx-cli.ts
utils/
idempotency.ts
message-status.ts
number-order.ts
output.ts
tests/
ai-assistants.test.ts
ai.test.ts
bin-launcher.test.ts
bugfixes.test.ts
client-network-errors.test.ts
e2e-full.sh
e2e-mock-server.mjs
E2E-RESULTS.md
e2e-walkthrough.sh
edge-handoff.test.ts
fax.test.ts
fixtures/
campaign-builder-submit.json
idempotency.test.ts
integration-ci-write.test.ts
integration-ci.test.ts
integration.test.ts
iot.test.ts
messaging-profiles.test.ts
numbers.test.ts
platform-release.test.ts
porting.test.ts
postinstall.test.ts
rcs.test.ts
schedule-sms-rest.test.ts
setup-10dlc.test.ts
setup-assign-flags.test.ts
setup-verify.test.ts
setup-voice-edge.test.ts
setup-voice.test.ts
sms.test.ts
status-rest.test.ts
stt.test.ts
telnyx-cli-flags.test.ts
telnyx-cli-resolution.test.ts
telnyx-shim.mjs
tts.test.ts
unknown-flags.test.ts
verify.test.ts
version.test.ts
voice-connections.test.ts
voice.test.ts
whatsapp.test.ts
tsconfig.json
gemini-extension.json
guides/
10dlc-registration.md
ai-assistants.md
edge-compute.md
email.md
mpp-payments.md
phone-numbers.md
phone-verification.md
porting-orders.md
rcs-messaging.md
sms-messaging.md
voice-call-control.md
webhooks.md
wireguard-networking.md
x402-payments.md
inference/
README.md
LICENSE
package-lock.json
package.json
plugins/
opencode/
.env.example
.gitignore
CHANGELOG.md
CONTRIBUTING.md
package-lock.json
package.json
README.md
scripts/
build-tui.ts
src/
index.ts
models-config.ts
tui.tsx
test/
models-config.test.ts
run.ts
tsconfig.json
README.md
providers/
claude/
plugins/
telnyx-ai/
.claude-plugin/
plugin.json
skills/
telnyx-ai-assistants-curl/
references/
api-details.md
SKILL.md
telnyx-ai-assistants-go/
references/
api-details.md
SKILL.md
telnyx-ai-assistants-java/
references/
api-details.md
SKILL.md
telnyx-ai-assistants-javascript/
references/
api-details.md
SKILL.md
telnyx-ai-assistants-python/
references/
api-details.md
SKILL.md
telnyx-ai-assistants-ruby/
references/
api-details.md
SKILL.md
telnyx-ai-inference-curl/
SKILL.md
telnyx-ai-inference-go/
SKILL.md
telnyx-ai-inference-java/
SKILL.md
telnyx-ai-inference-javascript/
SKILL.md
telnyx-ai-inference-python/
SKILL.md
telnyx-ai-inference-ruby/
SKILL.md
telnyx-email/
.claude-plugin/
plugin.json
skills/
telnyx-email-curl/
references/
api-details.md
SKILL.md
telnyx-email-domains-curl/
references/
api-details.md
SKILL.md
telnyx-email-inbound-curl/
references/
api-details.md
SKILL.md
telnyx-email-suppressions-curl/
references/
api-details.md
SKILL.md
telnyx-messaging/
.claude-plugin/
plugin.json
skills/
telnyx-messaging-curl/
references/
api-details.md
SKILL.md
telnyx-messaging-go/
references/
api-details.md
SKILL.md
telnyx-messaging-hosted-curl/
SKILL.md
telnyx-messaging-hosted-go/
SKILL.md
telnyx-messaging-hosted-java/
SKILL.md
telnyx-messaging-hosted-javascript/
SKILL.md
telnyx-messaging-hosted-python/
SKILL.md
telnyx-messaging-hosted-ruby/
SKILL.md
telnyx-messaging-java/
references/
api-details.md
SKILL.md
telnyx-messaging-javascript/
references/
api-details.md
SKILL.md
telnyx-messaging-profiles-curl/
SKILL.md
telnyx-messaging-profiles-go/
SKILL.md
telnyx-messaging-profiles-java/
SKILL.md
telnyx-messaging-profiles-javascript/
SKILL.md
telnyx-messaging-profiles-python/
SKILL.md
telnyx-messaging-profiles-ruby/
SKILL.md
telnyx-messaging-python/
references/
api-details.md
SKILL.md
telnyx-messaging-ruby/
references/
api-details.md
SKILL.md
telnyx-numbers/
.claude-plugin/
plugin.json
skills/
telnyx-10dlc-curl/
references/
api-details.md
SKILL.md
telnyx-10dlc-go/
references/
api-details.md
SKILL.md
telnyx-10dlc-java/
references/
api-details.md
SKILL.md
telnyx-10dlc-javascript/
references/
api-details.md
SKILL.md
telnyx-10dlc-python/
references/
api-details.md
SKILL.md
telnyx-10dlc-ruby/
references/
api-details.md
SKILL.md
telnyx-numbers-compliance-curl/
SKILL.md
telnyx-numbers-compliance-go/
SKILL.md
telnyx-numbers-compliance-java/
SKILL.md
telnyx-numbers-compliance-javascript/
SKILL.md
telnyx-numbers-compliance-python/
SKILL.md
telnyx-numbers-compliance-ruby/
SKILL.md
telnyx-numbers-config-curl/
SKILL.md
telnyx-numbers-config-go/
SKILL.md
telnyx-numbers-config-java/
SKILL.md
telnyx-numbers-config-javascript/
SKILL.md
telnyx-numbers-config-python/
SKILL.md
telnyx-numbers-config-ruby/
SKILL.md
telnyx-numbers-curl/
references/
api-details.md
SKILL.md
telnyx-numbers-go/
references/
api-details.md
SKILL.md
telnyx-numbers-java/
references/
api-details.md
SKILL.md
telnyx-numbers-javascript/
references/
api-details.md
SKILL.md
telnyx-numbers-python/
references/
api-details.md
SKILL.md
telnyx-numbers-ruby/
references/
api-details.md
SKILL.md
telnyx-numbers-services-curl/
SKILL.md
telnyx-numbers-services-go/
SKILL.md
telnyx-numbers-services-java/
SKILL.md
telnyx-numbers-services-javascript/
SKILL.md
telnyx-numbers-services-python/
SKILL.md
telnyx-numbers-services-ruby/
SKILL.md
telnyx-porting-in-curl/
SKILL.md
telnyx-porting-in-go/
SKILL.md
telnyx-porting-in-java/
SKILL.md
telnyx-porting-in-javascript/
SKILL.md
telnyx-porting-in-python/
SKILL.md
... 1600 moreShowing a partial view of a very large repo.
FAQ
team-telnyx-ai is a Claude Code plugin with 200 hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. It includes telnyx-ai-assistants-curl, telnyx-ai-assistants-go, telnyx-ai-assistants-java. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.