# Endorsal Testimonials MCP > Endorsal Testimonials MCP manages your entire social proof pipeline. It lets you list, retrieve, and audit every testimonial collected across all your brands. You can track which display widgets are active on specific websites and even approve pending reviews instantly using your AI agent. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** social-proof, testimonials, reviews, customer-feedback, reputation-management, widget-integration ## Description Need to keep up with customer feedback? This connector brings Endorsal's full testimonial collection platform right into your AI workflow. Instead of jumping between multiple dashboards, you can use your agent to manage all your social proof from one conversation. You can check out recent ratings and retrieve detailed content for any single review or list every piece of metadata across the account. Need to know what widgets are live on which sites? The system tracks that too. This is built for teams that need instant visibility into reputation management. If you're building a centralized knowledge layer, Vinkius hosts this MCP in the catalog, letting your agent access Endorsal data alongside other services. You can monitor review volumes and even push through approvals to get high-quality proof published instantly. ## Tools ### quick_social_proof_audit Provides an instant, high-level summary of review volume and widget activity across the account. ### approve_pending_testimonial Marks a testimonial as approved, making it immediately visible on your configured websites. ### get_endorsal_account_metadata Retrieves limits and necessary data about the Endorsal account setup. ### get_testimonial_details Pulls the full content, ratings, and metadata for one specific testimonial. ### list_pending_testimonials Retrieves a list of all testimonials that are currently waiting for your manual approval. ### list_account_properties Lists every website or brand property connected to your account. ### list_latest_testimonials Identifies and lists the most recently collected testimonials automatically. ### list_all_testimonials Retrieves a comprehensive list of all testimonials collected across the platform. ### list_display_widgets Shows all display widgets configured for your brands, like badges or 'Wall of Love' sections. ### search_testimonials_by_keyword Searches for testimonials using specific customer names or text keywords. ## Prompt Examples **Prompt:** ``` List all my collected testimonials. ``` **Response:** ``` I've found 15 testimonials, including 'Excellent Service' (5 stars) and 'Highly Recommended' (5 stars). 12 are approved and 3 are pending. Would you like to see the text for the pending ones? ``` **Prompt:** ``` Show me the display widgets configured. ``` **Response:** ``` I've retrieved 4 widgets, including 'Main Website Wall' (Wall of Love), 'Sidebar Badge', and 'Checkout Slider'. Should I pull the specific property ID for the Main Website Wall? ``` **Prompt:** ``` Approve testimonial ID 'TEST-12345'. ``` **Response:** ``` Testimonial ID 'TEST-12345' from 'John Doe' has been successfully approved and is now live on your configured widgets. Should I notify the team? ``` ## Capabilities ### Audit Social Proof Health Get a quick summary of total reviews, widget activity, and overall social proof status. ### List All Reviews Retrieve a complete list of every testimonial collected in the account. ### Find Specific Content Search through all reviews using customer names or specific keywords. ### Check Pending Approvals Identify which testimonials are waiting for human review and approval. ### Track Website Widgets List all display widgets, like the 'Wall of Love' or site badges, configured across your properties. ## Use Cases ### Checking for New Content A content creator needs fresh material for an email campaign. They ask their agent to use `list_latest_testimonials` and then follow up with `search_testimonials_by_keyword` to pull three quotes mentioning 'support' or 'ease of use'. ### Board-Level Oversight The operations lead needs a quick status report. They run the `quick_social_proof_audit` tool, getting an immediate summary of review health and widget coverage without needing to access multiple dashboards. ### Batch Approval Workflow A marketing manager has gathered 15 new reviews. Instead of opening them one by one, they ask their agent to check `list_pending_testimonials`, review the batch, and then use `approve_pending_testimonial` for all 15. ### Debugging Widget Issues A developer notices a widget is missing on one property. They run `list_account_properties` to confirm the brand ID and then check `list_display_widgets` to ensure the correct widget type is assigned. ## Benefits - Stop manually checking the status of reviews. Use `list_pending_testimonials` to pull a list of all unapproved content, letting your agent handle the review queue right in conversation. - Instantly audit your entire social proof setup with `quick_social_proof_audit`. You get an immediate health check on your widget usage and overall volume without running multiple reports. - Need a specific quote for copy? Instead of searching through massive spreadsheets, run `search_testimonials_by_keyword` to find relevant customer names or phrases instantly. - Maintain data integrity by knowing exactly what's live. Use `list_display_widgets` and `list_account_properties` together to map which brands have which specific widgets deployed. - Make published reviews go live immediately. When a testimonial is ready, calling `approve_pending_testimonial` ensures it appears on the site without human delay. ## How It Works The bottom line is, it gives your AI client a single point of contact to handle complex social proof tasks without needing multiple logins or manual API calls. 1. Connect this MCP to your preferred AI client and authorize it using your Endorsal API Key. 2. Tell your agent what you need—like 'List all pending testimonials' or 'What widgets are configured for the main site?' 3. The system executes the request, returning structured data about reviews, widget IDs, and approval statuses. ## Frequently Asked Questions **How do I use `list_all_testimonials`?** Calling `list_all_testimonials` retrieves every testimonial ever collected in the account. Use this when you need a complete audit or a full dataset for research. **What is the difference between `list_latest_testimonials` and `list_pending_testimonials`?** These tools track different states of content. `list_latest_testimonials` shows what just came in, while `list_pending_testimonials` shows what needs review before it's published. **Can I check widget status without knowing the property ID?** You can run `quick_social_proof_audit` for a high-level overview. If you need details, first call `list_account_properties` to get all available IDs. **How does `approve_pending_testimonial` work?** `approve_pending_testimonial` takes the ID of a review and changes its status to 'live.' This action makes the testimonial visible on your configured websites immediately. **How do I check my API quota using `get_endorsal_account_metadata`?** It retrieves your current usage count and defined limits. Checking this first prevents unexpected rate limit errors when you're running large operations across many records. **What information does `get_testimonial_details` provide for a specific piece of feedback?** It returns the full text, associated metadata, and all details about one testimonial. This gives you granular control over exactly what content is being displayed or reviewed. **How does `list_account_properties` help me manage multiple websites or brands?** It lists every website or brand property tied to your Endorsal account. This confirms the scope of management and ensures you know exactly where social proof is configured across all your digital assets. **Can I find a specific testimonial using `search_testimonials_by_keyword`?** Yes, you search by customer name or any keyword within the text. This lets you pinpoint relevant feedback quickly without having to scroll through every single recorded testimonial. **How do I get an Endorsal API Key?** Log in to your Endorsal dashboard, navigate to **Account > API**, and you can generate or retrieve your unique API Key from there. Ensure you have an active plan that supports API access. **Can the agent approve testimonials?** Yes, you can use the approve_pending_testimonial tool to change the status of any pending review to 'Approved' directly via the agent. **Does the integration show customer photos?** You can retrieve testimonial metadata using the get_testimonial_details tool. While it provides image URLs and details, the actual photos are best viewed within the Endorsal dashboard or live widgets.