# Bandwidth MCP for AI Agents MCP

> Bandwidth connects your cloud communications stack directly to any AI agent. You manage SMS and MMS campaigns, validate 10DLC profiles, check toll-free number compliance, and audit message histories—all through natural conversation. Forget building complex webhook architectures; simply ask your agent to run the telecom operations you need.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** cpaas, sms-api, mms-messaging, 10dlc, telecom-automation, carrier-grade

## Description

This connector lets your AI client take full control of high-volume communication workflows without requiring you to write custom code or build complicated webhooks. You can manage everything from initial messaging blasts, sending both standard SMS and rich media MMS payloads, to validating entire 10DLC campaigns for carrier approval. Need to know if a toll-free number is compliant? Ask your agent to ping the verification headers. The system also lets you audit all message histories or clear out old media files when you're done with them. Because this MCP sits within the Vinkius catalog, you get access to reliable telecom infrastructure management right alongside hundreds of other operational tools for your AI agents.

## Tools

### delete_media
Removes a stored media asset from your Bandwidth account.

### get_campaign
Retrieves detailed information for one specific 10DLC campaign.

### get_toll_free
Lists all the verification statuses of your toll-free numbers.

### get_health
Pings the Bandwidth API to check overall system health and status.

### list_applications
Retrieves a list of all your active messaging applications.

### list_campaigns
Lists all available 10DLC messaging campaigns you manage.

### list_media
Shows a list of media files currently stored in your Bandwidth account.

### list_messages
Generates a log showing all sent and received messages.

### send_mms
Sends an MMS message that includes attached rich media content.

### send_sms
Sends a standard SMS text message via the Bandwidth API.

## Prompt Examples

**Prompt:** 
```
We had a major service interruption. Send an urgent SMS update to our entire user base telling them we're back online.
```

**Response:** 
```
**Outage Alert Sent**

The system successfully dispatched the emergency payload to 4,521 recipients across three regions. The outbound carrier queue confirmed receipt of the message by Bandwidth and scheduled delivery through the primary application ID.

*Confirmation:* All high-priority alerts are processed immediately.
```

**Prompt:** 
```
List all my uploaded media files and delete any promotional image named 'Q1-sale.jpg'.
```

**Response:** 
```
✅ **Media Audit Complete**

I found 23 media blocks in your storage instance. I located and deleted the asset `Q1-sale.jpg`, freeing up its allocated quota immediately. The remaining files are listed below:

*   `logo_v2.png` (Uploaded: 2024-01-15)
*   `manual_guide.pdf` (Uploaded: 2023-11-01)
```

**Prompt:** 
```
Check the overall status of our toll-free number +1-800-CALL-NOW.
```

**Response:** 
```
**Toll-Free Verification Report**

The check returned a 'Compliant' status. The upstream approval headers are active and match current carrier requirements for US service. You can send high-volume traffic using this line without risk of rejection.
```

## Capabilities

### Send bulk SMS and MMS messages
Dispatch text alerts or rich media messages instantly to specific phone numbers.

### Manage 10DLC campaign compliance
Check the health of your messaging campaigns and validate required profiling data for carrier approval.

### Verify toll-free number status
Run checks on upstream headers to ensure your dedicated toll-free numbers are compliant before sending messages.

### Audit messaging activity and media storage
Review message logs, check API health, or delete stored media payloads from the system.

## Use Cases

### Mass Outage Notification
During an unexpected system outage, the support engineer simply asks their agent to send a priority alert. The agent uses `send_sms` to dispatch the blast message instantly across all registered users.

### Marketing Compliance Checkup
Before running a major holiday promotion, the marketing manager prompts the agent to check campaign health using `list_campaigns`, ensuring 10DLC rules are approved and ready for scale.

### Media Storage Cleanup
A team needs to free up old assets. They tell their agent to list all stored media files using `list_media` and then use `delete_media` on any files older than six months.

### Pre-deployment Network Check
A DevOps team needs assurance that the communication channels are clear. They ask the agent to ping the API health using `get_health`, confirming structural readiness before scaling services.

## Benefits

- Avoid building custom webhook architectures. Your agent handles the underlying CPaaS complexity, letting you focus on messaging strategy.
- Instantly send blast SMS/MMS payloads with rich media attachments while explicitly bypassing legacy SIP pipelines.
- Validate 10DLC TCR profiling and approve messaging rules using `get_campaign` to prevent carrier-side filtering blocks.
- Run compliance checks by calling `get_toll_free` to dynamically ping upstream toll-free approval headers.
- Audit message history with `list_messages`, ensuring you always have a clear record of delivery footprints and communication logs.

## How It Works

The bottom line is that your AI client handles complex telecom requirements, allowing you to manage messaging operations through simple conversation.

1. Connect your Bandwidth credentials (Account ID, Username, Password) to this MCP within your preferred AI client.
2. Tell your agent what you need—for example, 'Send an outage alert SMS to all users' or 'List the last 50 messages sent.'
3. The agent executes the necessary communication operation, and you receive a plain-language confirmation of the successful dispatch or data retrieval.

## Frequently Asked Questions

**How do I use the Bandwidth MCP to send a bulk SMS alert?**
You simply ask your agent to dispatch an SMS, providing the target numbers and message body. The system handles the complex messaging payload and ensures it gets into the carrier queue immediately.

**Should I use Bandwidth MCP for marketing campaigns that require compliance checks?**
Yes. Before launching any campaign, you can ask your agent to validate the 10DLC profiles. This proactive check confirms your messaging rules are approved and ready to avoid carrier filtering.

**Can I use Bandwidth MCP to manage media files?**
You can list all uploaded media using `list_media` and then delete specific assets like old images or guides. This keeps your storage clean and helps you track usage effectively.

**Is the Bandwidth MCP good for checking if my toll-free number is active?**
It is excellent for that. The agent can ping upstream headers to dynamically check compliance, giving you confidence that your dedicated line will work reliably for messaging.

**Does the Bandwidth MCP help me audit past messages?**
Yes. You can request a list of sent or received messages using `list_messages`. This gives you a full, auditable log of every interaction that went through your account.