# Birdeye MCP for AI Agents MCP

> Birdeye MCP connects your AI agent to reputation management tools. It lets you pull customer reviews, track surveys, manage contact details, and trigger automated check-ins—all without leaving your current workflow.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Tags:** reputation-management, review-management, customer-experience, surveys, feedback-loop, local-marketing

## Description

Managing a brand's reputation used to mean jumping between five different tabs: the review dashboard, the CRM, the survey tool, and the location manager. Now, you can handle it all through natural conversation.

This MCP lets your AI client treat customer experience like just another data point. Instead of manually copying review summaries or checking a contact's history, your agent handles these routine tasks on demand. You can ask it to find out what customers are saying about specific locations, pull detailed profile information for key contacts, or even initiate the process of sending an automated survey request after a customer check-in.

When you connect Birdeye through Vinkius, your AI agent gets access to all this data, allowing it to orchestrate complex reputation workflows. It’s about getting answers and taking actions—like drafting a reply to a negative review or pulling the latest location list—right inside your existing tools.

## Tools

### checkin_customer
Triggers an automated request to send a survey or review to a specific customer.

### get_business_info
Retrieves core, foundational information about the business profile.

### get_contact
Fetches detailed profile data for a single customer contact using their details.

### get_review_summary
Gathers a summary count of reviews, categorized by the source they came from (e.g., Google, Facebook).

### get_survey_responses
Retrieves all customer answers for a specific survey ID for analysis.

### list_contacts
Provides a comprehensive list of all managed customer contacts and their basic details.

### list_locations
Pulls a complete directory listing of every business location managed in the account.

### list_reviews
Retrieves a list of recent customer reviews, including source and rating details.

### list_surveys
Lists all the available surveys that can be deployed to customers.

### reply_to_review
Allows you to draft and post a specific reply to an existing customer review.

## Prompt Examples

**Prompt:** 
```
What are the recent reviews for our Seattle location?
```

**Response:** 
```
**Seattle Location Reviews (Last 30 Days)**

*   ⭐️⭐️⭐️⭐️⭐️ (Google): 'Amazing staff! Will be back.'
*   ⭐️⭐️⭐️⭐ (Yelp): 'Great atmosphere, but slow service.'
*   ⭐️⭐️⭐️⭐️ (Facebook): 'Food was excellent.'

We have 12 new reviews. Would you like me to draft a reply to the Yelp comment?
```

**Prompt:** 
```
Check in Jane Smith and pull her details.
```

**Response:** 
```
**Customer Check-in Successful**

*   **Name:** Jane Smith
*   **Email:** jane.smith@example.com
*   **Status:** Checked In (Triggered)

Birdeye has initiated the automated survey request for her. I also pulled her contact record; she was last active 3 weeks ago.
```

**Prompt:** 
```
Show me responses for our 'Q2 Satisfaction' survey.
```

**Response:** 
```
Retrieving results for Survey ID: Q2_SATISFACTION...

*   **Total Responses:** 45
*   **Key Positive Themes:** 'Excellent service,' 'Fast delivery.'
*   **Areas for Improvement:** Customers frequently mentioned needing more clarity on the return policy.

I can summarize all feedback, or I can filter these responses by location.
```

## Capabilities

### List Reviews
Retrieves a list of customer reviews, including source and rating details.

### Reply to Review
Allows you to draft and post a specific reply to an existing customer review.

### Check-in Customer
Triggers an automated request to send a survey or review to a specific customer.

### List Surveys
Lists all the available surveys that can be deployed to customers.

### Get Survey Responses
Retrieves all customer answers for a specific survey ID for analysis.

### List Contacts
Provides a comprehensive list of all managed customer contacts and their basic details.

### Get Contact
Fetches detailed profile data for a single customer contact using their details.

## Use Cases

### Responding to Negative Public Feedback
A customer service agent notices a 1-star review on Yelp. They prompt their AI client: 'Find that review and draft a sympathetic reply acknowledging the issue.' The agent uses `list_reviews` to find it, then executes `reply_to_review`, posting a professional response instantly.

### Tracking Customer Loyalty Post-Visit
A store manager wants to follow up with a client who just visited. They prompt: 'Check in John Doe.' The agent uses `checkin_customer` and Birdeye sends the automated request for a survey, improving response rates.

### Generating Quarterly Market Reports
A marketing lead needs to report on market sentiment. They prompt: 'What is the overall review health across all major sources?' The agent executes `get_review_summary`, providing a quantitative overview for the presentation.

### Handling Survey Data Inquiries
A CX team member needs to check feedback from last month's campaign. They prompt: 'Show responses for survey ID XYZ.' The agent uses `get_survey_responses` and summarizes the key themes mentioned by customers.

## Benefits

- Automate follow-ups: Instead of manual outreach, use the `checkin_customer` tool to automatically trigger review or survey requests when a customer interacts with your business.
- Instant sentiment analysis: Quickly get a summary count using `get_review_summary`, giving you an immediate grasp of brand perception across all sources.
- Centralized contact data: Use `list_contacts` and `get_contact` to pull specific, detailed profile information without accessing the CRM directly.
- Direct conversation replies: The `reply_to_review` tool lets your agent draft and post thoughtful responses straight from a chat prompt, keeping engagement high.
- Operational oversight: You can list all business locations using `list_locations`, giving context to regional marketing efforts or reporting requirements.

## How It Works

The bottom line is you connect once from your preferred AI client, and it instantly gains access to all of your Birdeye data and actions.

1. Subscribe to this MCP on Vinkius.
2. Enter your Birdeye API Key and Business ID credentials.
3. Use the connector in any compatible AI client, letting your agent handle tasks like listing reviews or checking contacts.

## Frequently Asked Questions

**How does Birdeye MCP help me manage reviews without logging into the dashboard?**
You don't have to. Your AI client handles it all. You can ask it to list recent customer reviews or summarize feedback by source, getting you real-time data directly in your chat window for quick action.

**Can I use Birdeye MCP to track survey responses and contacts?**
Yes. Beyond just reviews, this MCP lets you list all available surveys and retrieve specific customer answers using `get_survey_responses`. It also gives you access to the full contact database via `list_contacts`.

**What if I need to reply to a review? Can Birdeye handle that?**
Absolutely. You can prompt your agent to find a specific review and then execute a direct reply using the dedicated tool, so you maintain consistent brand messaging without leaving your workflow.

**Is this MCP good for reporting on multiple business locations?**
It's great for that. You can use Birdeye to list all managed business locations and pull review summaries specific to any single site, making regional comparisons easy.

**Does the Birdeye MCP help me automate customer follow-ups?**
Yes, it automates the process. You can trigger a check-in for a known customer, which tells Birdeye to send out the automated review or survey request automatically.