# Alchemer MCP MCP > Alchemer MCP manages your entire survey and feedback workflow directly through conversation. It lets you list, audit, and retrieve data for surveys, questions, responses, and contact lists without touching the Alchemer platform interface. You get real-time access to structured customer insight data—from checking account usage metrics to pulling specific user submissions. ## Overview - **Category:** customer-support - **Price:** Free - **Tags:** feedback-management, survey-design, customer-insights, data-collection, response-analysis, reporting ## Description Need to understand what customers are saying? This MCP connects your agent to Alchemer for professional survey management. Instead of navigating complex dashboards, you talk to your AI client and it handles the feedback lifecycle. You can audit entire surveys, check question metadata, or pull detailed reports just by asking. For example, if a Product Manager wants to see feature feedback on a specific topic, they don't copy-paste IDs; they ask for it, and the agent retrieves the data instantly. This type of capability is what makes Vinkius the best place to find specialized connectors—it keeps all your operational tools in one catalog. It handles everything from listing active surveys to retrieving granular responses so you can analyze sentiment trends on the fly. ## Tools ### list_surveys Retrieves a list and basic details for every survey in the account. ### get_survey_details Retrieves technical metadata and status for a specific survey ID. ### list_survey_questions Lists every question defined within your account's surveys. ### get_question_details Retrieves technical metadata for a specific survey question. ### list_survey_responses Lists summaries of all submissions made to your surveys. ### get_response_details Pulls the full data record and content from an individual submission. ### list_survey_reports Retrieves a list of saved survey reports and their status. ### list_survey_campaigns Lists all active or past survey distribution campaigns. ### list_contact_lists Lists available contact lists used for targeted distribution campaigns. ### get_account_usage Checks your Alchemer account status and usage metrics. ## Prompt Examples **Prompt:** ``` List all active surveys in my Alchemer account. ``` **Response:** ``` I've retrieved your surveys. You have 8 active surveys, including '2026 Customer Satisfaction', 'Product Market Fit', and 'Event Feedback'. Would you like to see the response count for any of them? ``` **Prompt:** ``` Show me the last 5 responses for survey ID 1234567. ``` **Response:** ``` I've retrieved the latest 5 responses for survey 1234567. 4 are 'Complete' and 1 is 'Partial'. Would you like me to analyze the data for specific questions in these responses? ``` **Prompt:** ``` List all questions in the 'Customer Satisfaction' survey. ``` **Response:** ``` I've retrieved the question list for your Customer Satisfaction survey. It contains 15 questions, including 'Net Promoter Score (NPS)', 'Feature Rating', and 'Open Feedback'. Would you like to see the technical settings for the NPS question? ``` ## Capabilities ### Audit Survey Structures You list and get metadata for specific surveys or question sets, checking their status before deployment. ### Retrieve Specific Responses The agent pulls individual or aggregated survey responses, allowing you to analyze what people actually submitted. ### Manage Distributions and Contacts You list contact lists, view available distribution campaigns, and monitor overall account usage limits. ### Generate Reports and Insights The agent pulls data from various sources to help you audit existing survey reports and track campaign performance. ### Get Question Details You retrieve technical metadata for any individual question within a surveyed structure. ## Use Cases ### Auditing a new product launch flow A Product Manager needs to confirm that all intended feedback points are captured. They ask the agent to `list_survey_questions` for the 'Q4 Launch' survey and then follow up with `get_question_details` on the NPS question. This confirms the data structure is ready before launching. ### Investigating a sudden drop in submissions A CX Lead notices a dip in response volume. They use `list_survey_responses` to check submission counts across all surveys, then review `list_campaigns` to verify if the distribution email was sent correctly. ### Data prep for external analysis A Data Analyst needs a clean sample of data. They use `list_surveys` to find the target survey ID, then call `list_survey_responses`, and finally ask for specific records using `get_response_details` so they can export structured data. ### Reviewing quarterly performance A Market Researcher needs a high-level overview of feedback. They request the status of reports using `list_survey_reports`, then use `get_account_usage` to check if their account has hit any rate limits before pulling the final data. ## Benefits - Stop clicking through tabs. Instead of manually listing surveys and then fetching details for each one, you use `list_surveys` followed by specific queries to get exactly what you need in a single conversation flow. - You eliminate the need to jump between multiple apps just to check data integrity. Need to know if your contact list is up-to-date? Just call `list_contact_lists` and verify it's ready for distribution campaigns. - When you need deep dives, you don't guess. Using `get_response_details` lets you pull the full, raw data record for a submission right into your chat window for immediate analysis. - Track your progress with confidence. You can use `list_survey_reports` to see if a report exists and what its status is, so you aren't wasting time trying to run an outdated job. - The agent handles the heavy lifting of data context switching. It lets you audit survey questions using `list_survey_questions` without needing to manually navigate the Survey Editor. ## How It Works The bottom line is that it turns complex, multi-tab administrative tasks into simple conversational commands. 1. First, subscribe to this MCP and provide your Alchemer API Token, Secret, and Region. 2. Next, you reference the functionality by telling your AI client what data you need—for example, 'List all active surveys.' 3. The agent executes the necessary tool calls against Alchemer and returns structured data directly in chat. ## Frequently Asked Questions **How do I check if my account has hit usage limits using the Alchemer MCP?** You run `get_account_usage`. This tool checks your current operational status and helps you monitor rate limits so you don't lose data access mid-analysis. **What is the difference between listing surveys and getting survey details using Alchemer MCP?** Using `list_surveys` gives you a summary list of all your active surveys. You must run `get_survey_details` afterward to pull specific metadata, like creation dates or technical status. **Can I find out what questions were used in an old survey using Alchemer MCP?** Yes. First, use `list_surveys` to identify the correct survey ID. Then, call `get_survey_details` and follow up with `list_survey_questions` for a complete inventory. **I need to analyze specific customer feedback; what tool should I use?** Run `list_survey_responses` first. This gives you the summary list of submissions, and then use `get_response_details` with a specific ID to pull all the raw data for deep analysis. **What specific information does `list_survey_campaigns` provide about my distribution efforts?** It lists all active or past survey campaigns. You can see key details like the campaign name, target dates, and the overall status of the distribution effort. **If I need to check which groups of people are targeted, how do I use `list_contact_lists`?** It retrieves a list of all saved contact segments in your account. This allows you to know exactly which predefined lists you can target when sending surveys. **Can I check the technical metadata for a specific survey using `get_survey_details`?** Yes, this tool provides deep metadata on any single survey. You get details like its creation date, status (active/inactive), and overall configuration structure. **How can I see what types of analysis are available by using `list_survey_reports`?** This tool lists all the generated reports linked to your account. It lets you check report names, their generation date, and whether they're ready for download or still processing. **How do I find my Alchemer API Token and Secret?** Log in to Alchemer as an admin, navigate to **Account** > **Integrations** > **API Access**. You can generate and copy your `api_token` and `api_token_secret` there. **Which region should I choose?** Choose the region based on your account's data center: **US** (api.alchemer.com), **EU** (api.alchemer.eu), or **CA** (api.alchemer.ca). **Can I retrieve responses for a specific survey?** Yes! Use the `list_survey_responses` tool and provide the Survey ID. Your agent will retrieve the latest submissions, including timestamps and completion status.