# Bandwidth MCP for AI Agents MCP

> Bandwidth lets your AI client manage complex, enterprise-grade communications—from sending SMS alerts to auditing global voice calls. Your agent instantly lists all phone numbers in service, tracks message delivery status, and pulls detailed call logs without you ever touching a technical dashboard.

## Overview
- **Category:** talk-to-me
- **Price:** Free
- **Tags:** cloud-communications, telecom, sms-api, call-logs, messaging-infrastructure

## Description

Need to handle cloud communications but hate the dashboards? This MCP gives your AI client direct access to Bandwidth's entire communication infrastructure. Instead of clicking through multiple tabs just to audit a single call or check if an SMS went through, you talk to your agent. It acts like a real-time telecom operator for your workflow.

Whether you run secure alert systems or manage global voice lines, your agent can pull everything together. You'll instantly see all active phone numbers and get detailed reports on message history. Need to know what happened with that call last week? Your agent pulls the full call log right up front. This puts complex telecom management into a natural conversation flow. Connect this MCP through Vinkius, and you give your AI client immediate oversight of every part of your messaging and voice service.

## Tools

### get_account_info
Retrieves general operational details about the Bandwidth account.

### get_call_state
Fetches detailed status and metadata for a specific, individual voice call event.

### list_applications
Provides an inventory list of all configured communication applications within the account.

### list_calls
Lists recent outbound and incoming voice calls, providing a summary log.

### list_conferences
Shows details of currently active conference calls and all connected participants.

### list_messages
Retrieves a list of recent SMS communications, including status reports.

### list_phone_numbers
Provides an inventory and monitoring list of all phone numbers registered to the account.

### make_call
Initiates a new, outbound voice call to a specified number.

### send_sms
Sends a single SMS message to a targeted phone number.

## Prompt Examples

**Prompt:** 
```
Show me the status of our main number, plus any recent calls made to it.
```

**Response:** 
```
**Account Summary: Main Line Status**

*   **Primary Number:** +1 555-123-4567 (Active)
*   **Status:** Operational for Voice & SMS

**Recent Activity Log**

| Time/Date | Direction | Destination | Status | Details |
| :---: | :---: | :---: | :---: | :---: |
| 2024-06-12 9:15 AM | Outbound | +1 800-CALLS | Success | Call duration: 3 min.|
| 2024-06-12 1:01 PM | Inbound | N/A | Failure | Reason: Busy signal received. |

Need me to send an update SMS right now?
```

**Prompt:** 
```
What are all the phone numbers we have configured, and what applications do I need to review?
```

**Response:** 
```
**📞 Number Inventory Report**

You currently manage 5 active lines:
*   +1 555-123-4567 (Primary)
*   +1 555-987-6543 (Secondary)
*   ...and three others.

**⚙️ Application Checklist**

I found these key applications configured. You might want to review the 'Alerting' app and the 'Outgoing' flow:
*   `alert_system_v2`: Used for critical SMS alerts.
*   `outbound_dialer`: Manages all voice calls.
*   `marketing_sms`: Handles bulk messaging.
```

**Prompt:** 
```
Check if there are any active conference calls running right now.
```

**Response:** 
```
**✅ Active Conference Status**

I scanned the system and found **1 active conference call**. 

*   **Conference ID:** CONF-9023K
*   **Participants Online:** 4 people.
*   **Last Activity:** Participant 'J. Doe' spoke at 10:35 AM.

If you need the list of participant IDs, just let me know.
```

## Capabilities

### Manage account details
Retrieve core information about the Bandwidth account to verify credentials and general usage parameters.

### Audit message delivery and history
Check recent SMS activity, view detailed message statuses, and retrieve full communication records.

### Monitor phone line inventory
List all currently active phone numbers in service across the entire account for number oversight.

### Manage voice calls and conferences
Start outbound voice calls, monitor active conference sessions, and retrieve detailed state information on specific call attempts.

### List communication assets
Get inventories of configured applications or list recent activity like calls and messages for quick auditing.

## Use Cases

### Auditing a failed deployment
A developer needs to know why an alert system failed. Instead of checking logs across five different tools, they ask the agent. The agent uses `list_calls` and `get_call_state` to pinpoint whether the issue was line provisioning or the outbound call attempt itself.

### Handling a service outage report
An Ops Manager needs to know which lines are affected. They prompt the agent, which uses `list_phone_numbers` and cross-references it with `get_account_info` to provide a single, comprehensive status report across all services.

### Running pre-deployment checks
Before launching a new messaging feature, a developer uses the agent to run checks. It executes `list_applications` and reviews the configured logic to ensure no unintended communication gaps exist in the platform setup.

### Checking participant attendance for a meeting
A customer success representative needs to confirm who is on a critical call. They ask the agent, which then uses `list_conferences` to provide an immediate headcount and list of participants without requiring manual admin access.

## Benefits

- You can instantly send SMS alerts or initiate calls using the `send_sms` and `make_call` tools, automating crucial customer outreach without manual API calls.
- Stop losing time checking dashboards. Your agent pulls full communication history by listing messages (`list_messages`) and recent call logs (`list_calls`), giving you immediate answers.
- The MCP allows deep auditing of your setup using `list_applications` and `get_account_info`, ensuring that your communications logic is always correctly applied.
- You gain real-time operational control by monitoring active conferences via the `list_conferences` tool, knowing exactly who is connected at any moment.
- Quickly verify which lines are live. The ability to list phone numbers (`list_phone_numbers`) gives Ops Managers immediate oversight of their entire telecom asset.

## How It Works

The bottom line is that you connect your existing cloud communications platform using simple tokens, letting your AI agent do the heavy lifting of querying all your telecom data.

1. Subscribe to this MCP in Vinkius.
2. Enter your Bandwidth Account ID, Username, and API Token into your client configuration.
3. Your AI agent uses the credentials to access communication data through any compatible client.

## Frequently Asked Questions

**How can I use Bandwidth MCP to audit my call logs?**
You can ask your agent to list recent voice calls and check their detailed status. It pulls metadata like duration, failure reasons, and who called whom into one single report.

**Can Bandwidth MCP help me manage my phone numbers?**
Yes. The MCP lets you instantly see all the phone lines active on your account, making it easy to track inventory without logging into a separate number management dashboard.

**What if I need to send an urgent SMS alert? Does Bandwidth MCP handle that?**
Absolutely. You simply tell your agent the message and the destination number, and it sends the SMS immediately, providing confirmation of delivery status right away.

**Is Bandwidth MCP useful for troubleshooting communication failures?**
It's perfect for that. If a call fails or an alert doesn't go out, you can ask the agent to retrieve the specific call state details, which pinpoints the exact cause of the failure.

**Do I need to manually check every application setup using Bandwidth MCP?**
No. You just tell your agent what you're checking, and it runs a comprehensive list of all configured applications for you, saving hours of manual navigation.