4,500+ servers built on MCP Fusion
Vinkius

Telnyx MCP. Manage messages, profiles, and credits with prompts.

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

Telnyx MCP on Cursor AI Code Editor MCP Client Telnyx MCP on Claude Desktop App MCP Integration Telnyx MCP on OpenAI Agents SDK MCP Compatible Telnyx MCP on Visual Studio Code MCP Extension Client Telnyx MCP on GitHub Copilot AI Agent MCP Integration Telnyx MCP on Google Gemini AI MCP Integration Telnyx MCP on Lovable AI Development MCP Client Telnyx MCP on Mistral AI Agents MCP Compatible Telnyx MCP on Amazon AWS Bedrock MCP Support

Just plug in your AI agents and start using Vinkius.

Telnyx MCP Server handles SMS/MMS sending, account monitoring, and messaging profile management. Use your agent to send text messages from specific numbers, check the live balance, or configure application-level messaging profiles without leaving your IDE.

What your AI agents can do

Create messaging profile

Sets up a new messaging profile for your application.

Delete messaging profile

Permanently removes an existing messaging profile. This action cannot be undone.

Get account balance

Retrieves the current available credit balance on your Telnyx account.

+ 7 more capabilities included
Send SMS/MMS

Your agent sends outbound text messages and multi-media messages using your registered Telnyx numbers.

Check Account Credit Balance

It pulls the current credit balance, letting you know if you have enough funds to send messages.

Manage Phone Numbers

You can list all owned numbers and check their specific configuration details (E.164 format).

Control Messaging Profiles

The system lets you create, read, update, or delete the profiles that govern how your application sends messages.

Track Message Status

You can get detailed status reports on any sent message, confirming successful delivery or failure reasons.

Supported MCP Clients

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
+ other MCP clients
Free for Subscribers

Waiting for input…

AI Agent

Telnyx MCP Server: 10 Tools for Messaging Control

Use these tools to manage everything from sending messages (SMS/MMS) to configuring application-specific messaging profiles in your Telnyx account.

create019d7611

create messaging profile

Sets up a new messaging profile for your application.

delete019d7611

delete messaging profile

Permanently removes an existing messaging profile. This action cannot be undone.

get019d7611

get account balance

Retrieves the current available credit balance on your Telnyx account.

get019d7611

get message details

Looks up delivery status and details for a message using its unique ID.

get019d7611

get messaging profile details

Retrieves the full configuration and settings for one specific messaging profile.

get019d7611

get number settings

Gets detailed configuration and capability information for a single phone number.

list019d7611

list messaging profiles

Pulls a list of all messaging profiles currently set up in your account.

list019d7611

list phone numbers

Lists every phone number owned by the account, including their unique IDs.

send019d7611

send media message

Sends an outgoing MMS message that includes a public JPEG or PNG image URL.

send019d7611

send text message

Sends a standard outbound SMS text message using your registered number.

Choose How to Get Started

Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.

Build Your Own

Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.

  • Import from OpenAPI, Swagger, or YAML specs
  • Create Agent Skills with progressive disclosure
  • Deploy to edge with MCPFusion framework
  • Built in DLP, auth, and compliance on every call
  • Real time usage dashboard and cost metering
  • Publish to catalog or keep private
Start building

Make Your AI Do More

Start with Telnyx, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.

  • Use this MCP plus 4,700+ others, all in one place
  • Add new capabilities to your AI anytime you want
  • Every connection is secured and compliant automatically
  • Track usage and costs across all your servers
  • Works with Claude, ChatGPT, Cursor, and more
  • New servers added to the catalog every week

What you can do with this MCP connector

You don't need a fancy GUI to handle your messaging operations; your agent connects directly to Telnyx, letting you run all SMS and MMS tasks from right where you are coding. You manage everything—sending messages, checking balances, setting up profiles, and tracking delivery status—all through simple commands.

When it comes to sending actual texts, you've got two tools. To fire off a standard outbound text message using one of your registered numbers, you use send_text_message. If you need to send something bigger—like an MMS that includes a JPEG or PNG image—you call send_media_message and pass it the public URL for the media.

To confirm if those texts actually got there, you check the status using get_message_details, which requires only the unique message ID to report back on successful delivery or why a text failed.

For number management, your agent lets you see exactly what numbers you own. You can pull a complete list of all owned phone numbers by running list_phone_numbers; this gives you every unique ID and E.164 format number tied to the account. If you need more deep details on one specific number—like its full configuration or capabilities—you hit up get_number_settings.

Controlling how your app sends messages requires managing messaging profiles, and this is where you do all the heavy lifting. To see what profiles already exist, you run list_messaging_profiles, which pulls a rundown of everything set up. If you need to create a whole new profile for a different application or use case, you call create_messaging_profile.

You can check the full setup and configuration details of any specific profile using get_messaging_profile_details. Remember that if you're done with a profile, you have to remove it entirely by running delete_messaging_profile; that action is permanent.

Before you send out a massive batch of messages or run any campaign, you gotta know what kind of dough you got. You check the available credit balance using get_account_balance, which gives you the current number on your Telnyx account so you don't get shut down mid-campaign.

Overall, this setup lets you manage all aspects of messaging—from listing every single phone number with list_phone_numbers to getting its specific details via get_number_settings, and from setting up new application rules using create_messaging_profile and viewing them with get_messaging_profile_details, down to confirming delivery status on a single message using get_message_details. You're running SMS via send_text_message or MMS with images via send_media_message, all while keeping an eye on your funds with get_account_balance.

This comprehensive toolset means you never gotta leave your IDE to handle core messaging operations.

How Telnyx MCP Works

  1. 1 Subscribe to the Telnyx server and provide your API Key.
  2. 2 Your AI agent calls a tool (e.g., get_account_balance) based on your natural language prompt.
  3. 3 The server executes the operation, and your agent returns the specific data or confirmation.

The bottom line is that you run all telecom commands directly from your chat client using simple prompts.

Who Is Telnyx MCP For?

This is for anyone who runs messaging campaigns and can't afford to waste time in a dashboard. If you’re an ops engineer tired of clicking through three different screens just to check if last night's campaign went out, this works for you. It puts the entire telecom control panel right into your chat agent.

Development Engineer

Debugging message webhook failures or quickly provisioning new messaging profiles without leaving their IDE.

Marketing Manager

Verifying account credit before launching a massive SMS broadcast, or triggering specific text campaigns on demand.

Technical Support Analyst

Investigating why a client message failed by retrieving precise delivery status and error codes in seconds.

What Changes When You Connect

  • Checks the account balance before sending. The get_account_balance tool stops you from running campaigns when your funds run low.
  • Streamlines number management. Instead of digging through a console, use list_phone_numbers to get all owned numbers and their IDs instantly.
  • Handles complex messaging flows. You can send both simple texts (send_text_message) and MMS with images (send_media_message).
  • Keeps configuration clean. The system lets you create, update, or delete profiles using create_messaging_profile and its siblings.
  • Pinpoints failures fast. If a message goes wrong, running get_message_details tells you exactly why it failed—delivered, rejected, etc.

Real-World Use Cases

01

Campaign Pre-flight Check

A marketing manager needs to run 10k SMS messages but isn't sure if the account has enough credit. They ask their agent: 'Check my balance, then send a test text.' The agent first uses get_account_balance and confirms funds, then runs send_text_message, confirming readiness before the full blast.

02

Debugging Failed Delivery

A support tech receives reports of failed messages. Instead of manually checking logs in a separate dashboard, they use their agent to run get_message_details with the message UUID. The agent immediately reports the failure reason and status.

03

Setting up New App Features

A dev team is building a new notification system. They first list all available numbers using list_phone_numbers. Then, they use create_messaging_profile to set up the specific rules for that new application feature.

04

Mass MMS Broadcast

A company needs to send an update with a promotional image. The agent handles this by first confirming number availability via list_phone_numbers, and then executes the send_media_message tool, providing both the recipient list and the media URL.

The Tradeoffs

Assuming a universal 'Send' button

Trying to manually send an MMS with images just because you think it’s like sending a plain SMS. You might fail if the media URL isn't public or formatted wrong.

For media, always use send_media_message. For simple text, stick to send_text_message. The tools are separate for a reason.

Over-relying on GUI dashboards

Having to switch between the Telnyx website dashboard, your IDE, and a ticketing system just to confirm if one message succeeded.

Keep everything in the chat. Use get_message_details to check status, or use get_account_balance to check credits—all via simple conversation.

Trying to manage profiles manually

Manually navigating complex profile settings in a web interface just because you changed how your app sends messages.

Use the specific tools. List them with list_messaging_profiles, get details with get_messaging_profile_details, and then make changes using create_messaging_profile or delete_messaging_profile.

When It Fits, When It Doesn't

Use this if your primary need is to manage, send, or troubleshoot SMS/MMS communications in a programmatic way. This server provides the necessary tools (like send_text_message, get_account_balance) to integrate messaging into existing agent workflows.

Don't use this if you need general VoIP call logging (it focuses on text). Also, don't use it for managing billing records outside of checking the credit balance; that requires a dedicated accounting system. If your issue is 'I can't send a message,' this is probably what you need. If your issue is 'My phone number isn't working,' check get_number_settings first.

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Telnyx. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

VINKIUS INFRASTRUCTURE

Cloud Hosted

Managed infra

V8 Isolated

Sandboxed per request

Zero-Trust Proxy

No stored credentials

DLP Enforced

Policy on every call

GDPR Compliant

EU data residency

Token Compression

~60% cost reduction

How we secure it →

Works with Claude, ChatGPT, Cursor, and more

The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.

This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.

Available Capabilities

create_messaging_profile delete_messaging_profile get_account_balance get_message_details get_messaging_profile_details get_number_settings list_messaging_profiles list_phone_numbers send_media_message send_text_message

Messaging tasks shouldn't require switching between three different tabs.

Today, sending a message often means opening the Telnyx dashboard to find your number list. Then you might have to navigate to messaging profiles just to ensure the campaign rules are correct. If you need to check the balance before hitting 'Send,' that's another tab and another manual verification step.

With this MCP server, you tell your agent: 'Check my credit, make sure Profile X is active, and then send a text.' It handles the sequence of `get_account_balance`, checks profiles via `list_messaging_profiles`, and executes `send_text_message`—all in one flow. You just get the result.

Telnyx MCP Server: Manage messaging profile settings.

Manual setup means creating a new profile, then updating its parameters (like which numbers it uses), and finally testing that specific combination. If you mess up the profile, debugging requires cross-referencing old logs against current rules.

Now, you just tell your agent: 'Create a messaging profile called 'Alerts' and give it these settings.' The tool runs `create_messaging_profile` and instantly provisions the resource. It’s about making changes in conversation.

Common Questions About Telnyx MCP

How do I check my Telnyx account balance using get_account_balance? +

Just ask your agent: 'What is my current Telnyx account balance?' The get_account_balance tool runs and returns the exact credit amount available for sending messages.

Can I send a text message with get_message_details? +

No, get_message_details only reads data. You use send_text_message to dispatch an SMS or MMS. The details tool is for checking the status of messages that were already sent.

What's the difference between list_phone_numbers and get_number_settings? +

Use list_phone_numbers to pull a simple inventory list of every number you own. Then, if you need specific details about one of those numbers—like its capabilities or type—you run get_number_settings.

How do I delete a messaging profile? +

You use the delete_messaging_profile tool. Just be careful, because this action is permanent and cannot be reversed after running the command.

What do I need to provide when running `list_phone_numbers`? +

You must first connect your Telnyx API Key to the server. The agent uses this key for authentication, allowing it to read and list all associated E.164 numbers owned by your account.

After running `send_text_message`, how do I check its delivery status? +

Use the get_message_details tool. You must provide the unique Message UUID generated after sending. This pulls real-time data, confirming if the message was successfully delivered or rejected by the carrier.

I ran `list_messaging_profiles`; how do I retrieve a specific profile's settings? +

You need to run get_messaging_profile_details and pass in the exact ID of the profile. Listing only gives you names; this tool pulls the full configuration structure for that single profile.

What is the required format when using `send_media_message`? +

The tool requires three inputs: sender number, recipient number, and a URL. The media URL must point to a 100% public JPEG or PNG file for the MMS message to send correctly.

Can my AI agent check if a specific message was delivered? +

Yes. If an end user reports completely missing an important text, you can ask your agent to pull up the message status using its unique ID. The agent will read back exactly whether Telnyx successfully handed off the payload or if it encountered carrier-level rejection codes.

Is it possible to track the account billing balance? +

Absolutely. You can request your current Telnyx account balance to confirm you have enough credit left to continue broadcasting. Just ask 'What is my current Telnyx balance?' and your agent will give you the exact remaining dollar threshold.

Can I configure new Messaging Profiles via AI? +

Yes! Developers often need to isolate test traffic from production. You can simply ask your agent to list all current global profiles, and if needed, instruct it to immediately create a new messaging profile to attach webhook URLs.

You might also like

Built & Managed by Vinkius 30s setup 10 tools

We've already built the connector for Telnyx. Just plug in your AI agents and start using Vinkius.

No hosting. No infrastructure. No complex setup.
All 10 tools are live and waiting. You're up and running in seconds.

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
+ other MCP clients

Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.

Zero hosting required Full MCP catalog included Enterprise-grade security Auto-updated by Vinkius

Built, hosted, and secured by Vinkius. You just connect and go.