Telnyx

io.github.stucchiPublished by GitHub account stucchiv0.1.1Updated Oct 24, 2026

MCP server for the Telnyx API — billing, phone numbers, and messaging

VerifiedSTDIODesktop onlyFinanceCommunication & CollaborationBusiness & Commerce

Overview

AI-generated overview

Local MCP server for the Telnyx API that lets an assistant check billing, manage phone numbers and send SMS messages.

What you can do
Check account balance, pending charges, credit limit and invoices, and break down or summarize charges for a date range of up to 60 days. List phone numbers on the account and get details of a specific number. Search available numbers to buy and order a phone number. Send SMS messages, list sent and received messages, and list messaging profiles.
When to use it
Useful when you want an assistant to answer questions about Telnyx billing and invoices, review or buy phone numbers, or send and review SMS messages through a Telnyx account.
Requirements
Runs as a local process via uvx (Python package telnyx-mcp). Requires a Telnyx account and a Telnyx API key supplied in the TELNYX_API_KEY environment variable. Network access to the Telnyx API is needed.
Before you install
The server can order (purchase) phone numbers and send SMS messages, which spend money and contact third parties. It holds a Telnyx API key in TELNYX_API_KEY, so treat that key as sensitive and scope it appropriately.

Installation

In SourceWeft

  1. Open Telnyx in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

telnyx-mcp

MCP server for the Telnyx API — billing, phone numbers, and messaging.

Tools

Billing

  • get_balance — Account balance, pending charges, credit limit
  • list_invoices — List all invoices
  • get_invoice — Get a specific invoice
  • get_charges_breakdown — Charges breakdown for a date range (max 60 days)
  • get_charges_summary — Charges summary for a date range

Phone Numbers

  • list_phone_numbers — List all phone numbers on the account
  • get_phone_number — Get details of a specific phone number
  • search_available_numbers — Search available numbers to purchase
  • order_phone_number — Order/purchase a phone number

Messaging

  • send_message — Send an SMS message
  • list_messages — List sent and received messages
  • list_messaging_profiles — List messaging profiles

Installation

bash
uvx telnyx-mcp

Claude Code

json
{  "mcpServers": {    "telnyx": {      "command": "uvx",      "args": ["telnyx-mcp"],      "env": {        "TELNYX_API_KEY": "<your-api-key>"      }    }  }}

Get your API key from portal.telnyx.com.

License

MIT

Source: README.md at commit 7e965df

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.