# Cloutly MCP MCP > Cloutly MCP handles all review data, pulling in feedback from Google, Facebook, and Trustpilot into one place. It lets your agent search for specific customer reviews, find negative replies that need attention, send targeted review invites via email or SMS, and post professional responses back to the original platform. ## Overview - **Category:** customer-support - **Price:** Free - **Tags:** reputation-management, review-collection, customer-feedback, social-proof, feedback-loop, customer-engagement ## Description Managing online reputation used to mean logging into four different tabs just to see what customers were saying—Google Business Profile here, Trustpilot there. Now, this MCP brings all of that data together. You can ask your agent for a digest of all recent reviews across every connected source, then immediately filter down to only the ones that haven't gotten a reply yet. Need to respond? Your agent drafts and posts a professional reply directly back to the original site. Plus, if you spot a high-value customer who hasn't reviewed recently, your agent can trigger an invite through email or SMS automatically. When working with Vinkius in the Vinkius Marketplace, this MCP makes sure all those review sources talk to each other, so you never miss a piece of feedback. ## Tools ### list_businesses Retrieves all business locations associated with your Cloutly account for data scope definition. ### list_campaigns Checks the status and details of active review campaigns running for a specific business unit. ### list_pending_reviews Gathers all customer reviews that have not yet received an official reply from your team. ### list_reviews Retrieves a list of reviews across connected sources, supporting filtering by business location and pagination. ### reply_to_review Posts your drafted reply directly to the review on its original source platform like Google or Facebook. ### search_reviews_by_author Searches for reviews specifically left by a customer using their full name. ### send_review_invite Triggers a review request for a known customer, delivering the invitation via Email or SMS. ## Prompt Examples **Prompt:** ``` Show me the latest reviews aggregated targeting our main branch in Cloutly. ``` **Response:** ``` Aggregated 47 reviews across Google, Facebook and Trustpilot. Average rating: 4.6★. Breakdown: 5★ (28), 4★ (12), 3★ (4), 2★ (2), 1★ (1). Sentiment trend: +0.3 over last 30 days. ``` **Prompt:** ``` Send a priority review invitation email to John Doe (john.doe@example.com) for business ID 'xxxx'. ``` **Response:** ``` Review invitation sent to John Doe (john.doe@example.com) for business 'xxxx'. Priority: high. Delivery method: email. Expected open rate for priority invitations: ~68%. ``` **Prompt:** ``` List all outstanding negative reviews that haven't been replied to in Cloutly. ``` **Response:** ``` Found 3 negative reviews without replies: 1. Google — 1★ by Mike R. (2 days ago): "Terrible customer service" 2. Facebook — 2★ by Lisa T. (5 days ago): "Long wait times" 3. Trustpilot — 1★ by James K. (1 week ago): "Product arrived damaged" ``` ## Capabilities ### Audit business locations Retrieves a full list of every business or location linked to your Cloutly account. ### Monitor review campaigns Checks the status and details of active review collection campaigns for a specific business unit. ### Identify unreplied reviews Gathers all customer reviews that currently lack an official response from your team. ### Aggregate and filter feedback Collects a comprehensive list of reviews, allowing filters by business location or specific date ranges. ### Post platform replies Submits your drafted response directly to the review on its original source platform (e.g., Google or Facebook). ### Search by customer name Narrows down the feed to find all reviews left by a specific person's name. ### Send review requests Initiates a formal review request for a known customer, sending it via either email or SMS. ## Use Cases ### Crisis management after a bad product launch The operations team notices negative buzz. They ask their agent to run `list_pending_reviews` to see all unreplied complaints, then use `search_reviews_by_author` for the most frequent complaint name to gauge severity before drafting a public response using `reply_to_review`. ### Re-engaging dormant customers The sales team identifies 50 key accounts that haven't left reviews in six months. They use the agent to run `send_review_invite` for all 50 contacts, automating a crucial step in reputation building. ### Preparing for a new branch opening A manager needs to know if the new location's reviews are collected. They start by running `list_businesses` to confirm the new ID is active, then run `list_reviews` scoped only to that ID. ## Benefits - Centralized View: Instead of logging into Google, Facebook, and Trustpilot separately, you use `list_reviews` to pull a single aggregated feed of all customer comments. This cuts down on context switching time significantly. - Immediate Response Loop: When negative feedback hits, your agent can immediately identify it using `list_pending_reviews` and draft/post the response via `reply_to_review`. You maintain visibility without manual effort. - Proactive Collection: Don't wait for reviews. Use `send_review_invite` to trigger a request for specific high-value customers, ensuring you capture feedback at the optimal time through email or SMS. - Targeted Insight: Need to know what one person thinks? `search_reviews_by_author` lets you drill down by name, giving you deep context on repeat customer sentiment. This is critical for service recovery. - Scope Management: Use `list_businesses` early in your workflow to ensure the agent knows exactly which physical locations or business units' reviews you are analyzing. ## How It Works The bottom line is: you move from raw data retrieval to actionable customer engagement in a single sequence of calls. 1. First, your agent calls `list_businesses` to confirm which locations you want feedback data from. 2. Next, use `list_reviews` to pull all aggregated reviews across sources; if you find a negative one, call `search_reviews_by_author` for more context on that person's history. 3. To close the loop, your agent drafts the reply and executes `reply_to_review`, posting it back to the original source. ## Frequently Asked Questions **How do I check if all my business locations are connected using list_businesses?** Running `list_businesses` pulls a definitive roster of every location tied to your account. If an ID is missing, you know exactly which unit needs manual setup before running any review retrieval tool. **Can I use the list_pending_reviews tool for filtering by date?** While `list_pending_reviews` shows all unreplied comments, it's better to first run `list_reviews` and then filter that result set. This gives you more control over time-based queries. **What is the difference between list_reviews and list_businesses?** Think of `list_businesses` as confirming your inventory—it tells you *what* locations exist. `list_reviews`, conversely, gives you the actual customer feedback data for those existing locations. **Does reply_to_review post to my internal CRM?** No, `reply_to_review` posts directly back to the original source platform (e.g., Google). It's designed for public visibility on the review site itself. **If I only know part of a customer's name, can `search_reviews_by_author` still find their reviews?** Yes, it supports partial matching. You don't need the full spelling or last name to narrow down results; just providing key parts of the name will help your agent locate the correct review record. **When I run `send_review_invite`, how do I decide whether the invitation goes out via Email or SMS?** You specify the delivery channel when calling the tool. The MCP allows you to select either email or SMS directly in the API call, letting you manage which communication method works best for that customer base. **What happens if I use `list_campaigns` and there are no active campaigns set up?** The tool returns an empty list. This means there are currently no live review collection efforts tied to your business ID in Cloutly, so you'll need to create a new campaign first. **Are there any performance limits or rate restrictions when I call `list_reviews` for many sources?** The MCP handles bulk data through pagination. You shouldn't hit limits if your agent uses the provided page tokens to iterate through all connected sources efficiently. **How do I get my Cloutly API key?** You can generate an API key in your Cloutly dashboard under Developers > Public API to access your permanent key. **Which review sources are supported?** Cloutly natively supports Google, Facebook, Trustpilot, TripAdvisor, and many other industry-specific platforms out of the box. **Can I reply to reviews directly from the MCP?** Yes, if supported by the channel API, the 'reply_to_review' tool allows you to draft and instantly post responses from your AI.