Tools Overview

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

Tool Categories

Reviews

Review trends, rating overviews, and individual review data

Reports

Review, response, NPS, visitor, usage, and dashboard analytics

Business

Business profile and child location discovery

Surveys

Survey catalog and paginated response data

Listings

Listing profiles, status reports, insights, and product listings

Search AI

AI engine citations, business visibility, accuracy, and SWOT reports

Social

Social performance reports across multiple channels like Instagram, Facebook, LinkedIn etc.

Ticketing

Ticket retrieval with filtering and pagination

Aggregation

Review source monitoring

Competitor AI

Individual competitor reviews and aggregated rating metrics

Insight AI

Experience score benchmarks and location-level performance with period-over-period deltas

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