# Bird MCP for AI Agents MCP

> Bird (MessageBird) MCP lets you manage global, omnichannel communication directly from your AI client. Send high-volume SMS messages, WhatsApp chats, and Telegram alerts, all while tracking real-time delivery status and managing customer contacts in one place.

## Overview
- **Category:** talk-to-me
- **Price:** Free
- **Tags:** omnichannel-messaging, whatsapp-api, sms-gateway, voice-api, email-api, customer-engagement

## Description

Managing modern customer communications means dealing with dozens of channels: email, SMS, WhatsApp, chat apps. Trying to keep track of message history, contact records, and billing across those silos is a nightmare. This MCP connects your global communication infrastructure to natural conversation. You talk to your AI client—say, 'Send a reminder about the appointment to Jane Doe'—and it handles all the complexity: selecting WhatsApp for that contact, formatting the message correctly, sending it, and logging the attempt.

It doesn't just send messages; it manages the whole lifecycle. Need to know if a message bounced? It retrieves detailed carrier delivery receipts. Have a new user join? You can build or update their profile right from your agent. Everything is controlled via conversation, making manual dashboard exports obsolete. By connecting this MCP through the Vinkius catalog, you get full visibility into messaging and CRM contacts without ever leaving your primary workflow.

## Tools

### create_contact
Adds a new record to your central CRM contact list.

### delete_contact
Permanently removes an existing customer or contact profile from the directory.

### get_balance
Checks and reports your current communication account spending limit and balance.

### get_contact_details
Retrieves a full profile, including custom attributes, for a specific contact.

### get_message_details
Fetches detailed status information for one particular SMS message.

### list_contacts
Retrieves an exhaustive list of all contacts stored in your communication directory.

### list_conversations
Lists currently active chat threads across multiple messaging platforms.

### list_messages
Retrieves a history of all messages previously sent via SMS.

### send_sms
Sends a high-priority text message to any specified E.164 phone number.

### send_omnichannel_message
Dispatches a message via WhatsApp or Telegram, depending on the recipient's preferred channel.

## Prompt Examples

**Prompt:** 
```
I need to send a reminder about the payroll meeting to Jane Doe. She prefers WhatsApp.
```

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

*   **Recipient:** jane.doe@example.com (WhatsApp)
*   **Content:** Reminder: Payroll meeting moved to 10 AM tomorrow.
*   **Status:** Delivered (2024-07-15, 9:32 AM UTC)

I've logged this and scheduled a follow-up check in an hour to ensure delivery confirmation.
```

**Prompt:** 
```
What did I send to the Smith account last week? And what is our current balance?
```

**Response:** 
```
**Account Status:**
*   Current Balance: $350.20 USD
*   Last 7 Days Usage: $145.80

**Recent Messages (Smith Account):**
| Date | Channel | To | Status |
| :--- | :--- | :--- | :--- |
| 07/13 | SMS | +123... | Delivered |
| 07/15 | WhatsApp | +123... | Buffered (Pending) |

The buffered message is likely waiting for a manual reply to complete the thread.
```

**Prompt:** 
```
Can you find all my contacts in the marketing department and delete the ones that haven't communicated in 6 months?
```

**Response:** 
```
**Contact Cleanup Report**

I analyzed your directory. Here are the actions taken:

✅ **Deleted:** 12 inactive records.

*   `john.smith@corp.com` (Last contact: 01/20)
*   `jane.doe@corp.com` (Last contact: 03/05)
*   ... (and 10 others)

The directory is now cleaner, and we've saved potential billing clutter.
```

## Capabilities

### Dispatching Multi-Channel Messages
Send messages across SMS, WhatsApp, and Telegram using a single conversational interface.

### Managing Customer Profiles
Create, read, update, or delete CRM contacts, ensuring your communication directory is always current.

### Auditing Message History
List past SMS messages and active chat groups to understand full customer engagement reach.

### Tracking Financial Status
Get real-time account balance checks to prevent unexpected communication halts or billing issues.

### Investigating Delivery Failures
Retrieve detailed message metadata and receipts, pinpointing why a carrier rejected a transmission.

## Use Cases

### A Support Agent Needs to Check Customer History
The customer calls in asking about an old order. Instead of manually searching the CRM, the agent asks the AI client to first `list_contacts` and then use `get_contact_details` on that user's profile. This immediately surfaces all custom attributes and relevant metadata for fast service.

### A Marketing Team Needs a Bulk Alert
The team needs to notify 50 users about a system outage. The agent uses the `send_omnichannel_message` tool, automatically routing the alert via WhatsApp for those contacts who prefer it, and logging the full broadcast history.

### A Developer Needs to Test Messaging Flows
Before launching a new feature, the developer asks the agent to run a test flow. It uses `send_sms` to dispatch a sample message, then uses `get_message_details` to confirm the carrier delivery receipt status across different geographies.

### A Sales Team Needs to Clean Up Leads
The sales rep has outdated contact information. They ask the agent to use `list_contacts`, identify stale entries, and then call `delete_contact` on those records, keeping the communication directory clean.

## Benefits

- Instead of checking multiple dashboards, you can use the `list_conversations` tool to enumerate all active chat groups across different messaging apps efficiently. Your agent handles the cross-platform view.
- You never have to worry about running out of funds unexpectedly. The `get_balance` tool gives you real-time financial visibility, preventing automated communication halts before they happen.
- Need to send a broadcast? You can dispatch high-priority SMS messages globally using the `send_sms` tool while specifying alphanumeric originators and secure E.164 recipient formats.
- When a message fails or gets rejected by a carrier, you don't guess what went wrong. The agent retrieves detailed metadata using `get_message_details`, allowing you to investigate rejections natively.
- Forget manual contact lists. You can use the agent to manage your entire communication directory by calling `create_contact` or `delete_contact` as part of a natural conversation.

## How It Works

The bottom line is that you manage high-volume, multi-channel communications and contact data entirely through conversation.

1. Subscribe to this MCP on Vinkius and enter your Bird (MessageBird) Access Key.
2. Connect the credentials to any compatible AI client, giving it permission to access global communication tools.
3. Instruct your agent using natural language: 'Send a WhatsApp message to John Doe' or 'What is my current balance?'

## Frequently Asked Questions

**How does the Bird MCP help me send messages across WhatsApp, SMS, and Telegram?**
It acts as a single control panel. You just tell your agent to send the message, and it handles which channel is best for that recipient—whether they prefer text or chat app communication.

**I need to track if my SMS messages actually got delivered. How does Bird help?**
The MCP provides real-time delivery audits. It retrieves detailed receipts, letting you know instantly if a message was delivered, rejected by the carrier, or is still pending.

**Can I use this MCP to keep my customer contact list updated?**
Yes. You can manage your communication directory directly through conversational commands. This includes creating new profiles using `create_contact` and updating existing ones with custom attributes.

**What if I need a bulk alert sent out to thousands of people?**
It handles high-volume dispatching reliably. You can send mass SMS messages while specifying the correct alphanumeric originators, which is crucial for large campaigns.

**Is this MCP only good for sending messages, or does it help with billing too?**
It helps with both. Beyond dispatching, you can query your account status to get a real-time balance check. This prevents unexpected communication halts and keeps your operations running smoothly.

**I don't know which contact ID I need; how do I start?**
You simply ask the agent to list all contacts. It retrieves a full directory of existing users, letting you review who needs attention before sending anything out.