# Refiner MCP for AI Agents AI Agent Connect > Refiner MCP lets you manage your customer feedback loops directly through your AI client. It handles in-app surveys, NPS scores, and user segments so you can spot churn signals or feature requests without digging through a dashboard. You can quickly summarize sentiment, identify at-risk users, and monitor your survey health in one place. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_oZTOqi44qYgTigtg1YbvsSD1RxDyuO25XsEYbPFL/ai-agent-connect - **Tags:** customer-feedback, nps-surveys, user-insights, churn-analysis, micro-surveys, data-collection ## Description Refiner lets you connect your customer feedback account to your AI agent to simplify how you collect in-product insights and monitor user sentiment. Instead of hunting through a dashboard to find out why users are dropping off, you can just ask your agent to do the heavy lifting. This Connector lets you pull survey responses, check user segments, and monitor your survey health through a simple chat. You can see which users are hitting friction points and what they're saying about your features in real time. It turns your feedback loop from a passive dashboard into an active conversation. Since Vinkius hosts this Connector, you can use it across your favorite tools like Claude, Cursor, or Windsurf. It's about getting straight to the answers without the manual data entry or constant tab switching. You can get a pulse on your product's health without leaving your workspace. You can quickly see which segments are responding to your latest updates and which users are most likely to churn based on their recent scores. It takes the manual work out of data analysis so you can focus on making actual product improvements. ## Tools ### list_refiner_contacts List product contacts. Retrieve a list of all your product contacts to manage your outreach efforts. ### identify_refiner_user Identify or update user traits. Use this to keep your user data current and ensure your surveys target the right people. ### list_refiner_responses List survey responses. This lets you pull the latest feedback submissions directly into your conversation for analysis. ### list_refiner_segments List user segments. Use this to see exactly who is in your various audience groups and how they are distributed. ### check_refiner_status Check API Status. Verify that your connection is active and your data is flowing correctly without checking a dashboard. ### list_refiner_surveys List feedback surveys. Quickly see all your active in-app, email, and link surveys in one simple list. ### track_refiner_event Track user event. Log specific actions like clicks to trigger your micro-surveys at the perfect moment in the user journey. ### get_refiner_contact Pull contact details for a specific user. This helps you quickly find the right person to reach out to based on their feedback. ## Prompt Examples **Prompt:** ``` What's the general sentiment from our NPS survey this week? ``` **Response:** ``` I've analyzed the latest **NPS - Post Checkout** responses. Here is the summary: * **Average Score:** 8.4 / 10 * **Top Positive:** Users love the "speed of delivery." * **Top Complaint:** Some users mentioned the checkout page feels slightly cluttered. Would you like me to pull the specific text for the low scores? ``` **Prompt:** ``` Who are our 'Power Users' and what were their last survey comments? ``` **Response:** ``` I've retrieved the **Power User** segment. Here are the 3 most recent comments from that group: 1. "The new dashboard is exactly what I needed." (Score: 10) 2. "Can we get more export options?" (Score: 9) 3. "Great tool, but I'd love a dark mode." (Score: 8) I can also list all users in this segment for you. ``` **Prompt:** ``` Track a 'Clicked Upgrade' event for user mike@example.com. ``` **Response:** ``` Done! I've logged the **Clicked Upgrade** event for **mike@example.com**. Since you have a micro-survey targeted to this event, it will now be triggered for the user automatically. ``` ## Capabilities ### List all active surveys See all your current in-app and email surveys and their response counts in one list. ### Filter specific survey responses Query specific feedback submissions using date ranges or unique IDs to find trends. ### Update user traits and IDs Identify users and update their technical traits to ensure your surveys hit the right audience. ### Track real-time user actions Log specific user events to trigger perfectly timed micro-surveys via your agent. ### Query user segments List and query defined audience segments to understand your user distribution. ### Check API connection status Verify your account configuration and API health directly through your AI client. ## Use Cases ### Identifying churn risks A product manager asks the agent to find users who gave an NPS score below 5. The agent uses `list_refiner_responses` to find those users and summarizes their complaints so the team can reach out immediately. ### Segment validation A growth lead wants to see if the 'Beta Testers' segment is actually active. They ask the agent to list segments and check recent activity for those users to see if the targeting is working correctly. ### Event-based survey triggers A dev wants to know if an event is tracking correctly. They ask the agent to log a 'Clicked Upgrade' action using `track_refiner_event` to ensure the survey triggers at the right moment. ### Survey health check A marketing manager wants to ensure all survey links are live. They ask the agent to list all active surveys and check the status to ensure the feedback loop is running without any issues. ## Benefits - Get instant survey results without opening a browser. Use `list_refiner_surveys` to see what's live and get response counts for every active survey in your account instantly. - Identify at-risk users quickly. Use `identify_refiner_user` to update user traits on the fly based on their behavior and sentiment scores to keep your data current. - Analyze specific user actions. Use `track_refiner_event` to see what triggers your surveys and where users click within your product to optimize your survey timing. - View your audience distribution. Use `list_refiner_segments` to see exactly who is in which group and how they are distributed across your user base in real time. - Verify your account health. Use `check_refiner_status` to ensure your API connection is active and your data is flowing correctly without any manual checking. - Pull contact info directly. Use `get_refiner_contact` and `list_refiner_contacts` to manage your reachout list and see user details without switching tabs. ## How It Works The bottom line is you can manage your entire customer feedback loop using natural language instead of manual dashboard navigation. 1. Subscribe to the Refiner MCP on the Vinkius marketplace. 2. Enter your Refiner API Key into your AI client settings. 3. Ask your agent to list surveys, pull responses, or check user segments. ## Frequently Asked Questions **Can I use Refiner MCP to see my NPS scores?** Yes, you can ask your agent to pull the latest NPS scores and summarize the feedback. It pulls the raw data so you don't have to open the Refiner dashboard. **How does Refiner MCP help with churn?** You can ask the agent to find users who gave an NPS score below 5. It helps you spot these people faster so you can reach out. **Can I update user info with Refiner MCP?** You can tell your agent to identify or update user traits. This makes it easy to keep your user data current while you're chatting with your agent. **Will Refiner MCP show me all my surveys?** Yes, your agent can list every in-app and email survey you have active. You can then ask for details on any specific one. **Is Refiner MCP good for tracking events?** You can use it to log user actions like clicks or signups. This helps you trigger surveys at the right moment in the user journey. **How do I get started with Refiner MCP?** You just need to subscribe on Vinkius and add your API key. From there, you can start asking questions about your feedback data. **Can I check the responses for a specific survey via AI?** Yes! Use the `list_refiner_responses` tool and provide the Survey UUID. Your agent will retrieve the latest submissions, which you can then ask the AI to summarize or filter by date. **How do I identify a user and add custom traits using the agent?** Use the `identify_refiner_user` action. Provide the User ID or Email and a JSON string of `traits` (e.g., '{"plan":"pro"}'). This helps you target surveys based on specific user metadata. **Is it possible to track a custom event to trigger a survey via AI?** Absolutely. Use the `track_refiner_event` tool. Provide the event name and the user's ID/Email. When this event is logged, Refiner will trigger any surveys you have configured for that specific action.