> ## Documentation Index
> Fetch the complete documentation index at: https://birdeye-0229a3ce-responsetools.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools Overview

> Birdeye MCP provides a variety of read-only tools across different categories. All tools use your authenticated Birdeye account context

## Tool Categories

<CardGroup cols={2}>
  <Card title="Reviews" icon="star" href="/mcp/tools/reviews/overview">
    Review trends, rating overviews, and individual review data
  </Card>

  <Card title="Reports" icon="chart-bar" href="/mcp/tools/reports/overview">
    Review, response, NPS, visitor, usage, and dashboard analytics
  </Card>

  <Card title="Business" icon="building" href="/mcp/tools/business/overview">
    Business profile and child location discovery
  </Card>

  <Card title="Surveys" icon="clipboard-list" href="/mcp/tools/surveys/overview">
    Survey catalog and paginated response data
  </Card>

  <Card title="Listings" icon="map-pin" href="/mcp/tools/listings/overview">
    Listing profiles, status reports, insights, and product listings
  </Card>

  <Card title="Search AI" icon="magnifying-glass" href="/mcp/tools/search-ai/overview">
    AI engine citations, business visibility, accuracy, and SWOT reports
  </Card>

  <Card title="Social" icon="share-nodes" href="/mcp/tools/social/overview">
    Social performance reports across multiple channels like Instagram, Facebook, LinkedIn etc.
  </Card>

  <Card title="Ticketing" icon="ticket" href="/mcp/tools/ticketing/overview">
    Ticket retrieval with filtering and pagination
  </Card>

  <Card title="Aggregation" icon="layer-group" href="/mcp/tools/aggregation/overview">
    Review source monitoring
  </Card>

  <Card title="Competitor AI" icon="robot" href="/mcp/tools/competitor-ai/overview">
    Individual competitor reviews and aggregated rating metrics
  </Card>

  <Card title="Insight AI" icon="lightbulb" href="/mcp/tools/insight-ai/overview">
    Experience score benchmarks and location-level performance with period-over-period deltas
  </Card>
</CardGroup>

## All Tools

| Tool                                     | Module        | Description                                                         |
| ---------------------------------------- | ------------- | ------------------------------------------------------------------- |
| `review_and_rating_overview`             | Reviews       | Review and rating trends over a time period                         |
| `get_reviews`                            | Reviews       | Individual reviews with full details                                |
| `get_review_summary`                     | Reviews       | Review counts and averages grouped by source                        |
| `get_review_conversion_report`           | Reports       | Review request conversion across email, SMS, and review sources     |
| `get_review_and_rating_over_time`        | Reports       | Review volume and average rating over time                          |
| `get_review_and_rating_by_location`      | Reports       | Review volume and average rating by location                        |
| `get_review_count_by_source`             | Reports       | Review counts grouped by source for each location                   |
| `get_visitor_count`                      | Reports       | Visitor counts grouped by traffic source and location               |
| `get_nps_over_time`                      | Reports       | Net Promoter Score trends over time                                 |
| `get_nps_by_location`                    | Reports       | Net Promoter Score by location                                      |
| `get_usage_report`                       | Reports       | Detailed review request usage and conversion funnel                 |
| `get_business_dashboard_report`          | Reports       | Business dashboard with ratings, sentiment, benchmarks, and reviews |
| `get_review_response_rate_over_time`     | Reports       | Review response rate and unanswered reviews over time               |
| `get_review_response_rate_by_location`   | Reports       | Review response rate and unanswered reviews by location             |
| `get_avg_response_time_over_time`        | Reports       | Average review response time trends                                 |
| `get_avg_response_time_by_location`      | Reports       | Average review response time by location                            |
| `get_review_count_by_rating`             | Reports       | Review distribution by star rating                                  |
| `get_review_count_by_rating_by_employee` | Reports       | Review distribution by rating and assisted employee                 |
| `get_business_info`                      | Business      | Business profile of the authenticated user                          |
| `get_child_locations`                    | Business      | All child locations of the enterprise account                       |
| `get_all_surveys`                        | Surveys       | All surveys for the business                                        |
| `get_survey_responses`                   | Surveys       | Paginated responses for a specific survey                           |
| `get_listing`                            | Listings      | Full listing profile for a single location                          |
| `get_listing_location_status_report`     | Listings      | Listing sync status across sites for a location                     |
| `get_listing_insights`                   | Listings      | Google and other listing analytics                                  |
| `get_listing_category_list`              | Listings      | Available listing categories by source and country                  |
| `get_product_listing_list`               | Listings      | Google Merchant product listings                                    |
| `get_search_ai_configuration`            | Search AI     | Search AI themes and prompt configuration                           |
| `get_search_ai_available_runs`           | Search AI     | Past Search AI run dates and themes                                 |
| `get_search_ai_citations`                | Search AI     | URLs cited by AI engines (ChatGPT, Gemini, Perplexity)              |
| `get_search_ai_businesses`               | Search AI     | Businesses surfaced by AI engines for your prompts                  |
| `get_search_ai_accuracy_report`          | Search AI     | NAP accuracy as reported by AI engines                              |
| `get_search_ai_sentiment_report`         | Search AI     | SWOT analysis from AI engine sentiment                              |
| `get_social_open_url_performance_report` | Social        | Channel-level social performance with comparison                    |
| `get_all_ticket_data`                    | Ticketing     | Tickets with full filtering and pagination                          |
| `get_all_aggregation_sources`            | Aggregation   | Review monitoring URLs configured for the business                  |
| `retrieve_competitor_reviews`            | Competitor AI | Paginated individual reviews for competitor locations               |
| `retrieve_competitor_review_metrics`     | Competitor AI | Aggregated average rating and review count per competitor           |
| `get_insight_experience_score_benchmark` | Insight AI    | Experience scores vs industry benchmarks                            |
| `get_insight_experience_location_info`   | Insight AI    | Location-level scores with period-over-period deltas                |

## Common Patterns

### Enterprise Accounts with Multiple Locations

Most tools operate at the **account level** automatically. For tools that require a specific location (marked as **location-level**), first call `get_child_locations` to retrieve valid `locationId` values.

```
1. get_child_locations          → get list of {id, name} for each location
2. get_listing(locationId=...)  → use a location id from step 1
```