# Birdeye MCP MCP

> Birdeye MCP gives your AI agent full control over local business reputation management. It pulls customer reviews, tracks sentiment history, and manages surveys from across multiple platforms—all without you having to log into Google or Facebook individually. Need a comprehensive view of how customers feel about your brand? This connector centralizes everything, helping you gather feedback and build foot traffic by automating review requests and profile tracking.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Tags:** reputation-management, review-management, customer-experience, feedback-collection, local-seo, customer-satisfaction

## Description

Your AI agent can handle the entire customer experience workflow for your local business. Instead of logging into separate sites to collect reviews or send out surveys, your agent pulls all that data together in one conversation. You ask it to list recent 5-star reviews across Google and Facebook, and it delivers the high-fidelity comments instantly. The system can also identify specific customers who need a follow-up—it even knows if they've been a client before using `get_customer_details`. If you find a gap in data, your agent can trigger an automated review request via SMS or email. Because this MCP is hosted on Vinkius, you connect once and gain access to all the tools needed to coordinate reputation programs across every location.

## Tools

### create_customer
Adds a new, unique customer profile record into the system for tracking.

### customer_checkin
Triggers an automated review request to a specific customer's contact method.

### get_customer_details
Retrieves and summarizes the entire history and profile of a single named customer.

### list_business_locations
Generates a directory listing containing every branch or location tied to your business account.

### list_reviews
Pulls and organizes customer reviews collected from multiple platforms simultaneously.

### trigger_survey
Sends a custom-designed survey to a specific customer record for detailed feedback capture.

## Prompt Examples

**Prompt:** 
```
List the latest 5-star reviews for my business in Birdeye.
```

**Response:** 
```
I've retrieved your top reviews. You recently received 10 new 5-star ratings across Google and Facebook. Highlights include high praise for your 'Fast Response Time'. Would you like to see the detailed metadata for these?
```

**Prompt:** 
```
Send a review request to 'John Smith' (john@example.com).
```

**Response:** 
```
Customer check-in complete! I've successfully triggered a review request for John Smith. He will receive an automated notification shortly. Shall I monitor the status for any response?
```

**Prompt:** 
```
Show the sentiment profile for customer ID '12345'.
```

**Response:** 
```
Accessing customer intelligence... John Doe (ID: 12345) has a consistently 'Positive' sentiment profile across 3 reviews and 1 survey response. His latest NPS score was 10. Need more historical context from his high-fidelity profile?
```

## Capabilities

### List all business sites
Retrieves a complete directory of your organization’s branches and locations.

### Collect customer reviews
Gathers detailed comments and star ratings from various online review platforms in real time.

### Request new feedback
Sends automated check-in requests or custom surveys to recent visitors via email or text message.

### Track customer history
Accesses and summarizes a full profile of a specific customer, including their sentiment trend over time.

## Use Cases

### A new client needs to be tracked
The agent identifies a customer name and triggers `create_customer` first. Then, it uses `get_customer_details` immediately after to ensure all necessary contact fields were captured correctly for future use.

### Running a quarterly review audit
The manager asks the agent to list reviews across two specific locations using `list_business_locations` and then runs `list_reviews` on both sets of data. The results are compiled into a single, comparative report.

### Following up with recent visitors
Instead of email marketing, the coordinator uses `customer_checkin` to send a targeted review request to clients who visited last week. This keeps the feedback loop tight and fresh.

### Monitoring high-value accounts
The team needs to check if a VIP client is happy. They run `get_customer_details` to see their full history, then use `trigger_survey` to send a specific 'How was your experience?' form.

## Benefits

- Automate review collection: Use `customer_checkin` to send automated requests, ensuring you get fresh feedback right after a visit. This means less manual outreach and more data.
- Understand brand health instantly: Access detailed sentiment history for any customer using `get_customer_details`. You see if the profile is trending positive or negative without running multiple reports.
- Multi-site oversight: Don't check locations one by one. Use `list_business_locations` to pull a complete list of all your branches, letting you manage reputation across the whole organization at once.
- Deep feedback loops: Send targeted follow-up questions using `trigger_survey`. You can dispatch custom questionnaires only to specific clients and track their responses directly through your agent.
- Comprehensive review data: When you need a status report, running `list_reviews` pulls all ratings from Google, Facebook, etc., into one place. No more copy-pasting across tabs.

## How It Works

The bottom line is that you manage customer experience entirely through conversation, never having to log into individual review sites again.

1. First, subscribe to this MCP on Vinkius.
2. Next, retrieve your API Key and Business ID (bid) from your Birdeye dashboard settings.
3. Finally, use the agent in Claude, Cursor, or any compatible client by giving it a natural language command.

## Frequently Asked Questions

**How do I use list_reviews to see my best reviews?**
You ask your agent to run `list_reviews` and specify criteria, like 'show me all 5-star ratings from the last month.' It pulls and organizes the data across platforms automatically.

**Can I use trigger_survey for a whole group of clients?**
The tool is designed to send surveys to specific customers. You'll need to first identify those individuals using `get_customer_details` or `create_customer`, and then target them one by one.

**What if I open a new store? How do I manage it?**
Run `list_business_locations`. This tool gives you the complete directory, letting you easily pull performance data or initiate reputation campaigns for your brand-new branch.

**Does customer_checkin work only via email?**
No. The `customer_checkin` function supports multiple channels like SMS or Email. You just tell the agent which method you want to use when requesting a review.

**What credentials do I need to use the list_business_locations tool?**
You must provide your Birdeye API Key and Business ID (bid) for authentication. These are required parameters that establish which organization's locations you want to query.

**If I run get_customer_details for a customer who doesn't exist, what kind of error do I get?**
The tool returns a specific 'Customer Not Found' error code and an empty data object. Your agent can check the status code to handle missing records gracefully.

**Are there rate limits when running list_reviews across many locations, and how should I prepare for them?**
Yes, standard API request rate limits apply. To prevent failures, implement an exponential backoff strategy in your agent logic to pause between bulk calls.

**When using create_customer, what specific fields can I include when adding a new profile?**
You can populate the customer's name, email address, phone number, and any other standard contact details. The system validates these against available Birdeye data types.