# MessageBird MCP for AI Agents AI Agent Connect

> MessageBird MCP. Manage global SMS, audit contacts, and track account balances using your AI client. It handles the heavy lifting of omnichannel communication so you don't have to jump between dashboards to send messages or check delivery statuses.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_riFo22vBZQ6cPHnsXiK4Y9UTBOCmgEkxarYuNZX1/ai-agent-connect
- **Tags:** omnichannel, sms-gateway, contact-management, messaging-api, customer-engagement, real-time-sync

## Description

This Connector lets you manage your global communication strategy without leaving your workspace. You can tell your agent to send out messages, check your current spending, or audit your contact lists. It handles the details of omnichannel messaging, from verifying phone numbers to pulling group metadata. Instead of logging into a separate dashboard to check delivery statuses or balance levels, you just ask. It's a key part of the Vinkius catalog that puts your MessageBird data right where you work.

## Tools

### get_contact
Get the specific details for a single contact. Use this to pull metadata for a specific recipient.

### list_hlr
View HLR (Network Lookup) requests to see if numbers are active. This helps you avoid sending messages to disconnected lines.

### list_messages
See a list of your most recent SMS messages. Use this to quickly review recent outbound activity.

### get_group
Pull specific details for a contact group. This is useful for checking the size and metadata of a specific list.

### get_message
Fetch the details of a specific message. Use this to see the exact status and timestamp of a single delivery.

### list_channels
See all your configured communication channels. Check which pathways are currently active for your strategy.

### list_contacts
Get a list of all your MessageBird contacts. Use this to audit your current database of recipients.

### list_groups
View all your contact groups. This allows your agent to find specific audiences for targeted messaging.

### send_sms
Send an SMS message to a recipient. This is the primary tool for executing your global messaging strategy.

### get_balance
Check your current account balance immediately. This keeps you in control of your spending in real time.

## Prompt Examples

**Prompt:** 
```
Check my MessageBird account balance.
```

**Response:** 
```
I've checked your account. Here is your current status:

| Metric | Value |
| :--- | :--- |
| **Current Balance** | $50.00 |
| **Payment Type** | PREPAID |

Your balance is sufficient for your upcoming scheduled messages.
```

**Prompt:** 
```
List the last 5 SMS messages sent from my account.
```

**Response:** 
```
I've retrieved your most recent outgoing messages:

* **ID:** xxxx123 | **Recipient:** +123456789 | **Status:** Delivered
* **ID:** xxxx456 | **Recipient:** +198765432 | **Status:** Sent
* **ID:** xxxx789 | **Recipient:** +15550123 | **Status:** Delivered
* **ID:** xxxx012 | **Recipient:** +14445566 | **Status:** Pending
* **ID:** xxxx013 | **Recipient:** +13332211 | **Status:** Delivered
```

**Prompt:** 
```
Send SMS 'Your discount code is VINKIUS20' to +15550123.
```

**Response:** 
```
Done! I've sent that message for you.

* **Recipient:** +15550123
* **Content:** Your discount code is VINKIUS20
* **Originator:** Vinkius
* **Message ID:** xxxxxxxx

I'll let you know if the delivery status changes.
```

## Capabilities

### Send SMS messages to global recipients
Your agent can dispatch text messages to numbers worldwide instantly.

### Check real-time account balances
See exactly how much credit you have left in your messaging account.

### Audit contact metadata and groups
Pull detailed information about your existing contact lists and categories.

### Verify phone number validity via HLR
Check if a specific mobile number is active and reachable before sending.

### Track SMS delivery history
Review the status of recent messages to ensure they reached their destination.

## Use Cases

### Sending a discount code
A marketing lead asks their agent to send a 20% off code to a specific list of customers using `send_sms`.

### Pre-campaign spend check
An ops manager asks the agent to check the current credit remaining using `get_balance` before launching a large blast.

### Auditing contact groups
A support lead wants to see if the 'VIP' group has been updated and asks the agent to pull details with `list_groups`.

### Verifying specific contact data
A business owner needs to see the specific details for a high-value lead and asks the agent to pull it using `get_contact`.

## Benefits

- Stop jumping between tabs by using `get_balance` to monitor your spending directly in your chat.
- Verify your audience readiness by using `list_groups` to check metadata before starting a campaign.
- Reduce failed delivery rates by using `list_hlr` to confirm numbers are active before you send.
- Keep your contact database organized by using `list_contacts` to audit your current recipient lists.
- Track your outreach success by using `list_messages` to see real-time delivery statuses.
- Speed up customer responses by using `get_message` to pull specific details for a single interaction.

## How It Works

The bottom line is it gives your agent direct access to your global messaging infrastructure.

1. Subscribe to the MessageBird MCP on Vinkius
2. Enter your MessageBird API Key in the settings
3. Ask your agent to send messages or check your balance

## Frequently Asked Questions

**Can I send SMS messages to multiple countries with MessageBird MCP?**
Yes. This Connector gives your agent the ability to send SMS messages to recipients globally, making it ideal for international marketing or alerts.

**How do I check my MessageBird balance using the Connector?**
You can simply ask your agent to check your balance. It will pull your real-time account information so you can monitor your spend without leaving your chat.

**Can the MessageBird MCP verify if a phone number is active?**
Yes. It uses HLR (Home Location Register) requests to check if a number is active and reachable, helping you avoid sending messages to dead lines.

**Can my agent see my contact groups?**
Yes. The Connector allows your agent to list and retrieve metadata for all your contact groups, making it easy to manage your audience segments.

**Will MessageBird MCP help me track message delivery?**
Absolutely. Your agent can pull the history of your sent messages to show you exactly which ones were delivered, sent, or are still pending.

**Is MessageBird MCP good for marketing blasts?**
It is well-suited for this. You can use it to verify your contact lists, check your balance, and send out your messages directly through your AI client.

**How do I find my MessageBird API Key?**
Log in to your [**MessageBird Dashboard**](https://dashboard.messagebird.com/), navigate to **Developers** > **API Access**, and you will find your Access Key there. Copy and paste it into the field below.

**Can the agent check my current credit balance?**
Yes. Use the `get_balance` tool. Your agent will retrieve your current account balance and payment type (prepaid/postpaid) instantly.

**Is it possible to send SMS to multiple recipients at once?**
Yes. The `send_sms` tool accepts a comma-separated list of recipient numbers. Your agent will deliver the message to all recipients and provide the overall delivery status.