# Birdeye MCP

> Birdeye MCP manages your local business reputation using natural language conversations. This connector lets you centralize customer feedback, retrieve reviews from platforms like Google and Facebook, request check-ins via SMS or email, and track overall brand sentiment across multiple locations.

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

## Description

Connect your Birdeye account to any agent through Vinkius and take full control of your online reputation without jumping between tabs. Your AI client acts as a dedicated customer success coordinator, managing everything from feedback collection to profile analysis.

For instance, instead of manually logging into five different review sites, you simply ask your agent to list all recent reviews for a specific location. Need more data? You can programmatically dispatch custom surveys or trigger review requests using automated check-ins for recent visitors. The system also maintains a complete overview of customer profiles and sentiment history across every branch you own.

## Tools

### customer_checkin
Sends out a review request (Check-in) to prompt a customer for feedback.

### create_customer
Adds and creates a new contact profile into your system records.

### get_customer_details
Pulls up the full history and details for any specific customer profile.

### list_business_locations
Retrieves a complete list and directory of all your company's business locations.

### list_reviews
Gathers recent customer reviews, including ratings and comments, from various sources.

### trigger_survey
Sends a custom-designed survey to an identified customer for detailed feedback.

## 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 and track reviews
Retrieves detailed customer ratings, comments, and review summaries from various platforms.

### Request feedback via automated check-ins
Sends automatic review requests to customers using SMS or email shortly after their visit.

### Gather customer data and sentiment history
Accesses comprehensive customer profiles, providing a detailed overview of their past feedback and overall brand sentiment.

### Dispatch custom surveys to specific users
Sends targeted, customized surveys directly to individual customers for focused feedback.

### Manage multiple business locations
Retrieves a full directory of all your company's branches and physical addresses in one place.

## Use Cases

### Need to know how well the new location is doing?
The manager runs into fragmented data across three different sites. They ask their agent, 'List all reviews for the Downtown branch and compare it to the Mall branch.' The agent uses `list_business_locations` first, then executes `list_reviews`, giving a side-by-side comparison of recent sentiment.

### A customer profile is flagged with concern.
The customer service rep sees an alert for 'Jane Doe' and asks the agent to pull her file. The agent uses `get_customer_details`, revealing a history of negative comments, prompting the rep to immediately use `trigger_survey` to resolve the issue.

### Need to quickly generate post-visit feedback.
A sales team member wants to follow up with recent clients. They ask their agent to 'Send a check-in to John Smith.' The agent executes `customer_checkin`, automating the request and scheduling a follow-up reminder.

### Reviewing performance across all company sites.
The owner needs a quarterly report on brand health. They ask their agent to compile data for all locations. The agent uses `list_business_locations` and then runs multiple `list_reviews` calls, compiling the summary into one document.

## Benefits

- Stop logging into Google, Facebook, and Yelp separately. You can now use the `list_reviews` tool to pull together customer ratings and comments from multiple platforms with a single prompt.
- Collect fresh data without calling customers. Use `customer_checkin` to automatically send review requests via SMS or email right after a visit, ensuring you get timely feedback.
- Don't just react to poor reviews; predict issues. The system lets you analyze customer sentiment history and access full profiles using `get_customer_details` for deep insights.
- Targeted feedback is better than general requests. You can deploy specific questions by calling the `trigger_survey` tool, ensuring you gather actionable data points.
- Manage growth across multiple sites easily. Use `list_business_locations` to get a complete directory of all your branches and coordinate reputation efforts everywhere at once.

## How It Works

The bottom line is you tell your AI client what reputation task needs doing, and it executes the necessary steps directly within your workflow.

1. Subscribe to the Birdeye MCP on Vinkius.
2. Retrieve your API Key and Business ID (bid) from your Birdeye dashboard settings.
3. Connect this MCP to your preferred agent, then use natural language prompts to manage customer experience tasks.

## Frequently Asked Questions

**How do I use the Birdeye MCP to get reviews?**
You simply ask your agent to list customer reviews. This uses the `list_reviews` tool, which gathers ratings and comments from multiple online platforms into one place for you.

**Can I use the Birdeye MCP to send survey links?**
Yes. You can dispatch custom surveys using the `trigger_survey` tool. This allows you to gather highly specific feedback rather than relying on general review ratings.

**What if my company has many branches? Does Birdeye MCP handle that?**
Absolutely. The `list_business_locations` tool gives you a directory of all your sites, letting you manage reputation performance across every branch simultaneously.

**How do I prompt the Birdeye MCP to find out more about one customer?**
Use the `get_customer_details` tool. This retrieves a full profile for any customer, giving you their complete history of feedback and sentiment data.

**Is the Birdeye MCP only for Google reviews?**
No. The MCP is built to manage reviews from multiple platforms (Google, Facebook, etc.). It pulls aggregated data so you don't have to worry about platform silos.