LABSCO SUMMARY

The skills exist because the API alone is not enough.

A model that can call the Telnyx API will still write code that does not work, because provisioning a working phone number is four operations in the right order with the right identifiers. That is what the agent skills and the composite CLI commands encode — setup-sms is one command precisely because getting it wrong is the common failure. If you want to try the MCP server alone, the hosted endpoint is the fastest route; the skills are what make the generated code correct.

What it is

Telnyx's repository for building against its platform with an AI assistant. The MCP server is one piece of it: Telnyx hosts a remote server that proxies its API, and around that sit agent skills, a toolkit for function-calling frameworks, and a CLI that collapses multi-step provisioning into single commands.

What you get

A hosted MCP server at https://api.telnyx.com/v2/mcp that proxies the Telnyx API, or the same thing run locally with npx @telnyx/mcp
Focused app-layer MCP servers for particular jobs — Number Intelligence, Usage & Cost Explorer and Voice Monitor — separate from the generic API proxy
Agent skills covering messaging, voice, numbers, AI, IoT, WebRTC and Twilio migration, installed as a Claude Code plugin, a Gemini CLI extension, or through the Skills CLI
A Telnyx agent CLI with composite commands: setup-sms buys a number, creates a messaging profile and assigns it; setup-voice does the SIP connection and number together; setup-ai wires an assistant to a number; setup-porting checks portability and submits the order; status gives an account overview. All support machine-readable output
An agent toolkit in Python and TypeScript, for wiring Telnyx into function-calling frameworks directly
Curl-first operational guides for SMS, voice call control, AI assistants, phone numbers, porting, verification, webhooks, RCS, email, payments and edge compute
Provider plugins for OpenClaw and Hermes covering text inference, text-to-speech, speech-to-text, embeddings and SMS channels
An Agent Plugins manifest at the repository root, so compatible clients can pick the whole thing up in one step

Requirements

A Telnyx account and API key — passed as a launch argument for the local server, or as credentials for the hosted endpoint. The CLI, the skills and the toolkit are separate installs, each optional. Telnyx bills for what you actually provision and send: numbers, messages, minutes. MIT licensed.

Setup effort

One command plus a key — npx -y @telnyx/mcp --api-key=<YOUR_TELNYX_API_KEY>, then supply credentials

See installation options

USE CASES

01

Getting SMS working from nothing

Run the one command that buys the number, creates the messaging profile and assigns them to each other.

02

Building voice into an application

Provision the SIP connection and number together, then follow the call-control guide for the code.

03

Migrating off Twilio

Install the migration skill and let the assistant translate the code and the concepts.

04

Working out where the bill is going

Connect the usage and cost app rather than reading the generic API surface.

05

Porting numbers from another carrier

Check portability and submit the porting order in one step, then track it.

06

Checking a number before you use it

Connect the number intelligence app and look it up from the conversation.

BEFORE YOU INSTALL

What to know first

Requires

A client that can reach a remote MCP server over HTTP
A Telnyx API key (from the Telnyx portal or telnyx.com/agent-signup.md), in the Authorization: Bearer header for the hosted endpoint or in --api-key for npx @telnyx/mcp

INSTALLATION

Connect your client

Server setup

npx

TERMINAL

npx -y @telnyx/mcp --api-key=<YOUR_TELNYX_API_KEY>

Hosted endpoint

ENDPOINT URL

https://api.telnyx.com/v2/mcp

Add this hosted endpoint to your MCP client using the credentials listed under Requirements.

MCP Clients

Cursor, Any MCP client

JSON

{
  "mcpServers": {
    "telnyx": {
      "type": "http",
      "url": "https://api.telnyx.com/v2/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TELNYX_API_KEY>"
      }
    }
  }
}

Gemini CLI

GEMINI CLI · TERMINAL

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

Telnyx