telnyx

Telnyx AI

This repo is the one-stop shop for AI Agents and AI-first developers building with Telnyx.

[!NOTE] This repository is a work in progress under active development. We are continuously improving based on testing and feedback. Contributions and feedback encouraged!

Table of contents

• Telnyx 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.

• 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 coding assistants accurate, up-to-date context about Telnyx APIs and SDKs.

• Agent CLI - provision and build on Telnyx infrastructure in a single command.

Plugins and Extenstion

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.

Empowers coding agents to generate correct, production-ready code without relying on pre-training or fragile doc retrieval.

Claude Code Plugin

Step 1. Add the Telnyx marketplace (one-time setup):

/plugin marketplace add team-telnyx/ai

Step 2. Install the plugin:

/plugin install telnyx@telnyx

Gemini CLI extension

 gemini extensions install https://github.com/team-telnyx/ai

Cursor

[!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"
      }
    }
  }

Agent Toolkit

Integrate Telnyx APIs with popular agent frameworks through function calling — available in Python and TypeScript.

Python

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.

TypeScript

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. for the full list of commands and options.

Agent Skills

Install individual skills for your coding assistant via the Skills CLI:

npx skills add team-telnyx/ai --skill <SKILL> --agent <AGENT>

[!NOTE] See Skills for full install instrcuctions and comprehensive list of available skills

Agent CLI

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 status            # Account health overview

Every command supports --json for machine-readable output.

See Agent CLI

Model Context Protocol (MCP)

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.

Guides

Curl-first operational guides for common Telnyx workflows — SMS messaging, voice call control, AI assistants, phone numbers, verification, webhooks, 10DLC registration, WireGuard networking, and x402 payments.

See Guides for the full list.

License

MIT