# KnoCommerce MCP > KnoCommerce analyzes post-purchase surveys, giving you deep insights into customer feedback and sales attribution. This MCP lets your AI client audit individual responses, build full buyer profiles, and track which marketing channels actually drive purchases. Use it to turn raw survey data into actionable e-commerce reports. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** post-purchase-survey, customer-feedback, attribution-tracking, customer-insights, survey-analysis ## Description Need to know why customers are leaving reviews? This connector pulls all the necessary data from KnoCommerce so you can analyze post-purchase surveys directly through your AI agent. Instead of manually exporting and cross-referencing spreadsheets, your agent handles the heavy lifting. You can list and audit active survey campaigns or drill down into a single customer's feedback history to build a complete profile. It’s also great for seeing which marketing efforts actually work; you can pull an attribution report that shows exactly where buyers came from. When setting this up, just connect your preferred AI client through the Vinkius Marketplace and start asking questions in natural language. Your agent handles the connection and the complex data mapping. ## Tools ### list_surveys Returns a list of every active and archived survey campaign ID within KnoCommerce. ### get_survey_details Provides high-level information, like the title and status, for any given survey campaign. ### list_survey_responses Gets a list of responses from surveys, optionally filtering by a campaign ID. ### get_response_details Fetches the specific content of a single customer response submission. ### list_knocommerce_customers Lists buyer accounts that have submitted data to surveys, allowing you to cross-reference feedback with user IDs. ### get_customer_feedback_profile Retrieves all available feedback details linked to a specific buyer ID. ### list_survey_questions Shows all the questions included in a specific survey, which is useful for understanding the response format. ### get_channel_attribution_report Generates a report showing which marketing channels are most responsible for bringing in customers. ### list_survey_templates Displays all ready-to-use templates so you know what kinds of feedback campaigns are available. ### check_knocommerce_api_status Verifies if the connection between your client and KnoCommerce is currently working. ## Prompt Examples **Prompt:** ``` List all active surveys in my KnoCommerce account ``` **Response:** ``` I've found 3 active surveys: 'Post-Purchase General', 'Holiday Special Feedback', and 'Product Fit Research'. Which one would you like to examine? ``` **Prompt:** ``` Show me the latest responses for survey 'kc_123' ``` **Response:** ``` Retrieving responses for 'kc_123'… I've found 15 recent submissions. The overall sentiment seems positive, with most users mentioning 'Fast Shipping' as the primary reason for purchase. ``` **Prompt:** ``` Give me a channel attribution report ``` **Response:** ``` The attribution report shows that 45% of your customers found you via 'Instagram Ads', 20% through 'Direct Search', and 15% from 'Email Marketing'. ``` ## Capabilities ### Audit specific customer feedback Your agent can pull all feedback details for a single buyer or track their full history across multiple surveys. ### Determine marketing channel performance You get an aggregated report showing which campaigns (like Instagram Ads or email) are responsible for the most customer acquisitions. ### Identify active survey campaigns The MCP lists all available surveys, helping you track your feedback collection strategy across different product lines. ### Understand response data structure You can list every question within a specific survey to understand the exact format of the answers you're getting back. ### Track customer records Your agent lists all customers associated with survey submissions, helping you correlate feedback to a specific user ID. ## Use Cases ### Investigating a poor quarterly sales period The analyst asks the agent for an attribution report and then correlates that list with feedback data. They use get_channel_attribution_report combined with get_customer_feedback_profile to prove that customers from 'Email Marketing' are leaving negative reviews about shipping. ### Preparing for a product update launch The Product Owner needs input on the last six months of feedback. They use list_surveys and then run list_survey_responses to gather all relevant data before meeting with stakeholders, skipping manual data gathering. ### Understanding survey gaps A team member notices a key piece of information is missing from responses. They use list_survey_questions first, then work with the Product Owner to add that question via the KnoCommerce dashboard. ### Auditing a specific high-value client A sales manager needs to know everything about one key buyer. They use list_knocommerce_customers to find the ID, and then get_customer_feedback_profile to summarize all past purchases and complaints. ## Benefits - You stop guessing. By running the get_channel_attribution_report tool, you immediately know if your Instagram Ads budget is actually translating into paying customers. - Build full buyer pictures: Use get_customer_feedback_profile to gather every piece of feedback for a single user ID. This context is critical for product improvements. - Avoid data silos. Instead of exporting multiple sheets, asking the agent to list_survey_responses lets you see all submitted reviews in one go, grouped by campaign. - Save time on setup: The list_survey_templates tool helps your team quickly decide which feedback mechanism to use next without manual research. - Deep dive into data structure: If a response seems weird, running list_survey_questions clarifies exactly what kind of answer the survey is designed to receive. ## How It Works The bottom line is you give your agent a question, and it handles connecting to KnoCommerce to get the raw answers back. 1. First, get your API key from the KnoCommerce dashboard. 2. Next, connect this MCP in your favorite AI client (like Cursor or Claude). 3. Finally, use natural language to ask questions—for instance, 'Show me all survey templates'—and let your agent retrieve the data. ## Frequently Asked Questions **How do I see what kind of feedback a customer gave?** You use get_customer_feedback_profile. This tool pulls all available details associated with that specific buyer ID, giving you their complete history. **Can I find out where my customers came from using get_channel_attribution_report?** Yes, this report gives you the percentages for various marketing channels. It shows exactly which source drove customer acquisition. **How do I list all available surveys in KnoCommerce?** You run list_surveys. This tool returns a master list of every survey campaign ID, allowing you to select the right set of data for analysis. **What is the difference between list_survey_responses and get_response_details?** list_survey_responses gives you a grouped list of submissions. You use get_response_details when you need to pull the full, specific text content for just one single response. **Do I need to check knocommerce_api_status first?** It's good practice to run check_knocommerce_api_status before starting a large analysis. It confirms the connection is live and ready for queries. **How can I use list_survey_questions to understand what data fields are available?** list_survey_questions shows you the full schema for a survey. It lets your agent know exactly which questions and types of answers to expect from customers, making interpretation reliable. **If I have a customer ID, how do I get_customer_feedback_profile details?** You provide the specific customer ID to get_customer_feedback_profile. This aggregates all historical survey submissions and feedback related only to that single buyer. **Where can I use list_survey_templates if I need a new campaign?** list_survey_templates returns a library of pre-built surveys you can launch. This helps you quickly select or adapt an existing template for your next feedback collection round. **Where do I find my KnoCommerce API Key?** Log in to your KnoCommerce dashboard and navigate to **Settings** > **API Keys**. You can generate a new REST API key there. **Can I see the individual questions of a survey?** Yes, use the `list_survey_questions` tool with the specific `survey_id` to retrieve all questions and their configuration. **Does this support creating new surveys?** The current version focus on data retrieval and analysis. You can list templates, but survey creation should be done in the KnoCommerce dashboard.