# Telnyx MCP for AI Agents AI Agent Connect

> Telnyx MCP lets you send SMS and MMS, check delivery statuses, and manage your phone numbers and messaging profiles directly through your AI agent. It gives you a way to handle telecom tasks without leaving your chat interface.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_iiiZTbwVkSLhjWuP4oHrPSVuEKxkBdhKfZ8uGYWc/ai-agent-connect
- **Tags:** sms-api, mms-messaging, voice-ai, carrier-infrastructure, message-delivery, telecom-automation

## Description

Connect your Telnyx account to any AI agent and manage your voice and messaging operations directly through natural conversation. If you're tired of jumping between browser tabs to check if your SMS actually landed or if you've got enough credits to send another blast, this is the solution. You can ask your agent to check your current balance, pull up a list of your active phone numbers, or even set up new messaging profiles without ever touching a dashboard. If you're part of a larger team, you can find this Connector in the Vinkius catalog to keep your tools organized and accessible. It turns your agent into a telecom operator that handles the boring stuff while you focus on the actual content. Instead of manually clicking through menus to provision numbers or verifying message statuses, you just describe what you need to your agent. It handles the API calls to send texts, check delivery logs, and manage your messaging profiles. This means you spend less time on administrative tasks and more time on your actual work. You can quickly verify if a message was rejected or delivered, which is a lifesaver when troubleshooting communication issues for customers.

## Tools

### get_account_balance
Get your current Telnyx credit balance instantly. This helps you see if you have enough funds before launching a large SMS campaign.

### delete_messaging_profile
Permanently remove a messaging profile from your account. This action is irreversible, so use it only when you are sure you no longer need the profile.

### get_messaging_profile_details
Get the full details for a specific messaging profile. Use this to verify the settings of an existing profile.

### list_phone_numbers
List all the phone numbers owned by your account along with their unique IDs. This is great for quickly auditing your active numbers.

### list_messaging_profiles
See a list of all the messaging profiles in your account. Use this to manage your various application profiles in one place.

### send_text_message
Send an outbound SMS message to a target number. Provide the from and to numbers in E.164 format to get your message sent.

### send_media_message
Send an outbound MMS message that includes a public media URL. This lets you share images or other media via text.

### create_messaging_profile
Create a new messaging profile for your application. This allows you to set up new communication paths quickly.

### get_message_details
Look up the specific details and delivery status for any message. Use this to find out exactly why a text was delivered or rejected.

### get_number_settings
Retrieve the configuration and capability details for a specific phone number. This is useful for checking what features a number supports.

## Prompt Examples

**Prompt:** 
```
What is my current Telnyx account balance?
```

**Response:** 
```
Your current Telnyx account balance is **$245.50**. 

*   **Status**: Sufficient credits
*   **Next Action**: You are ready to proceed with your scheduled SMS campaigns.
```

**Prompt:** 
```
List all the phone numbers I currently own.
```

**Response:** 
```
I found **2 active numbers** in your account:

| Number | Unique ID |
| :--- | :--- |
| +1 415 555 2671 | 15b14eb1-XXXX |
| +1 415 555 9982 | 39a48be9-XXXX |

Would you like me to check the settings for one of these?
```

**Prompt:** 
```
Send a text from +14155552671 to +12125550999 saying the server is down.
```

**Response:** 
```
The SMS has been submitted successfully.

*   **From**: +14155552671
*   **To**: +12125550999
*   **Message**: 'The server is down.'
*   **Message UUID**: 8e5f22e8-xxxx

I can check the real-time delivery status for you if you'd like.
```

## Capabilities

### Send SMS and MMS texts
Dispatch outbound text messages and media links to any target number.

### Verify message delivery
Check the real-time status of sent messages to see if they were delivered or rejected.

### Browse phone numbers
View all active phone numbers in your account and see their specific configuration details.

### Manage messaging profiles
Create, list, and delete profiles for your different applications and services.

### Monitor account credits
Check your current balance and available credits before launching a new campaign.

## Use Cases

### Debugging messaging webhooks
A developer uses get_message_details to find the specific UUID of a failed webhook and check why the message was rejected by the carrier.

### Pre-campaign balance checks
A marketing manager asks the agent to check their credit balance before they trigger a massive SMS blast to ensure they have enough funds.

### Investigating delivery failures
A support tech asks the agent to look up a specific message status to see if a customer's text failed due to a blocked number or a carrier error.

### Rapid number provisioning
An operations lead uses create_messaging_profile to set up a new messaging path for a new regional branch in seconds.

## Benefits

- Check your balance with get_account_balance before starting a campaign to ensure you don't run out of credits mid-send.
- Verify delivery with get_message_details to quickly identify and fix issues with failed texts.
- Audit your inventory using list_phone_numbers to see every number you own and their unique IDs in one list.
- Provision new app paths with create_messaging_profile to get your services live without clicking through menus.
- Send rich content with send_media_message to share images and URLs with your customers via MMS.
- Verify configurations with get_number_settings to ensure your numbers have the correct capabilities for your needs.

## How It Works

The bottom line is you can manage your entire Telnyx telecom setup using just natural language.

1. Enter your Telnyx API Key into the Connector configuration.
2. Connect your preferred AI client to the Vinkius-hosted MCP.
3. Ask your agent to perform tasks like sending a text or checking your current balance.

## Frequently Asked Questions

**Can I use the Telnyx MCP to send MMS messages?**
Yes, you can send MMS messages with public JPEG or PNG URLs using your AI agent. It handles the media link and the delivery for you.

**How do I check if my text actually reached the customer with Telnyx MCP?**
You can ask your agent to look up the delivery status for a specific message. It will tell you if the text was successfully delivered, rejected, or is still pending.

**Can I manage my phone numbers using the Telnyx MCP?**
Yes, you can list all your active numbers and view their configuration details. You can also check specific settings for any number in your account.

**How do I see my current credit balance with Telnyx MCP?**
Just ask your agent for your current balance. It will retrieve your real-time credit amount so you know how many messages you can send.

**Is the Telnyx MCP good for marketing teams?**
It is great for marketing teams who need to quickly check balances before a blast or verify that their campaign messages were delivered successfully.

**Can I create new messaging profiles with Telnyx MCP?**
Yes, you can create, list, and delete messaging profiles for your different applications directly through your AI agent.

**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.