# SignalWire MCP

> SignalWire MCP connects your AI agent directly to a full cloud communications stack, letting you manage SMS, voice calls, and usage data conversationally. Instead of logging into multiple technical portals, you can ask your agent to audit call logs, check message delivery status, list active phone numbers, or even send urgent alerts—all in natural language. It makes complex telecom management feel like a simple chat.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** cloud-communications, sms-notifications, voice-api, video-conferencing, telecom-infrastructure

## Description

This MCP lets your AI agent handle the messy parts of running communications for your business. Forget logging into complicated web dashboards just to find out if an alert message went through or how much you spent last month. By connecting SignalWire, your agent acts as a real-time telecom operator that answers questions about your communication platform instantly. You can ask it to retrieve detailed records for every call, check the status of specific messages, and even list all numbers associated with your project without ever touching a technical console. This capability transforms complex telecommunications management into simple conversation. If you're managing customer alerts or corporate voice lines, this MCP gives your agent the full control panel. You can use Vinkius to connect this power source to any compatible client, giving your entire team reliable communication data and cost oversight, right where they work.

## Tools

### get_account_info
Retrieves general account details for SignalWire.

### get_call
Gets specific, detailed information about a single recorded call.

### get_message
Fetches the full status and details for one specific text message.

### list_calls
Lists all recent voice calls that have occurred on your account.

### list_messages
Retrieves a list of the most recent SMS or MMS messages sent and received.

### list_phone_numbers
Lists all phone numbers that are currently associated with your SignalWire project.

### list_usage
Pulls detailed records showing how much you've used the communication platform for billing purposes.

### send_sms
Sends a new SMS message to a target phone number.

## Prompt Examples

**Prompt:** 
```
List all my SignalWire phone numbers.
```

**Response:** 
```
I've retrieved your phone numbers. You have 2 active numbers: '+1 234 567 890' and '+1 987 654 321'. Both are currently active and configured for voice and SMS.
```

**Prompt:** 
```
Send SMS 'Server alert: high usage detected' to +15550123.
```

**Response:** 
```
Message sent! I've successfully delivered your alert to +15550123 using your SignalWire number. The message SID is SMxxxx.
```

**Prompt:** 
```
Show me recent call logs for my project.
```

**Response:** 
```
I've found 5 recent calls. Notable interactions include an inbound call from '+1 111 2222' lasting 2 minutes. Would you like the full metadata for any specific call?
```

## Capabilities

### Send SMS alerts
Your agent sends immediate text messages to specified phone numbers.

### Track call history
The agent retrieves detailed metadata for recent voice calls, including who called and how long the conversation lasted.

### Review message logs
You can ask your agent to list all recent text messages or get full details on a specific message's delivery status.

### Monitor project numbers
The system lists and monitors every phone number tied to your SignalWire account for quick reference.

### Analyze usage costs
Your agent pulls detailed records of all communication activity, helping you track spending over time.

## Use Cases

### Checking on a failed customer notification
A Customer Success agent needs to confirm if a critical service update message was delivered. They ask their agent, 'Check the status of the alert sent yesterday.' The agent uses `list_messages` and then `get_message` to give them instant confirmation and details.

### Quarterly budget review
An Operations Manager needs to understand communication spend. They ask their agent, 'What was the usage last month?' The agent runs `list_usage`, providing comprehensive data so they can accurately plan for next quarter's budget.

### Investigating a call quality issue
A technical developer notices an unexpected call duration. They ask their agent to 'Show me the details of the call from 10 AM.' The agent uses `get_call` and provides all necessary metadata for the investigation.

### Mass rollout preparation
A team needs to know if they have enough numbers configured. They ask their agent, 'List all active phone lines for this project.' The agent runs `list_phone_numbers`, giving them an immediate overview of available resources.

## Benefits

- You can send urgent alerts instantly using the `send_sms` tool. Instead of manually opening a communication platform to type out an alert, you simply ask your agent to do it.
- Quickly assess resource consumption by calling `list_usage`. You get detailed records that help keep strict control over your overall communications costs without running manual reports.
- Never lose track of what happened on the phone. The agent uses `list_calls` to provide a history of recent voice calls, so you always know who called and when.
- Troubleshoot communication failures immediately. You can use `get_message` to pull up a specific message's full status, confirming if it was delivered or failed for any reason.
- Manage your entire setup from one place. Use `list_phone_numbers` to see all active numbers tied to the project without needing to navigate deep into technical settings.

## How It Works

The bottom line is you talk to your agent naturally; it handles all the complex API queries required by SignalWire.

1. Subscribe to this MCP and provide your SignalWire Project ID, API Token, and Space URL.
2. Connect the credentials through your preferred AI client (like Cursor or Claude).
3. Ask your agent a question like, 'What were my calls last week?' and it executes the necessary lookups.

## Frequently Asked Questions

**How do I check my SignalWire usage with the SignalWire MCP?**
You use the `list_usage` tool. This function pulls comprehensive records that allow you to track all communication activity and manage your associated costs.

**Can I send an SMS alert using the SignalWire MCP?**
Yes, you use the `send_sms` tool. Your agent can deliver immediate text messages to specified phone numbers directly through natural language instructions.

**What is the difference between listing calls and getting a specific call detail with SignalWire MCP?**
Running `list_calls` gives you a summarized list of recent conversations. To get full metadata, like detailed participants or timestamps for one interaction, use the `get_call` tool.

**Does this MCP help me find all my active phone numbers?**
Absolutely. The `list_phone_numbers` tool runs a quick audit and provides you with a complete list of every number associated with your project, keeping your inventory updated.

**Can I use the SignalWire MCP to check if an SMS message was delivered?**
Yes. You can run `list_messages` to see recent activity and then use `get_message` to retrieve detailed status information for any single text communication.