Skip to main content

Quickstart with Claude Code

1

Get your API key

Visit the Telnyx Portal to generate or copy your key.
2

Open Claude Code

Launch it in your terminal or IDE.
3

Add the Telnyx skills marketplace

/plugin marketplace add team-telnyx/telnyx-ext-agent-skills
4

Install the plugin for your language

/plugin install telnyx-python@team-telnyx/telnyx-ext-agent-skills
Each plugin includes full SDK documentation for all 35 Telnyx products, enabling Claude to write production-ready code with proper error handling and best practices.

Supported products

Messaging

  • Send SMS and MMS messages.
  • Receive and process inbound messages.
  • Manage messaging profiles.
  • 10DLC campaign registration.
  • Short code messaging.

Voice

  • Make and receive calls with Call Control.
  • Build IVR systems with TeXML.
  • Conference calling.
  • Call recording and transcription.
  • SIP trunking integrations.

Phone numbers

  • Search available numbers by location.
  • Purchase and provision numbers.
  • Port existing numbers.
  • Number reservation.
  • Regulatory compliance.

AI

  • Create Voice AI Assistants.
  • Configure AI behaviors and tools.
  • Speech-to-Text transcription.
  • Text-to-Speech generation.
  • Embeddings and knowledge bases.

Additional products

  • Fax API.
  • Verify API (2FA/OTP).
  • Wireless/IoT SIM management.
  • Cloud Storage.
  • WebRTC.
  • Networking and private connectivity.

Example prompts

Once installed, try asking Claude:
PromptWhat Claude Builds
”Send an SMS to +15551234567 saying ‘Your order has shipped’.”Messaging integration with error handling.
”Create a webhook server to receive inbound calls.”Express/Flask server with Call Control.
”Search for toll-free numbers in the US.”Number search and provisioning code.
”Build an IVR that routes calls based on keypad input.”TeXML application with DTMF handling.
”Create a Voice AI agent for appointment scheduling.”AI Assistant with custom tools.
”Set up call recording with automatic transcription.”Recording config with Deepgram STT.
”Port my number from Twilio to Telnyx.”Porting request with required fields.

How it works

  1. You describe what you want to build in natural language.
  2. Claude reads the Telnyx SDK documentation through the installed skill.
  3. Claude writes production-ready code with proper authentication, error handling, and best practices.
  4. You review and iterate until the implementation is complete.
The skills provide Claude with:
  • Complete SDK reference documentation.
  • Code examples and patterns.
  • Error handling best practices.
  • Authentication setup guides.
  • Webhook configuration examples.

Comparison: Agent Skills vs MCP Server

FeatureAgent SkillsMCP Server
Primary useWrite code that uses TelnyxExecute Telnyx actions directly
OutputSource code filesAPI calls and results
Best forBuilding applicationsQuick tasks and automation
LanguagesPython, Node.js, Go, Java, RubyN/A (direct execution)

Resources

Contributing

See github.com/team-telnyx/telnyx-ext-agent-skills for contribution guidelines and to report issues.