# Wootric MCP

> Wootric manages customer feedback by letting your AI agent query survey scores and user profiles directly. Track Net Promoter Score (NPS), Customer Satisfaction (CSAT), and detailed comments to pinpoint exact pain points in your product or service. You'll get a real-time view of end user sentiment, declining users, and full feedback history without exporting CSVs.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** nps, customer-experience, feedback-management, csat, survey-analysis

## Description

Wootric connects customer experience data directly into your agent. Instead of logging into the platform to pull reports, you can ask your AI client questions about customer sentiment—like 'What was the average NPS score last month?' or 'Show me all responses from users who complained about billing.' The system pulls those answers immediately.

This MCP lets you manage everything from user records and project setups to specific survey comments. Whether you need to update a user's profile, create a new response, or find out why a user declined the survey, your agent handles it. Because this data involves sensitive customer IDs and credentials, every connection passes through Vinkius’s zero-trust proxy. This means your keys are only used in transit—they never sit on a disk. You get deep visibility into who said what, when they said it, and why.

## Tools

### update_project
Makes changes to the settings or details of a specified project.

### update_response
Modifies an already recorded survey response, perhaps correcting a score or comment.

### update_tag
Updates the name or properties of a specific tag used for categorization.

### create_decline
Marks an end user record as having declined a survey.

### create_end_user
Creates a brand new customer profile in the system.

### create_import
Initiates the process of uploading bulk data into Wootric.

### create_project
Sets up a new project container for organizing feedback and campaigns.

### create_response
Records a new survey response score and comment for an end user.

### create_tag
Creates a new classification tag to categorize feedback data.

### delete_decline
Removes a decline record associated with an end user.

### delete_end_user
Permanently removes a customer profile from the system.

### delete_response
Deletes a specific survey response record.

### delete_tag
Removes an existing classification tag.

### get_end_user
Retrieves all custom properties and data for a single, specific end user by their ID.

### list_declines
Pulls a list of every decline record across the entire platform.

### list_end_user_responses
Gets all recorded survey responses tied to one particular end user ID.

### list_end_users
Provides a comprehensive list of every active customer profile in the system.

### list_projects
Retrieves all currently active projects set up within Wootric.

### list_responses
Gathers a list of every survey response submitted across the entire platform.

### list_tags
Shows all existing tags used to categorize feedback data.

### onboard_cxi
Activates account features required for Customer Experience Intelligence (CXI).

### update_end_user
Modifies specific data points or custom properties on an existing end user profile.

## Prompt Examples

**Prompt:** 
```
List the most recent end users from Wootric.
```

**Response:** 
```
I've retrieved the end users. Here are the latest profiles, including 'customer_99' (ID: 12345) and 'user_alpha' (ID: 67890). Would you like to see the details for one of them?
```

**Prompt:** 
```
Show me all survey responses for user ID 12345.
```

**Response:** 
```
User 12345 has submitted 2 responses. The latest was an NPS score of 9 with the comment: 'Great service!'. The previous one was a score of 7.
```

**Prompt:** 
```
Create a new survey response for user 67890 with a score of 10 and the text 'Amazing experience'.
```

**Response:** 
```
Successfully created the response for user 67890. The score of 10 and your comment have been recorded in Wootric.
```

## Capabilities

### Manage Customer Accounts
You can create new user profiles or pull lists of all existing users to keep your internal CRM data current.

### Analyze Survey Scores and Comments
Query specific survey results, including NPS or CSAT scores, across multiple users in real time.

### Track Feedback History
Retrieve all past feedback for a single user, giving you the full context before any call or meeting.

### Handle Survey Declines
Monitor and manage which users declined to take a survey, helping refine your outreach strategy.

## Use Cases

### The CSM needs context before a call.
A Customer Success Manager is about to call 'user_alpha'. Instead of spending 15 minutes digging through old reports, they ask their agent: 'What's user_alpha’s feedback history?' The agent runs `list_end_user_responses` and provides the last three scores and comments immediately.

### The PM needs to prove a feature is needed.
A Product Manager wants to convince leadership that they need to fix the billing screen. They ask their agent to pull all responses mentioning 'billing' or 'invoice'. The tool runs `list_responses` and surfaces dozens of specific comments, backing up the roadmap change.

### The Data Analyst needs a clean list of targets.
A marketing analyst needs to run an outreach campaign only on users who haven't responded yet. They ask the agent to pull all records from `list_declines`, getting a clean, actionable list for their team.

### The Support Team needs to update user data.
A support technician discovers that 'customer_99' has outdated company details. They ask the agent to use `update_end_user` with the new information, ensuring the CRM is immediately correct.

## Benefits

- Stop guessing about user pain points. You can pull a full history for any single customer using `list_end_user_responses`, letting your agent analyze their journey before you even talk to them.
- Keep your product roadmap grounded in reality. By querying survey comments and scores, Product Managers use this data to prioritize fixes based on real user pain points, not gut feeling.
- Manage your entire customer database from one place. You can pull a list of every active user using `list_end_users` or update their properties with `update_end_user`, keeping your internal CRM in sync instantly.
- Never lose track of who needs outreach. Use `list_declines` to see which users haven't responded, helping you adjust your sampling strategy and focus efforts where they count.
- Build custom reports without manual work. The ability to query all responses using `list_responses`, or filter them by project using `list_projects`, lets Data Analysts build complex views on the fly.

## How It Works

The bottom line is your agent becomes an instant analyst for all your customer feedback data.

1. Start by subscribing to the Wootric MCP using your access token.
2. Your AI agent then uses the exposed tools—like `list_end_users` or `get_end_user`—to pull specific customer data, project details, or response history.
3. The agent returns clean, structured data that you can use directly in conversation to build reports or make decisions.

## Frequently Asked Questions

**How do I check a user's past feedback with the Wootric MCP?**
You use `list_end_user_responses` and provide the specific end user ID. This pulls all their recorded scores and comments, giving you immediate context for any conversation.

**What if I want to update a customer's details?**
You use `update_end_user`. This lets your agent modify custom properties on an existing user profile without having to delete and re-create the whole record, keeping your data clean.

**Can I get all current users using the Wootric MCP?**
Yes. The tool `list_end_users` provides a complete list of every active user in your system. This is useful for running bulk checks or updates across your entire client base.

**What's the best way to categorize comments?**
You first create the category using `create_tag`, and then you can use other tools to link responses to that tag. This keeps your feedback data organized for easier reporting.

**When should I use the `delete_end_user` tool in Wootric?**
You run this when you need to remove a user record entirely. This function handles complete data removal for compliance or cleanup purposes, ensuring that associated profiles are purged from your system.

**If I gather survey results manually, how do I use the `create_response` tool?**
You pass the necessary user ID, score, and comment text directly to this function. It records brand new feedback entries in Wootric without requiring a physical survey submission.

**Do I need to use the `list_projects` tool if my feedback is tied to specific campaigns?**
Yes, using `list_projects` lets you see all active campaign containers. You must know the project scope before attempting to associate any responses or updates with them.

**What kind of token do I need for this Wootric MCP integration?**
You require a dedicated Wootric Access Token, which you provide during the setup process. This key grants your agent permission to read and write data across all available tools.

**How can I see all feedback provided by a specific customer?**
You can use the `list_end_user_responses` tool by providing the user's ID. This will return all survey scores and comments associated with that specific end user.

**Is it possible to update a customer's custom properties through the agent?**
Yes, the `update_end_user` tool allows you to modify an existing user's email, external ID, and custom properties hash.

**What happens when I delete an end user?**
When you use the `delete_end_user` tool, the user is scheduled for deletion. Wootric processes these requests the next day at 7 AM UTC.