# Telnyx MCP

> Telnyx MCP lets your AI agent manage all aspects of your telecommunications infrastructure. Send and track SMS/MMS messages, check current account credits, list phone numbers, or configure messaging profiles—all from a single chat window.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** sms-api, mms-messaging, voice-ai, carrier-infrastructure, message-delivery, telecom-automation

## Description

Need to handle high-volume communications without leaving your IDE? This MCP connects directly to your Telnyx account, letting you manage everything related to texting and calling using natural conversation. Instead of logging into a dashboard, you just ask your agent what you need done. You can instantly check if you have enough credits before sending out a major campaign. Need to send an MMS with a specific image? Just tell the agent who it goes to and where the media is hosted. Beyond messaging, the MCP helps you manage phone numbers by listing all owned E.164 numbers or creating new application-specific messaging profiles. Because this connection lives on Vinkius, your agent can access these powerful telecom tools alongside thousands of others, keeping your entire workflow consolidated and simple.

## Tools

### create_messaging_profile
Creates and registers a new messaging profile within your Telnyx account for specific applications.

### delete_messaging_profile
Permanently removes an existing messaging profile; this action cannot be undone.

### get_account_balance
Retrieves the current, real-time credit balance remaining on your Telnyx account.

### get_message_details
Looks up a specific message's history and verifies its final delivery status.

### get_number_settings
Retrieves detailed configuration and capability information for one of your owned phone numbers.

### get_messaging_profile_details
Fetches specific data related to a particular messaging profile you have created.

### list_phone_numbers
Lists every E.164 phone number owned by the account and provides their unique IDs.

### list_messaging_profiles
Retrieves a complete list of all messaging profiles currently configured in your account.

### send_text_message
Sends an outbound SMS text message, requiring both the source and destination phone numbers.

### send_media_message
Transmits an MMS message that includes a media URL (JPEG/PNG) along with the required send/receive numbers.

## Prompt Examples

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

**Response:** 
```
Your current Telnyx account balance is $245.50. You possess sufficient credits to continue your standard outbound messaging and voice operations.
```

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

**Response:** 
```
I retrieved 2 active numbers from your account:
- +14155552671 (ID: 15b14eb1-XXXX)
- +14155559982 (ID: 39a48be9-XXXX)
Both are fully functional. Would you like to check the detailed settings for one of them?
```

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

**Response:** 
```
The SMS has been successfully submitted to Telnyx for delivery.
From: +14155552671
To: +12125550999
Message: 'The server is down.'
Message UUID: 8e5f22e8-xxxx. Would you like me to check its real-time delivery status?
```

## Capabilities

### Send Text Messages
Dispatch standard SMS texts to any number using a specified phone number.

### Send Multimedia Messages (MMS)
Send rich MMS messages that include external media URLs, like images or videos.

### Check Account Status
Retrieve your exact Telnyx account credit balance to verify spending capacity.

### Inspect Message Delivery
Look up specific message details and confirm whether a text was delivered, failed, or rejected.

### Manage Phone Numbers
List all active E.164 phone numbers owned by your account, along with their unique IDs and configuration settings.

## Use Cases

### Verifying SMS Campaign Readiness
A Marketing Manager needs to send 50,000 texts. They first prompt the agent with 'What is my current account balance?' and receive confirmation of credits via `get_account_balance`. Once verified, they tell the agent to run a test batch using `send_text_message`, ensuring funds are sufficient before launching the full campaign.

### Onboarding a New Application Channel
A Development Engineer needs a dedicated messaging channel for a new app. They ask the agent to 'Create a messaging profile named X,' triggering `create_messaging_profile`. After creation, they use `get_messaging_profile_details` to confirm all parameters are set correctly.

### Investigating Lost Messages
A Support Tech receives a ticket about a message that never arrived. They ask the agent for details on the UUID, triggering `get_message_details`. The tool immediately confirms whether the text was rejected or if it delivered successfully.

### Auditing Number Assets
An Operations Lead needs to confirm every number owned by the company. They instruct the agent to 'List all E.164 numbers,' using `list_phone_numbers` to get a full, auditable inventory of IDs and active lines.

## Benefits

- Stop checking multiple dashboards. You can check your account balance using `get_account_balance` and immediately know if you have the credits needed for a big campaign.
- Need to debug comms? Use `list_phone_numbers` to get all your owned numbers and then use `get_number_settings` to inspect any specific configuration details, all in one conversation.
- Sending content is simple. You can dispatch standard SMS texts with `send_text_message` or send complex MMS messages using `send_media_message`, specifying the media URL.
- The MCP lets you manage infrastructure setup by allowing you to create and delete messaging profiles via `create_messaging_profile` and `delete_messaging_profile` without needing a dedicated UI login.
- Support teams save time investigating failures. They can use `get_message_details` to instantly pull up the delivery status of any message, confirming if it was rejected or delivered.

## How It Works

The bottom line is you control complex telecom operations by talking to your AI client, instead of navigating multiple web portals.

1. Subscribe to this MCP on Vinkius and provide your private Telnyx API Key.
2. Your agent accesses the credentials, allowing it to query live account data like balances and number listings.
3. You issue a command or ask a question (e.g., 'Send an MMS to +1234...') and the MCP executes the required action.

## Frequently Asked Questions

**How do I check my account balance using Telnyx MCP?**
You prompt the agent to get your current credit balance by calling `get_account_balance`. This instantly tells you how much budget you have left for messaging operations.

**Can Telnyx MCP send images? What tool do I use?**
Yes, it sends rich MMS messages. You must use the `send_media_message` tool and provide a publicly accessible URL pointing to your JPEG or PNG image.

**What if I need to check delivery status after sending a message?**
You can use `get_message_details`. Just give it the unique message identifier, and it will tell you if the text was delivered, rejected, or is still pending.

**Does Telnyx MCP manage phone numbers only for sending messages?**
No. You can use `list_phone_numbers` to see all owned assets and `get_number_settings` to inspect detailed configuration settings for each number.

**How do I create a new messaging profile with Telnyx MCP?**
You initiate the process using `create_messaging_profile`. This allows you to set up dedicated communication channels for your applications without logging into the Telnyx console.