# GoZen Testimonials MCP MCP > GoZen Testimonials MCP automates your entire social proof pipeline. Use this connector with any AI client to collect video and written customer reviews, manage submission forms, and track real-time engagement metrics through natural conversation. ## Overview - **Category:** customer-support - **Price:** Free - **Tags:** social-proof, review-management, customer-feedback, video-testimonials, sentiment-analysis, widget-integration ## Description Stop manually chasing down reviews or digging through dashboards for insights. This MCP gives you full control over your customer testimonials directly from your agent. You can programmatically list all collected reviews, check the sentiment metadata on submissions, or even monitor a specific campaign's response rate. Need to build a new capture method? Use the tools here to create and manage dedicated submission forms. The system handles everything from initial submission tracking to deploying branded widgets across your site. Since this MCP is hosted on Vinkius, you connect once through your preferred AI client—Claude, Cursor, or any compatible agent—and gain access to all these capabilities without ever leaving your workflow. ## Tools ### approve_testimonial Marks a customer review as approved for public display. ### check_gozen_status Verifies the connection status of the GoZen service account. ### create_form Generates a new, branded form for customers to submit feedback. ### create_widget Builds a new display widget ready to embed on your website or app. ### delete_testimonial Removes an existing testimonial from the system completely. ### get_form Retrieves the full details and current status of a specified submission form. ### get_testimonial Fetches all detailed metadata for one specific customer testimonial. ### get_widget Retrieves the configuration and code details for a widget. ### list_testimonials_by_form Lists only the testimonials that came through a specific submission form. ### list_forms Lists all currently active submission forms you have created. ### list_tags Provides a list of available categorization tags for your submissions. ### list_testimonials Retrieves a summary list of all collected customer reviews and videos. ### list_widgets Shows an overview of all widgets you have built and deployed. ## Prompt Examples **Prompt:** ``` List all new testimonials received in GoZen today. ``` **Response:** ``` I've retrieved your testimonials. You currently have 5 new high-fidelity submissions today, including a video review from 'John Client'. Would you like the detailed sentiment metadata for any of them? ``` **Prompt:** ``` Check the response rate for the 'Year-End Review' campaign. ``` **Response:** ``` Campaign intelligence orchestrated! For 'Year-End Review', I've identified a high-fidelity response rate of 15% across 100 requests. I've retrieved the technical status metadata for your review. Need help sending reminders to non-respondents? ``` **Prompt:** ``` Show the view count for the 'Success Story' video widget. ``` **Response:** ``` Engagement monitoring complete! The Success Story widget has received 500 high-fidelity views this month, with a 50% video completion rate. Your API connection is healthy. Shall I retrieve the detailed conversion breakdown? ``` ## Capabilities ### Manage Testimonial Content List, retrieve details for, and delete specific customer testimonials. ### Create Submission Forms Set up new forms to capture structured customer feedback and video submissions. ### Build Display Widgets Generate the code and details for branded widgets that display your social proof on a website. ### Monitor Campaign Performance Programmatically check the status of testimonial request campaigns to maintain consistent outreach. ### Verify System Health Check API connectivity and monitor overall submission volume for scaling needs. ## Use Cases ### Need to know how many reviews came from the new website landing page? Instead of checking multiple dashboards, ask your agent to run `list_testimonials_by_form`. It will instantly compile a list only for submissions associated with that specific form. ### The 'Year-End Review' campaign is stalled. How do I check the status? Ask the agent to monitor testimonial request campaigns. It provides real-time insights into response rates and helps determine if you need to send follow-up reminders. ### I updated my website design, but the 'Success Story' widget looks wrong. Run `get_widget` via your agent. It fetches the current configuration details and code for the widget so you can verify it works perfectly with your new site structure. ### I need to check if my API key is still working before a big launch. Simply ask your agent to run `check_gozen_status`. It verifies the connection instantly, saving you from debugging authentication issues right before go-live. ## Benefits - Instantly gather data by using `create_form` to build targeted submission pages, ensuring you capture exactly the information you need from customers. - Maintain a clean content library; easily approve submissions with `approve_testimonial` or remove outdated reviews using `delete_testimonial`—all via command. - Keep your sites looking good by generating and managing branded display widgets through `create_widget`, which you can then embed anywhere. - Stay on top of outreach. You don't have to manually track campaigns; simply ask the agent to check campaign intelligence to see response rates. - Get deep insights without leaving your workflow. Using `get_testimonial` lets your AI client pull detailed sentiment metadata for instant reporting. ## How It Works The bottom line is: Your AI client acts as the coordinator, running complex operations across GoZen without needing manual intervention. 1. Subscribe to this MCP and grab your API Key from the GoZen dashboard. 2. Connect your AI client using that key; the agent now sees all available functions. 3. Tell your agent what you need—for instance, 'List all testimonials submitted last week,' or 'Create a form for our beta users.' The agent executes the task. ## Frequently Asked Questions **How do I use the `list_testimonials` tool?** You ask your agent to run 'list testimonials.' It pulls a summary of all reviews, letting you see who submitted them and when. You can then drill down for more detail. **Can I use the `create_form` tool to track specific beta users?** Yes. Use 'create form' and specify that it's for beta testers. This lets you gather targeted feedback, keeping those submissions separate from general customer reviews. **What is the difference between `list_testimonials` and `list_testimonials_by_form`?** `List testimonials` gives you everything in one dump. Use 'list testimonials by form' when you only want to see submissions that came through a single, specific capture form. **If I delete a review using `delete_testimonial`, is it permanent?** Yes, running 'delete testimonial' removes the content from the system. Always confirm you have the right ID before letting your agent run that command. **How do I check my API connection status before using tools like `list_testimonials`?** Run the `check_gozen_status` tool first. This verifies your account's connectivity health immediately. It confirms that the MCP can communicate with GoZen, which is essential if you suspect an authentication or service scaling issue. **What should I do if the `approve_testimonial` tool fails due to permissions?** The system returns a specific permission failure message. This means the testimonial's status needs manual adjustment in your GoZen dashboard before your agent can approve it via the MCP. **Are there rate limits when I use multiple listing tools, like `list_testimonials` and `list_widgets`?** The MCP manages standard API throttling. For bulk data pulls in a single run, monitor your usage metrics via the GoZen dashboard. If you hit a limit, wait 60 seconds or implement an exponential backoff strategy in your client code. **How does using `get_widget` help me understand widget configuration details?** It returns all metadata for a specific widget ID. You get the full technical blueprint, including display rules and embed code snippets, without having to log into your GoZen account. **How do I find my GoZen Testimonials API Key?** Log in to your account, navigate to **Settings** > **API**, and copy your unique access token from the credentials section. **Can I check video testimonial views via AI?** Yes! The `list_gozen_testimonials` tool allows your agent to retrieve high-fidelity engagement metadata including view counts for all your testimonials. **How do I list my testimonial widgets?** Use the `list_gozen_widgets` tool to retrieve your complete high-fidelity directory along with the unique identifiers for all managed display layouts.