# Guestmeter MCP > Guestmeter MCP automates guest feedback collection and reputation management for hospitality businesses. Connect your AI agent directly to Guestmeter to track every rating, run surveys via email or SMS, and instantly categorize reviews by sentiment—from finding top promoters to identifying specific service gaps caused by detractors. ## Overview - **Category:** customer-support - **Price:** Free - **Tags:** reputation-management, nps, feedback-collection, surveys, customer-satisfaction, hospitality-tech ## Description You can manage an entire hotel's reputation without ever opening a spreadsheet. This MCP connects your AI client straight into the Guestmeter platform so you can talk to your guest data naturally. Need to know why guests left? You ask, and the agent pulls detailed reports on specific experiences. Want to fix service gaps immediately? The system lets you pull lists of detractors and even trigger follow-up surveys using just an email or phone number. Everything lives in one place, accessible through any MCP-compatible client on Vinkius. Your AI agent acts like a dedicated guest relations manager that never sleeps. ## Tools ### get_guest_details Pulls full profile information for a single guest by providing their unique ID. ### list_detractors Retrieves a list of guests who gave low ratings (scores 1-6). ### list_guest_feedback Lists all recorded guest feedback along with their status and final results. ### list_promoters Retrieves a list of guests who gave high ratings (scores 9-10). ### list_recent_feedback Gets the fifty most recent entries in guest feedback history. ### send_survey Sends a new satisfaction survey to a specific guest via SMS or email, requiring contact info. ## Prompt Examples **Prompt:** ``` List the most recent guest feedback entries. ``` **Response:** ``` I've retrieved the latest entries. Recent feedback includes: Sarah J. [10/10] - 'Amazing stay!', Mark T. [8/10] - 'Good location, but room was small', and Elena R. [9/10] - 'Excellent service'. Would you like to see the full details for Sarah's review? ``` **Prompt:** ``` Send a survey to John Doe at john.doe@example.com for room 302. ``` **Response:** ``` Survey trigger sent! I've successfully requested a satisfaction survey for John Doe (Room 302) via email. Guestmeter will deliver it shortly. ``` **Prompt:** ``` Show me all our detractors from the last batch. ``` **Response:** ``` Analyzing feedback... I found 2 detractors in your recent records: Michael S. [5/10] - 'Check-in was slow' and Linda K. [4/10] - 'AC was noisy'. Would you like their contact IDs to follow up? ``` ## Capabilities ### Identify top advocates Pulls lists of guests who gave high ratings (Promoters) for targeted follow-up or rewards. ### Target service failures Generates a list of every guest who left low ratings (Detractors), giving staff immediate leads for service recovery calls. ### Pull specific guest profiles Retrieves all detailed information about one particular guest using their ID. ### Check recent sentiment trends Pulls the fifty most recent feedback entries to give an immediate pulse on current operational issues. ### Send follow-up surveys Triggers a new satisfaction survey directly via email or SMS for any guest you identify. ## Use Cases ### A guest complained about the Wi-Fi speed, but I don't know who they are. You ask your agent to run `list_guest_feedback` and filter by 'Wi-Fi'. The system returns all relevant reviews. You then use `get_guest_details` on a specific guest ID to get their contact info, so you can follow up directly. ### We had a major issue with breakfast service this weekend. You tell your agent: 'Show me all detractors from the last three days.' The system runs `list_detractors`, giving you actionable names and comments, letting management know exactly what needs fixing. ### We just had a huge conference group leave. Need to track their satisfaction. You ask your agent to pull the list of promoters who stayed last week using `list_promoters`. You then use this list to trigger follow-up surveys via `send_survey` to keep that positive momentum going. ### I need a quick snapshot of what’s happening right now. You simply ask the agent to run `list_recent_feedback`. This gets you the 50 newest entries, allowing staff to quickly see if there's an immediate surge in complaints or praise. ## Benefits - Stop sifting through massive data dumps. Instead, use `list_recent_feedback` to get the most current sentiment entries immediately, giving you a real-time pulse of the property's mood. - Focus your service recovery efforts. The `list_detractors` tool filters out noise and gives you direct leads—the names of guests who need help right now. - Boost loyalty by finding advocates. You can run `list_promoters` to gather data on happy guests, helping you target them with special offers or follow-up calls. - Close the feedback loop efficiently. If a guest has left a review, use `send_survey` to trigger another survey right away via email or SMS, keeping your data stream fresh. - `get_guest_details` lets you cross-reference a name from a negative review with their booking history details before calling them back. ## How It Works The bottom line is you stop managing feedback through manual logins; your AI agent handles it conversationally. 1. Subscribe to this MCP and enter your Guestmeter API Key and Secret Key. 2. Instruct your AI client to perform an action, like 'List all detractors from the last week.' 3. The agent executes the request, returning a structured list of guest IDs, ratings, and comments for you to review. ## Frequently Asked Questions **How do I find my Guestmeter API credentials?** Log in to your Guestmeter dashboard and navigate to **Channels > Integration**. You will find your unique `apiKey` and `secretKey` there. **Can I trigger surveys for both email and SMS?** Yes! The `send_survey` tool allows you to provide either a `guest_email` or a `guest_phone` number. Guestmeter will automatically deliver the survey via the provided channel. **How does the integration categorize guests into Promoters or Detractors?** The integration uses the Net Promoter Score (NPS) logic: guests rating 9-10 are Promoters, 7-8 are Passives, and 1-6 are Detractors. You can use specialized tools like `list_promoters` to quickly access these segments. **Is the survey delivery instant?** Yes, once the `send_survey` action is triggered, Guestmeter processes the request immediately and sends the invitation to the guest. **When running `get_guest_details`, how do I handle a request for an unknown or deactivated guest ID?** The tool returns a specific error code and message indicating the ID was not found in the database. You'll receive clear instructions on what data is missing, letting you know exactly why the lookup failed. **If I need a larger dataset than the default limit, how do I adjust the results of `list_recent_feedback`?** The tool retrieves the 50 most recent records per call. For accessing bulk data or historical archives, you must use subsequent calls or consult our official API documentation for pagination parameters. **What does `list_guest_feedback` provide regarding a single guest's complete history and multiple feedback statuses?** This tool gives you a comprehensive view of the guest's interaction record. It shows not just their current rating, but also all status changes and types of feedback they submitted over time. **After running `list_detractors` to identify unhappy guests, what other details do I get besides their rating and comment?** Beyond the score and written comment, you receive essential identifying information for each record. This includes the guest's unique ID and contact method so your agent can follow up immediately.