Telnyx MCP server

Telnyx TypeScript API Library

>)

This library provides convenient access to the Telnyx REST API from server-side TypeScript or JavaScript.

The full API of this library can be found in api.md.

It is generated with Stainless.

MCP Server

Use the Telnyx MCP Server to enable AI assistants to interact with this API, allowing them to explore endpoints, make test requests, and use documentation to help integrate this SDK into your application.

Note: You may need to set environment variables in your MCP client.

Installation

npm install telnyx

Usage

The full API of this library can be found in api.md.

<!-- prettier-ignore -->

import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});

const response = await client.calls.dial({
  connection_id: 'conn12345',
  from: '+15557654321',
  to: '+15551234567',
  webhook_url: 'https://your-webhook.url/events',
});

console.log(response.data);

Examples

Runnable examples are available for:

• Searching available phone numbers
• Sending messages
• Receiving messaging webhooks
• Verifying webhook signatures
• Call Control
• AI, addresses, and connections

Search for and order a phone number

const { data: availableNumbers } = await client.availablePhoneNumbers.list({
  filter: {
    country_code: 'US',
    national_destination_code: '312',
    limit: 1,
  },
});

const phoneNumber = availableNumbers?.[0]?.phone_number;
if (!phoneNumber) throw new Error('No phone numbers found');

const { data: order } = await client.numberOrders.create({
  phone_numbers: [{ phone_number: phoneNumber }],
});

Send an SMS

Shortened. The full README is on GitHub.