# OneLocal LocalReviews MCP > OneLocal LocalReviews manages your online reputation through automated review collection, monitoring, and response management. This MCP Server connects any AI client to your OneLocal account, letting you programmatically list reviews, track star ratings, monitor sentiment metadata, and run campaign requests—all from natural conversation. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** reputation-management, review-collection, local-seo, sentiment-analysis, customer-feedback, campaign-management ## Description You connect your OneLocal LocalReviews account to any AI client, and suddenly you've got full control over how you manage your business reputation. Your agent handles all the messy parts of review collection, monitoring, and responding—all through plain conversation. It’s about taking away the manual work so you can just focus on what you do best. Here's what you get when you hook up this server: **Checking the System Status:** You don't have to worry if anything is broken. If you run `check_onelocal_status`, your agent verifies right away whether the OneLocal API connection is active and running smoothly. That way, you always know the service isn't down or acting up. **Monitoring Your Reputation:** Want a quick read on how things are going? You can use `get_reputation` to get an instant overview of your current reputation score and overall rating metrics across multiple platforms. It tells you where you stand right now, period. **Handling Reviews (The Details):** Need deep info on specific feedback? You've got two ways to pull reviews. First, if you want a massive dump—a full list with filtering options for all the customer comments—you call `list_reviews`. Better yet, if you know exactly which review you need, you use `get_review` to retrieve all the details for just that one customer's feedback, including their sentiment and star ratings. You can also pull a complete summary of every single customer comment using `list_reviews`, giving you a full picture. **Tracking Campaign Efforts:** When it comes to asking customers for reviews, your agent keeps tabs on everything. If you want to see all the campaigns—past ones or active efforts—you use `list_campaigns`. Need specifics on one running campaign? Just call `get_campaign` and you'll get every detail about that single effort. You can also check out `list_locations` to pull a list of every physical business location tied to your account, making sure you know what scope you’re working within. **Initiating Action:** Ready to ask for some feedback? The `request_review` tool sends an automated review request email straight to the specific person or contact you name. It handles that whole communication loop for you. **Getting Contextual Data:** Sometimes, you need background info to make sense of a review. You can use `get_location` to grab general information about any physical business location on file. If you're tracking who sent the referrals or just want an audit trail of customer connections, `list_referrals` returns those specific records and tracking data points. **The Bottom Line:** Essentially, your AI client lets you manage everything—from checking if the API is live to getting a list of every single review ever submitted—without having to copy/paste or click through a dozen websites. It puts all that complex backend management into simple, direct conversation. ## Tools ### check_onelocal_status Verifies if the OneLocal API connection is active and operational. ### get_campaign Retrieves specific details for one running review campaign. ### get_location Gets general information about a physical business location. ### get_reputation Provides an overview of your current reputation score and overall rating metrics. ### get_review Retrieves the full details for a single, specific customer review. ### list_campaigns Lists all active and past review campaigns you've set up in OneLocal. ### list_locations Returns a list of all locations associated with your account. ### list_referrals Lists records related to customer referrals and tracking data. ### list_reviews Retrieves a comprehensive list of all received customer reviews, often with filtering options. ### request_review Sends an automated review request email to a specified person or contact. ## Prompt Examples **Prompt:** ``` Show all recent reviews for my business. ``` **Response:** ``` You have 24 reviews this month. Average rating: 4.7/5. 3 reviews need a response. The latest is a 5-star review on Google from Lisa Chen. Would you like to respond? ``` **Prompt:** ``` Send a review request to john@example.com. ``` **Response:** ``` Review request sent to john@example.com. The email includes links to Google and Facebook review pages. I'll track the response. Would you like to send more requests? ``` **Prompt:** ``` Show my overall reputation score. ``` **Response:** ``` Your reputation score is 4.6/5 across 3 platforms. Google: 4.7 (180 reviews), Facebook: 4.5 (45 reviews), Yelp: 4.4 (22 reviews). Trend: +0.2 this quarter. Would you like to see review sentiment analysis? ``` ## Capabilities ### Monitor overall business reputation Gets a summary of your current rating across multiple platforms using the `get_reputation` tool. ### Retrieve detailed review records Pulls specific review data, including sentiment and star ratings, by calling `list_reviews` or `get_review`. ### Initiate customer review requests Sends automated review request emails to a specified contact using the `request_review` tool. ### Track campaign progress Checks details and status for ongoing feedback campaigns with `get_campaign` or `list_campaigns`. ### Check API connection health Verifies that the OneLocal service is connected and running correctly using `check_onelocal_status`. ## Use Cases ### Quarterly Reputation Audit The owner needs a quick snapshot of how their brand is doing. They ask the agent to 'Show my overall reputation score for Q2.' The agent runs `get_reputation`, pulling combined metrics from multiple platforms, and delivering a clear trend line without leaving the chat interface. ### Handling Negative Feedback Spikes A competitor just posted something negative. The marketing manager asks the agent to 'List all reviews mentioning service issues.' The agent uses `list_reviews` and filters by keywords, giving the manager a prioritized list of specific complaints that need immediate human attention. ### Scaling Client Acquisition The operations team just signed three new franchises. They ask the agent to 'List all locations for our new network.' The agent runs `list_locations`, providing a clean, centralized list of every physical site that needs its own review monitoring setup. ### Targeted Review Campaign Launch The manager wants reviews from recent clients. They ask the agent to 'Send a review request to our top 50 customers.' The agent uses `list_referrals` to identify contacts, then runs `request_review` in batches, and tracks the resulting campaign using `get_campaign`. ## Benefits - Automate review collection and response monitoring. Instead of manually following up on every piece of feedback, your agent can use `request_review` to send out targeted requests while simultaneously tracking the results via `list_reviews`. - Get a real-time reputation overview instantly. The `get_reputation` tool gives you quantifiable metrics—like average star ratings and trend data—so you don't have to compile it from three different dashboards. - Stop guessing about system health. Use `check_onelocal_status` before running any major campaign. It confirms that the API connection is live, preventing costly workflow failures down the line. - Process complex location and campaign data efficiently. Need to know which reviews belong to a specific branch? First use `list_locations`, then filter your search using `get_location` details in conjunction with `list_reviews`. - Maintain perfect audit trails. The ability to retrieve customer identifiers and response history means you always have the context needed for compliance or dispute resolution, without digging through multiple systems. ## How It Works The bottom line is: You talk naturally to your agent; it handles the complex API calls and brings back structured data instantly. 1. Subscribe to this server and retrieve your API Key from your OneLocal dashboard (Settings > API). 2. Connect the key credentials to Claude, Cursor, or any MCP client. Your agent now has direct access to all local reviews data. 3. Tell your AI client what you need—for example, 'List all 5-star reviews from last month.' The agent executes the specific tool call and delivers the results. ## Frequently Asked Questions **How do I check if my OneLocal API key is working?** Run the `check_onelocal_status` tool. This instantly verifies your connectivity to the platform, letting you know whether your credentials are set up correctly before running any other commands. **What's the difference between list_reviews and get_review?** `list_reviews` pulls a bulk list of multiple reviews, often filtered by date or rating. Use `get_review` only when you know the exact ID of one specific review you need details on. **Can I use OneLocal LocalReviews MCP Server to send out more requests?** Yes. The `request_review` tool sends automated follow-up links to customers, and the system tracks these actions so you can monitor the campaign progress using `get_campaign`. **How do I find all my business locations?** Use the `list_locations` tool. This returns a complete list of every location connected to your account, which is essential before you try to analyze reviews for a specific branch. **When I use the `get_review` tool, what kind of detailed metadata can my agent retrieve?** It retrieves structured data beyond just the text. You get star ratings, timestamps, the review source (e.g., Google/Yelp), and sentiment scores. This rich metadata is essential for building a precise audit trail in your workflow. **Using `list_campaigns`, how do I verify which feedback campaigns are active?** It returns a list of all existing campaign IDs and their current status. You can check the start date, target group, and if the request pipeline is currently running or paused. This helps you coordinate your outreach efforts. **How does `list_referrals` help me track customer sources that aren't reviews?** This tool pulls a list of all successful referrals, not just feedback. You get the referring customer ID and the date they signed up. It lets you track growth sources separate from your general review collection. **If I run many requests, how does `get_reputation` handle API rate limits?** The server adheres to standard API rate limiting protocols. If you exceed the allowed calls per minute, your agent will receive a specific error code (HTTP 429). You'll need to build in a delay or switch to batch processing for high-volume data pulls. **How do I send a review request to a customer?** Use the `request_review` tool with the customer's email address and optional name. The request is sent immediately through your OneLocal account. **Can I monitor my overall reputation score?** Yes. Use `get_reputation` to retrieve your aggregate reputation score with review trends, sentiment analysis, and platform-by-platform breakdown. **How do I track referral performance?** Use `list_referrals` to see all customer referrals with their source, status, and conversion tracking data.