# Bandwidth MCP for AI Agents AI Agent Connect

> Bandwidth MCP lets you automate your entire cloud communications stack through natural conversation. It handles everything from sending high-volume SMS and MMS alerts to managing 10DLC campaign compliance and verifying toll-free numbers. Instead of juggling multiple dashboards or writing complex webhook logic, you can just tell your AI agent to blast an outage notice, check your messaging health, or audit your campaign status. It's built for teams that need carrier-grade messaging without the manual overhead.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_N3lPmDiRL7cG3b018B408S1puPZvUAbjpfxrr5JM/ai-agent-connect
- **Tags:** cpaas, sms-api, mms-messaging, 10dlc, telecom-automation, carrier-grade

## Description

The Bandwidth MCP lets you automate your entire cloud communications stack through natural conversation. Imagine you need to send out a massive text alert for a system outage. Usually, that involves jumping between tabs, logging into a portal, checking your 10DLC campaign status, and then manually triggering a blast when something goes wrong. It's a lot of clicking and easy to mess up. This Connector changes that by letting you do it all through your AI agent. You just ask it to send an alert or check a campaign, and it handles the heavy lifting of interacting with the API for you. You can manage your 10DLC TCR profiling to keep your promotional texts from getting blocked, or quickly ping the telecom backbone to make sure your routing is healthy. It even handles the messy stuff like clearing old media payloads or iterating through your messaging history to find specific logs. By adding this to your toolkit on Vinkius, you turn a complex CPaaS workflow into a simple conversation. If you're a support lead, you can blast priority alerts instantly. If you're a marketing manager, you can audit campaign health to ensure your messages actually land. If you're a DevOps engineer, you can check the health of the telecom backbone before scaling your systems. You get to stop worrying about the underlying API complexity and start focusing on actually reaching your customers.

## Tools

### delete_media
Remove a specific media asset from your storage. This helps keep your account clean.

### get_toll_free
List your toll-free number verifications. This is great for checking compliance.

### get_health
Ping the Bandwidth API to see if the service is up. Use this for quick health checks.

### list_campaigns
View all your 10DLC messaging campaigns. Use this to audit your active marketing rules.

### list_applications
See all your Messaging Applications in one list. This helps you organize your account.

### list_media
See all the media files you have uploaded. This helps you manage your storage limits.

### get_campaign
Get the status and details for a 10DLC campaign. Use this to check if your messages are allowed.

### list_messages
View your history of sent and received messages. Use this to audit your communication logs.

### send_mms
Send a message that includes an image or video. This is perfect for rich media alerts.

### send_sms
Send a standard text message through the Bandwidth API. Use this for quick notifications.

## Prompt Examples

**Prompt:** 
```
Send a text to +15550001111 saying the maintenance window is now open.
```

**Response:** 
```
### SMS Dispatch Confirmation

| Field | Details |
| :--- | :--- |
| **Recipient** | +15550001111 |
| **Status** | Sent Successfully |
| **Timestamp** | 2026-07-10 14:22:01 UTC |
| **Carrier Route** | Primary Gateway |

The message has been queued and successfully handed off to the carrier.
```

**Prompt:** 
```
Check if my 10DLC campaign is still active and tell me the status.
```

**Response:** 
```
### Campaign Audit

Your campaign **'Summer_Promo_2026'** is currently active.

*   **Status:** Approved
*   **TCR Profile:** Verified
*   **Messaging Rules:** Active

Your promotional texts are cleared to send without carrier filtering.
```

**Prompt:** 
```
List all my uploaded media and tell me how many files there are.
```

**Response:** 
```
### Bandwidth Media Storage

I found **12** media assets currently hosted in your account:

*   `hero_banner_v2.png`
*   `promo_video_short.mp4`
*   `outage_alert_icon.jpg`
*   ... (9 more files)

Would you like me to delete any of these for you?
```

## Capabilities

### Send SMS alerts
Dispatch text messages to any number instantly.

### Send MMS with media
Include images or videos in your messages.

### Manage 10DLC campaigns
Audit and approve your messaging rules.

### Verify toll-free numbers
Check your upstream approval headers.

### Check API health
Ping the telecom backbone for status updates.

### Manage media assets
List and delete files in your storage.

### Audit messaging logs
View your history of sent and received texts.

## Use Cases

### Outage Notifications
A support lead asks the agent to send a text to all users about a server crash. The agent uses send_sms to blast the alert.

### Marketing Audit
A marketing manager wants to see if their 10DLC campaign is approved. The agent runs get_campaign and reports the status.

### Storage Cleanup
A developer needs to clear space. They ask the agent to find all media files and delete the ones from last year using list_media and delete_media.

### Infrastructure Health Check
A DevOps engineer wants to know if the telecom backbone is up. The agent runs get_health and confirms a 200 OK status.

## Benefits

- Stop manual portal logins by using send_sms to dispatch alerts directly from your chat app.
- Keep your messages from getting blocked by auditing 10DLC rules with list_campaigns.
- Manage your storage costs by finding and removing old files with list_media and delete_media.
- Get instant status updates on your infrastructure by pinging the API with get_health.
- Track your communication history easily by querying your full logs with list_messages.
- Verify your compliance status quickly by checking toll-free headers with get_toll_free.

## How It Works

The bottom line is you get a direct line to your telecom stack without writing a single line of integration code.

1. Subscribe to the Bandwidth MCP on Vinkius.
2. Provide your Bandwidth Account ID, Username, and Password.
3. Give your AI agent commands like 'send a text' or 'check campaign status.'

## Frequently Asked Questions

**Can the Bandwidth MCP send text messages automatically?**
Yes, it lets your agent send SMS alerts or MMS messages with media attachments directly. You can trigger these via natural conversation instead of using a web portal.

**How do I manage 10DLC campaigns with this Connector?**
You can use it to list your active campaigns and get specific details on their approval status. This helps you ensure your marketing messages stay compliant.

**Can I check the status of my toll-free numbers?**
Yes, the Connector can list your toll-free number verifications to check for compliance. This is useful for ensuring your numbers are ready for high-volume traffic.

**Does this Connector help with carrier filtering?**
It helps you monitor your 10DLC TCR profiling and campaign rules to help prevent carrier blocks. By staying on top of these rules, your messages are more likely to land.

**Can I delete old media files using this?**
Yes, your agent can list all your uploaded media and delete specific assets to free up storage. This saves you from having to manually browse through large file lists.

**How do I know if the Bandwidth API is working?**
You can have your agent ping the health endpoint to confirm the telecom backbone is operational. It's a fast way to check for service issues before you launch a campaign.

**Can my AI agent check if my 10DLC campaign is cleared for high-volume SMS?**
Yes. Ask the agent to list your 10DLC campaigns or check a specific campaign ID. It natively surfaces throughput limits (like TPS bounds) set by TCR preventing you from getting blocked by aggressive mobile carriers.

**How do I troubleshoot SMS delivery failures using the agent?**
You can tell the agent to 'List messages filtered by phone number +1XXXXXXXXXX'. The tool natively reaches Bandwidth's logs and pulls exactly what operational state the message failed in, bypassing complex raw log exports.

**Does the system support sending localized multimedia messages (MMS) directly?**
Yes. Provide the agent with the from address, the to address, the text block, and a direct URL to a hosted JPEG/PNG image. The agent explicitly commands the send_mms tool injecting image packets into the phone line seamlessly.