# TrueReview MCP

> TrueReview connects your reputation management account to any AI agent. You use it to collect customer reviews, manage review requests via SMS or email, and track performance metrics through natural conversation. It handles everything from creating new contact records to monitoring business ratings across multiple locations.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Tags:** reputation-management, customer-feedback, testimonials, review-requests, social-proof, automation

## Description

Listen up. This TrueReview MCP Server connects your whole reputation management setup to any AI client you're running. You use it to collect customer reviews, manage outreach requests via text or email, and track how well your business is doing—all without jumping between ten different tabs. It handles everything from building out new client profiles to monitoring ratings across every single location you run.

**Managing Customer Records.** When you need to work with a client, the agent can first add an entirely new contact profile into TrueReview using `create_contact`. If you already have that person in the system, you don't waste time guessing—you just tell it to pull up their specific details and history by running `get_contact` against an ID. This keeps your data clean and accurate.

**Initiating Review Requests.** You can send a review request directly to any customer listed in TrueReview using the `send_review_request` tool. You just specify whether they prefer email or SMS, and boom—the feedback link gets sent out immediately. It's fast, direct, and you get that crucial piece of data right away.

**Viewing Outreach Campaigns.** Before you hit send on a request, you gotta know what sequences are available. The agent pulls up all pre-built customer outreach campaigns and sequences by running `list_campaigns`. This lets you plan your next wave of reviews without having to manually set anything up.

**Checking Business Locations.** If you've got multiple spots—a franchise, a flagship store, whatever—you need to know how they're doing. The agent lists and manages every unique business location monitored by TrueReview using `list_locations`, so you always track reputation across the entire company footprint.

**Listing Contacts.** Need to see who needs to hear from you? You can run `list_contacts` to get a complete list of every single contact tied to your specified business area. It’s your roster, right there in your agent's memory.

**Review Performance Reporting.** To know if the effort is paying off, the agent pulls summary reports on reviews using `get_report_summary`. This gives you quick numbers on overall rating and volume over a set time period—you see the big picture fast. You can track performance metrics without pulling complicated dashboards.

This server lets your AI client talk directly to TrueReview's back end. It manages contacts, sends out review requests via email or SMS, checks business locations across all branches with `list_locations`, and pulls summary reports on overall review health using `get_report_summary`. You can list every contact associated with a location using `list_contacts` or create an entirely new profile with `create_contact`; need to check history? Use `get_contact`. Want to start the whole process? Tell it to run `send_review_request`, and you're good to go. Planning your next push is simple too; just let the agent show you all available sequences by running `list_campaigns`.

## Tools

### create_contact
Adds a brand new customer contact profile into your TrueReview account.

### get_contact
Retrieves specific details and history for one existing customer record by ID.

### get_report_summary
Pulls a summary report showing overall review performance metrics over a given period.

### list_campaigns
Shows you all the available, pre-built customer outreach campaigns and sequences.

### list_contacts
Retrieves a full list of every contact associated with your specified business location.

### list_locations
Lists all the unique business locations monitored by your TrueReview account.

### send_review_request
Sends a review request to an individual customer using email or SMS, triggering the feedback link.

## Prompt Examples

**Prompt:** 
```
List all contacts in my TrueReview account.
```

**Response:** 
```
I've retrieved your contacts. You have 25 active customer records including 'John Miller', 'Sarah Smith', and 'Robert Chen'. Would you like to send a review request to any of them?
```

**Prompt:** 
```
Send an email review request to 'John Miller' (ID: 10293).
```

**Response:** 
```
Request sent! I've triggered the email review request for John Miller (ID: 10293). He should receive the link in his inbox shortly. I'll monitor for any updates.
```

**Prompt:** 
```
Show me a summary of my recent reviews.
```

**Response:** 
```
I've fetched your report summary. Over the last 30 days, you've received 12 new reviews with an average rating of 4.8 stars. Your response rate is currently 92%. Shall I list the individual feedback comments?
```

## Capabilities

### Manage Customer Records
The agent creates new customer contacts using `create_contact` or retrieves full details for existing ones with `get_contact`.

### Initiate Review Requests
You send a review request to any listed customer by calling the `send_review_request` tool, specifying email or SMS.

### Review Performance Reporting
The agent pulls summary reports on reviews using `get_report_summary`, giving you quick insights into overall rating and volume.

### View Outreach Campaigns
You list all available review campaigns or sequences by running `list_campaigns` to plan your next outreach effort.

### Check Business Locations
The agent lists and manages business locations using `list_locations`, ensuring you track reputation across every branch.

## Use Cases

### The Manager needs to check cross-site performance.
A marketing manager notices one branch (Location X) has fewer reviews than others. They use `list_locations` to verify all sites are connected, then call `get_report_summary`, filtering by Location X's SID. The agent returns the low metric count and an average rating of 3.1 stars, immediately flagging a local issue.

### The Agent needs to follow up on a cold lead.
A customer service agent has a client record but hasn't heard from them in weeks. They use `get_contact` to verify the last interaction date, and then immediately call `send_review_request` via email, restarting the feedback cycle without any manual copy-pasting of links.

### The Owner is onboarding a new service area.
A business owner expands to a new zip code. They first use `list_locations` to confirm the new site ID, then call `create_contact` for their top 10 clients at that location. This ensures all necessary contacts are set up in TrueReview before any campaigns start.

### The Team needs a quick overview of all recent feedback.
The team lead asks, 'What's the status of our review collection this month?' The agent responds by running `get_report_summary` and provides the total count of reviews received and the current average star rating, solving the need for an immediate KPI snapshot.

## Benefits

- Saves time managing outreach. Instead of manually sending links, you use `send_review_request` to trigger review requests via SMS or email instantly for specific customers.
- Keeps data clean across locations. You can run `list_locations` and then `list_contacts` against each one, ensuring your reputation management is consistent everywhere.
- Gets quick performance readouts. Running `get_report_summary` gives you a single view of review metrics, so you don't have to calculate the average rating manually.
- Organizes client data better. You can use `create_contact` and `get_contact` together to build out detailed customer files that track history alongside their feedback.
- Simplifies campaign strategy. By listing campaigns via `list_campaigns`, you see exactly which drip sequences are available, so you don't forget a crucial step in your outreach plan.

## How It Works

The bottom line is: you talk to your AI client naturally, and it handles the API calls to TrueReview for you.

1. First, subscribe to the TrueReview server and enter your API Key and Location SID credentials.
2. Next, tell your AI agent what you need—for instance, 'List all contacts in my Denver branch' or 'Send an email review request to John Doe'.
3. Finally, the agent executes the appropriate tool (`list_contacts`, `send_review_request`, etc.) and returns a clean report or confirmation message.

## Frequently Asked Questions

**How do I check review performance using get_report_summary?**
You run `get_report_summary` and specify the date range. The agent returns a summary of reviews, including the total count and average rating for that period.

**Can I send requests to multiple contacts at once using send_review_request?**
The `send_review_request` tool sends a request one customer at a time. If you need bulk requests, first use `list_contacts` and then iterate through the list with your AI agent.

**What is the difference between list_contacts and get_contact?**
`list_contacts` gives you a roster of all names at one location. `get_contact` uses a specific ID to pull the entire, deep history for just that single person.

**How do I find out what campaigns are available?**
Just call `list_campaigns`. This tool shows you all your pre-made review sequences and outreach options so you know which strategy to use next.

**Before I use any tool, how do I ensure the connection is working by using `list_locations`?**
The system first requires a valid API Key and Location SID. Calling `list_locations` validates your credentials against TrueReview's active sites. If locations return successfully, you know the server has connected properly.

**When using `create_contact`, what happens if that contact record is a duplicate?**
The tool prevents creating duplicate records. If you attempt to use an email or ID already linked to a customer, it returns an error code rather than overwriting data.

**If I run `get_contact` with an invalid customer ID, how does the tool handle the request?**
It immediately returns a specific 404 error and a clear message stating that no contact was found. Always use `list_contacts` first to confirm valid IDs before querying.

**After gathering data, what's the best way to schedule multiple reviews using `send_review_request`?**
The tool sends requests instantly, so scheduling must happen outside of the immediate function call. Use your agent’s workflow scheduler to manage timing and batching of calls over time.

**Can I send a review request via SMS using the AI?**
Yes! Use the `send_review_request` tool. Provide the Contact ID and set the type to 'sms'. The agent will trigger the SMS request through TrueReview instantly.

**How do I see the overall feedback summary for my business?**
Run the `get_report_summary` query. The agent will retrieve a concise report of your review performance and customer satisfaction metrics.

**Is it possible to add a new customer contact via AI?**
Absolutely. Use the `create_contact` action. Provide the first name, last name, and email or phone number to register a new customer for future review requests.