# Wenjuanxing MCP MCP > Wenjuanxing / 问卷星 MCP connects your AI agent directly to China's leading online survey platform. It lets you manage entire research lifecycles: creating new questionnaires, listing active surveys, pulling raw response data for auditing, and generating detailed quantitative statistics and summary reports—all via natural conversation. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** questionnaire-design, data-collection, response-auditing, market-research, voting-systems, form-automation ## Description Wenjuanxing gives your agent the ability to handle complex data gathering operations that normally require navigating a dozen web pages. You can ask it to list all existing surveys or check the metadata on specific groups of questionnaires. Need to know how many people responded? It retrieves real-time response counts, and if you need deep dive stats for a particular question set, your agent gets those quantitative figures immediately. Furthermore, you can instruct it to create a brand new survey structure from scratch or update the status of an existing one, like publishing it or pausing collection. The entire process—from listing all questionnaires using `list_surveys` to pulling raw data via `list_responses` and summarizing findings with `get_report`—is managed by your agent talking to this MCP. Because every interaction happens within Vinkius, you get full visibility into what the AI is doing. Vinkius AI Analytics tracks exactly which tools are called, what data moves through the system, and how much of your budget is used. It keeps all your research activity auditable. ## Tools ### create_survey Builds a brand-new questionnaire structure in the system. ### get_account_info Retrieves general metadata about your Wenjuanxing account setup. ### get_report Generates a high-level summary report of the survey results. ### get_stats Pulls specific quantitative statistics for the questionnaire data. ### get_survey Retrieves detailed structural information and metadata about a single survey. ### list_groups Lists different organizational folders or groups within your account setup. ### list_responses Pulls a list of actual completed submissions for auditing purposes. ### list_surveys Retrieves the names and status of all questionnaires in your account. ### query_surveys Searches for specific questionnaires using keywords or filters. ### update_survey_status Changes the active status of a survey, such as publishing it or setting it to draft. ## Prompt Examples **Prompt:** ``` List all active surveys in my Wenjuanxing account. ``` **Response:** ``` I've retrieved your questionnaires. You have 8 active surveys, including 'Customer Satisfaction 2026' and 'Product Feedback - V2'. Would you like to check the response count for any of them? ``` **Prompt:** ``` Show me the responses for survey activity '8821'. ``` **Response:** ``` I've retrieved the responses for survey 8821. There are 150 completed submissions. Would you like to see the details of the most recent ones or generate a summary report? ``` **Prompt:** ``` What are the statistics for questionnaire '9920'? ``` **Response:** ``` I've retrieved the quantitative statistics for survey 9920. For question 1, 65% of respondents selected 'Highly Satisfied'. For question 2, the average rating is 4.2/5.0. Should I retrieve the full report? ``` ## Capabilities ### List all available surveys The agent retrieves a list of questionnaires you've created or access. ### Get the structure and details of any survey It pulls up the full metadata for a specific questionnaire, showing its setup details. ### Monitor real-time response counts The agent retrieves current participation numbers to track engagement levels. ### Get raw participant responses You can pull a list of actual submissions, useful for auditing individual answers. ### Generate quantitative statistics and summaries It processes the collected data to provide statistical breakdowns and high-level reports. ### Manage survey content status The agent can change a questionnaire's operational state, like publishing or pausing it. ## Use Cases ### Auditing an employee engagement survey. The HR Manager needs to audit the qualitative comments from last month's feedback. Instead of downloading hundreds of records, they ask their agent to use `list_responses` and then follow up with a specific query for those raw data points. ### Quickly checking market research progress. A Marketing Lead wants to know which surveys are ready for launch. They instruct the agent to call `list_surveys` first, then use `get_survey` on a specific result to verify its metadata and readiness. ### Compiling quarterly performance metrics. The analyst needs aggregated data across multiple channels. They ask the agent to get survey statistics (`get_stats`) and then use `get_report` to synthesize a final, executive-ready summary report. ### Launching an urgent feedback mechanism. A team needs immediate input on a prototype. They instruct the agent to execute `create_survey`, define the structure, and then use `update_survey_status` to set it live immediately. ## Benefits - Stop manually logging into the platform. Your agent can list all surveys and check their status using `list_surveys` or `query_surveys`, giving you a full overview instantly. - Audit participant behavior by pulling records with `list_responses`. You get the raw data needed to see exactly who answered what, which is essential for deep dives. - Go beyond simple counts. Use `get_stats` to pull quantitative breakdowns and use `get_report` to synthesize high-level summary findings without writing complex queries. - Need a new survey? You can bypass the UI entirely by using `create_survey`, letting your agent build out entire data collection tools on command. - Don't let outdated information sink your project. Use `update_survey_status` to make sure surveys are active, published, or paused correctly before you run any analysis. ## How It Works The bottom line is that your research workflow moves from clicking through dashboards to asking direct questions. 1. Connect your credentials and authorize the Wenjuanxing App ID and App Key to this MCP. 2. Tell your AI client what you need. For example: 'What are the statistics for my Q3 employee survey?' 3. The agent calls the necessary tool, pulls the data, and delivers a plain-language answer. ## Frequently Asked Questions **How do I check which questionnaires are available using list_surveys?** You simply tell your agent to call `list_surveys`. It pulls a clean list of all the questionnaire names and their current status in your account. **Can I use get_stats to see basic numbers only?** Yes. If you only need quantitative breakdowns, asking for `get_stats` is faster than requesting a full report. It pulls the core numerical data points immediately. **What if I want to change a survey's status? Do I use update_survey_status?** That’s right. The `update_survey_status` tool lets you manage the lifecycle of a questionnaire, whether that means publishing it for responses or pausing collection. **Can I find my survey if I don't remember the name? Use query_surveys.** The `query_surveys` tool lets you search your questionnaires by specific keywords. This is faster than scrolling through a long list. **If I need the raw answers for every submission, should I use list_responses?** Yes, this tool retrieves a listing of all individual responses. You get the full text and data for each submission record. This lets you manually audit specific answers or run custom analysis outside the platform. **How do I check the detailed structure or fields of an existing questionnaire? Use get_survey.** It returns the comprehensive metadata for a given survey ID. You can see every question type, field name, and setting. This is crucial for understanding exactly what data you'll pull when running reports. **If I want to create a brand new questionnaire from scratch, do I use create_survey?** It successfully initiates the form creation process in your account. After calling it, the survey exists and receives an ID. You then need to populate that structure with questions. **When should I use get_report instead of get_stats for my analysis?** Use `get_report` when you need a deep summary document, not just basic counts. It generates high-level, narrative insights and detailed analytics across the entire dataset. **How do I find my Wenjuanxing App ID and Key?** Log in to your Wenjuanxing account (Enterprise/Flagship version), go to the Open API Platform (openapi.wjx.cn) or check the 'API/SSO' section in your user settings to find your App ID and Key. **Can I see quantitative statistics for survey questions?** Yes. Use the `get_stats` tool with your activity ID to retrieve counts and percentages for each answer option in your survey. **Is it possible to search questionnaires by keyword?** Yes! You can use the `query_surveys` tool to find specific questionnaires in your account based on their title or activity keyword.