# SignalWire MCP for AI Agents AI Agent Connect

> SignalWire MCP. Manage your cloud communications by sending messages and auditing calls through your AI agent. It gives you a way to send SMS, track voice call history, monitor your phone numbers, and keep tabs on your account usage without leaving your current workspace. This is the direct way to handle your telecom infrastructure using natural language.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_BMx6FcoRBBHH2BeSrLdvYcEXGz6p8yOjelwFGwOc/ai-agent-connect
- **Tags:** cloud-communications, sms-notifications, voice-api, video-conferencing, telecom-infrastructure

## Description

Instead of jumping between different tabs to check if a text went through or looking for a specific call log in a messy dashboard, you can just ask your agent to do the heavy lifting. This Connector lets you handle your entire telecom stack as a conversation. You can check your active numbers, look at recent voice interactions, or push out a notification to a customer in seconds. It turns your communication stack into a tool you can actually talk to. You'll find that having this in your Vinkius catalog makes it much easier to keep your data organized while you focus on the actual work. It's about getting the right info at the right time without the friction of a technical console. You no longer have to worry about missing a high-priority alert or losing track of a customer's call history. Everything you need to manage your cloud communications is now accessible through your AI client. This means your team stays focused on solving problems instead of digging through logs. You can query your account status to see if your project is healthy, or check the specific details of a single message to see if it was delivered successfully. You can push out bulk alerts or check who called your office last night, and your agent handles the data retrieval for you.

## Tools

### get_account_info
Get SignalWire account details. This provides a quick look at your project's current status and configuration.

### get_call
Get details for a specific call. Pull specific metadata like duration and direction for a single interaction.

### get_message
Get details for a specific message. Check the status and history of a single SMS or MMS.

### list_calls
List recent voice calls. See a history of recent interactions to audit your team's communication.

### list_messages
List recent SMS/MMS messages. Browse through your recent outgoing and incoming text history.

### list_phone_numbers
List SignalWire phone numbers. See every number associated with your project in one simple list.

### list_usage
Get your current account usage records. This helps you keep a close eye on your communication costs in real time.

### send_sms
Send an SMS message to any number. Use this to push out alerts or notifications instantly from your agent.

## Prompt Examples

**Prompt:** 
```
Check my current spend.
```

**Response:** 
```
### Current Usage Summary

| Category | Usage | Cost | Status |
| :--- | :--- | :--- | :--- |
| **SMS** | 4,200 messages | $42.00 | ✅ Active |
| **Voice** | 1,150 mins | $115.00 | ✅ Active |
| **Video** | 200 mins | $20.00 | ✅ Active |

**Total Monthly Spend:** $177.00
*Note: You are currently 60% through your monthly budget.*
```

**Prompt:** 
```
Did the server alert send?
```

**Response:** 
```
✅ **Message Sent Successfully**

*   **Recipient:** +15550123
*   **Content:** 'Server alert: high usage detected'
*   **Status:** Delivered
*   **Message SID:** SMxxxx
*   **Timestamp:** 2026-07-10 14:49:11 UTC
```

**Prompt:** 
```
Who called me today?
```

**Response:** 
```
I found **3 recent calls** for your project today:

*   **Inbound:** +1 111 2222 (Duration: 02:15)
*   **Inbound:** +1 999 8888 (Duration: 00:45)
*   **Outbound:** +1 444 5555 (Duration: 05:30)

Would you like the full metadata for any of these calls?
```

## Capabilities

### Send SMS alerts
Send text messages to any phone number instantly through your agent.

### Audit voice calls
Review recent voice call history and metadata to see who contacted you.

### List phone numbers
See every active phone number associated with your communication project.

### Track account usage
Monitor your communication costs and usage records in real time.

### Check message status
Verify if your SMS or MMS messages were delivered successfully.

### Get account details
Retrieve your project's current status and configuration details.

## Use Cases

### High usage alerts
An ops manager asks the agent to check `list_usage` and send a warning via `send_sms` if the budget is hit.

### Missing call data
A support lead asks the agent to `list_calls` to see who reached out and `get_call` to see how long they stayed on the line.

### SMS delivery audit
A customer success rep asks the agent to `list_messages` to confirm a specific alert was successfully sent.

### New number setup
A developer asks the agent to `list_phone_numbers` to verify which numbers are active in the current project.

## Benefits

- Stop manual dashboard checking. Use `list_calls` and `list_messages` to see your communication history without opening a browser.
- Instant text alerts. Send notifications immediately using `send_sms` to keep your customers or team informed.
- Real-time cost tracking. Use `list_usage` to monitor your spend and prevent overages before they happen.
- Full number visibility. Manage your assets easily by using `list_phone_numbers` to see every active line.
- Deep interaction audits. Pull specific data with `get_call` and `get_message` to troubleshoot issues or verify deliveries.
- Simplified account management. Get a snapshot of your project health with `get_account_info` at any time.

## How It Works

The bottom line is you get a natural language command center for your entire telecom stack.

1. Get your Project ID, API Token, and Space URL from your dashboard.
2. Add these credentials to your Connector client connection.
3. Ask your agent to send a text, pull call logs, or check your numbers.

## Frequently Asked Questions

**Can I send texts to my customers with SignalWire?**
Yes, you can send SMS messages directly through your agent. It handles the delivery for you so you can push out alerts or notifications instantly.

**How do I see my call history?**
You can ask your agent to list all recent voice calls. It will pull the history of who contacted you, including durations and call directions.

**Can I track my communication costs?**
Yes, the Connector pulls usage records so you can monitor your spend in real time. You can ask for a summary of your costs at any time.

**Is this good for sending high-volume alerts?**
It is perfect for automated notifications and keeping your team informed. It handles the heavy lifting of sending and tracking those messages.

**How do I manage my phone numbers?**
You can list all numbers associated with your project to see what's active. This helps you keep track of your assets without a manual search.

**Can I check if a specific message was delivered?**
Yes, your agent can pull the details of a specific message to verify its status. This is great for troubleshooting why a customer might not have seen an alert.

**How do I find my SignalWire Project ID and Token?**
Log in to your [**SignalWire Dashboard**](https://signalwire.com/signin), select your Project, and navigate to **API** in the sidebar. You will find your Project ID and can generate a new API Token there.

**What is the Space URL?**
The Space URL is the prefix of your SignalWire domain (e.g., if your domain is `example.signalwire.com`, the Space is `example`). Enter only the prefix.

**Can the agent send SMS messages?**
Yes. Use the `send_sms` tool providing the recipient number, your SignalWire number, and the message body. Your agent will deliver the SMS and confirm the status instantly.