# Bird MCP for AI Agents MCP

> Bird MCP lets your AI client manage all customer interactions—SMS, WhatsApp, Email, and voice calls—from one place. It handles contacts, message threads, and call history across every major communication channel so you never lose context about a customer's journey.

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

## Description

This connector gives your agent the ability to handle complex, multi-channel communications naturally. Instead of jumping between separate systems for WhatsApp messages, email replies, or physical call logs, your AI client sees everything in one place. You can automatically create and update customer records using `create_contact` or `update_contact`, ensuring every interaction is logged correctly. Need to send a quick follow-up? Your agent uses `send_message` to deliver the alert via SMS or WhatsApp instantly. When you connect this MCP through Vinkius, your AI client can also pull complete conversation transcripts using `list_messages` and review past calls by listing call history. This means support teams can audit a customer's entire communication lifecycle—from initial chat message to final voice call—without ever leaving their primary workflow.

## Tools

### create_contact
Establishes a completely new profile for a customer within the system using specified identifiers.

### get_call
Retrieves all specific details about one single voice call that took place in the workspace.

### get_contact
Pulls up a detailed record for an existing customer, showing their profile data and identifiers.

### get_conversation
Fetches the metadata and current status of any single conversation thread you name.

### list_calls
Generates a summary list of all voice calls, both incoming and outgoing, in the workspace.

### list_contacts
Provides a comprehensive roster of every customer profile currently stored in the system.

### list_conversations
Retrieves a list of all open or archived communication threads available for review.

### list_messages
Gets every individual message sent within a specific, named conversation thread.

### send_message
Sends an immediate new text-based alert to a recipient using a specified communication channel like SMS or WhatsApp.

### update_contact
Modifies the metadata or contact identifiers of a customer profile that already exists in the system.

## Prompt Examples

**Prompt:** 
```
Show me all messages and calls related to order #12345.
```

**Response:** 
```
**Order 12345 Summary**

*   **WhatsApp Thread (Last day):** Discussed shipping delay. Confirmed new tracking ID: ABC-987.
*   **SMS History (Yesterday):** Sent automated reminder about payment due.
*   **Voice Call Log:** Missed call attempted yesterday at 3 PM. Status: Unanswered.

Please follow up via email and confirm the tracking number.
```

**Prompt:** 
```
What are the latest details for Sarah Miller?
```

**Response:** 
```
**Sarah Miller Profile**

*   **Primary Phone:** +1 555-234-9012 (Updated 6/12)
*   **Email:** sarah.miller@corp.com
*   **Last Chat:** Via WhatsApp, discussing account upgrade options.
*   **Recent Activity:** Called in on 6/10; completed successfully.
```

**Prompt:** 
```
Send a follow-up message to the sales lead who spoke with me yesterday.
```

**Response:** 
```
**Action Taken:** Message sent successfully!

I used your primary WhatsApp channel to send the personalized follow-up regarding the enterprise package. The recipient, Mark Johnson, received the update at 10:35 AM ET.
```

## Capabilities

### Manage customer contact records
The agent can create new profiles or modify existing ones, keeping identifiers and metadata up-to-date.

### Send messages across channels
Your client sends instant alerts to a recipient using specific channels like SMS or WhatsApp.

### View all conversation histories
The agent fetches and lists ongoing or archived communication threads, regardless of the channel used.

### Review individual message details
You can pull specific messages from a thread to review exactly what was said at any point in time.

### Audit voice call logs
The agent lists and fetches detailed metadata for past phone calls made or received within the workspace.

## Use Cases

### A customer calls about an old order issue.
The agent pulls all past conversations using `list_messages` to see the initial email thread, then uses `get_call` to check if a follow-up phone call was recorded. It summarizes everything for the support agent so they can provide one accurate answer.

### A marketing team needs to re-engage cold leads.
The agent first uses `list_contacts` to verify which contacts are active. Then, it sends a personalized reminder message using `send_message` via WhatsApp, knowing the customer's preferred channel.

### A sales team needs to update client data after a meeting.
Instead of logging into three separate systems, the agent uses `get_contact` to review existing details and then runs `update_contact` to add new notes or correct identifiers instantly.

### Auditing compliance for call center staff.
The manager asks the agent to list all calls in a specific week using `list_calls`. The system returns a detailed breakdown of statuses (completed, missed) and allows deep dives into any single record with `get_call`.

## Benefits

- Stop context switching. Instead of jumping between WhatsApp, email, and CRM tabs, your agent gives you a single view of all communication threads using `list_conversations`.
- Maintain clean data records. When a lead changes their phone number or name, use `update_contact` to ensure every subsequent message sends to the right place.
- Instantly respond with full context. Before sending a reply, your agent can pull up all past messages using `list_messages`, so you never ask, 'What did we talk about last?'
- Better call quality assurance. Instead of manually checking logs, use `list_calls` to generate an immediate summary of recent voice activity for review.
- Never miss a lead. You can create new profiles or pull up existing ones with `get_contact`, guaranteeing that every touchpoint is logged correctly from the start.

## How It Works

The bottom line is that once connected, your AI client handles the API calls automatically, allowing you to manage communications through natural language commands.

1. Subscribe to this MCP on Vinkius.
2. Enter your unique Bird Access Key and Workspace ID credentials.
3. Connect your agent via Claude, Cursor, or any compatible client to start communicating.

## Frequently Asked Questions

**How can I use Bird MCP to centralize all my customer communications?**
It brings every interaction—SMS, WhatsApp, email, and voice calls—into one place. Your agent pulls together a full history, so you always know the complete story of a customer without switching tabs.

**Is Bird MCP good for tracking call logs?**
Yes. You can list all past voice calls and get detailed records for any specific call. This is great for quality assurance or troubleshooting communication gaps.

**Can I use this MCP to update customer contact details?**
Absolutely. If a client changes their phone number or company name, your agent can find the right record and update it instantly using dedicated tools, keeping your data accurate.

**Does Bird MCP help with sending messages?**
Yes. You can trigger instant, specific alerts to customers via their preferred channel (like WhatsApp or SMS) without needing to manually log into the messaging platform.

**What if I need to check conversations from different channels at once using Bird MCP?**
You simply ask your agent to list all conversations. It aggregates threads across multiple communication types, giving you a comprehensive view of active and archived chats in one place.