# AidaForm MCP MCP > AidaForm MCP connects your AI agent directly to your online survey platform. You can list every form you own, pull detailed analytics on completion rates, retrieve specific submission responses, and manage the entire lifecycle of your collected data using natural conversation. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** aidaform, forms-api, surveys-automation, data-extraction, leads-tracking, response-management, survey-orchestration, customer-feedback, mcp ## Description This MCP lets your AI client take control of everything related to your structured data collection. Forget logging into the AidaForm portal just to check for new leads or review survey results; you'll simply ask your agent, and it handles the heavy lifting. You can programmatically list all your high-fidelity forms, getting metadata on every quiz and survey setup. Need to clean up old records? The tool lets you delete specific submissions while maintaining database integrity. You also get access to analytics endpoints, allowing you to monitor form status and pull detailed responses in real time. Because this MCP is hosted on Vinkius, your agent can coordinate data collection across multiple sources without you ever leaving your primary development environment. ## Tools ### check_aidaform_status Verifies if your connection to AidaForm is active and working. ### create_form Builds a brand new form within the platform. ### delete_form Permanently removes an entire survey or form directory. ### delete_response Removes one specific, submitted answer to maintain data hygiene. ### export_responses Downloads all collected responses from a form or set of forms into a file format. ### get_form_analytics Pulls key performance metrics and statistics about how a form is performing. ### get_form Retrieves the complete structural details for one specific form. ### get_response Fetches the full, detailed content of one specific submitted answer. ### list_forms Lists all currently available forms across your account. ### list_responses Provides a list of IDs and basic information for multiple submitted answers. ### list_workspaces Shows the different organizational containers or workspaces you use within AidaForm. ### update_form Modifies settings, questions, or metadata on an existing form. ## Prompt Examples **Prompt:** ``` List all active forms in my AidaForm account. ``` **Response:** ``` I've retrieved your form directory. You currently have 5 active forms, including 'Lead Gen v2' (ID: 12345) and 'Customer Satisfaction'. Which one should we check for new responses? ``` **Prompt:** ``` Show the last 3 responses for form 'Lead Gen v2'. ``` **Response:** ``` Fetching responses... For form 12345, I've identified 3 recent submissions today, including @user1 and @user2. Would you like the high-fidelity detailed data for the most recent one? ``` **Prompt:** ``` Delete response ID '987' from form '12345'. ``` **Response:** ``` Response orchestrated! I've successfully deleted submission 987 from your specified form. The data hygiene operation is complete and no longer appears in your records. Need any other database actions? ``` ## Capabilities ### Inventory Forms Get a complete directory of every form and workspace in your AidaForm account. ### Manage Form Details View, create, or modify the structure and metadata of an existing survey. ### Retrieve Specific Data Points Pull detailed information for a single form's performance metrics or a specific submitted response. ### Batch Data Handling List many submissions together, export all collected data to a file, or delete individual responses from the database. ### Check Connection Health Verify that your MCP connection is active and functioning correctly. ## Use Cases ### Campaign Review After Launch A marketing manager needs to know how many people completed the 'Q3 Feedback' form. They ask their agent: 'What are the analytics for Form ID 456?' The agent uses `get_form_analytics` and returns a summary showing completion rates, drop-off points, and the total number of submissions. ### Data Cleanup for Compliance The HR team needs to delete three old, irrelevant employee feedback records. Instead of manually finding them in the GUI, they tell their agent: 'Delete response IDs 123, 456, and 789 from the Onboarding Survey.' The agent runs `delete_response` for each ID. ### Building an Integration Pipeline A developer needs to get all submitted leads into a custom CRM. They ask their agent: 'Export responses from all active forms and list the top 10 fields.' The agent uses `export_responses` and processes the data, making it ready for ingestion. ### Audit Trail Creation An analyst needs to check if a specific submission (ID: 99) was recorded correctly. They ask their agent: 'Show me the full details of response ID 99.' The agent executes `get_response` and returns the complete, structured data. ## Benefits - Stop manually logging into the portal. Instead, you ask your agent to 'list all active forms' and get an immediate inventory of everything using `list_forms`. - Don't guess how a campaign did. Use `get_form_analytics` to programmatically pull completion rates and key metrics for instant reporting without clicking through dashboards. - Need to clean up old data? You can issue commands to delete specific responses via `delete_response`, ensuring your database stays compliant and accurate. - If you need raw, archival data, use `export_responses`. It pulls everything into a machine-readable file, letting you process the results outside of AidaForm entirely. - Update forms on the fly. Use `update_form` to change fields or settings for an active survey, and your agent handles applying those changes directly. ## How It Works The bottom line is that your AI client acts as a dedicated data coordinator, running complex tasks through simple conversation prompts. 1. First, subscribe to this MCP on Vinkius. Then, pull your API Key from the AidaForm dashboard settings. 2. Your AI client connects using that key, authorizing access across all defined tools. It's basically handing over the keys to your data collection infrastructure. 3. You interact with your agent conversationally. You tell it what you need—like 'List all forms needing updates,' or 'Give me the last three responses for Form X.' The MCP executes the tool, and the response comes back directly to your chat. ## Frequently Asked Questions **How do I find my AidaForm API Key?** Log in to your account, navigate to **Settings** > **API Key**, and click **Generate** or copy your unique token. **Can I retrieve individual response data via AI?** Yes! Use the `get_response` tool with the Form ID and Response ID to retrieve the complete high-fidelity submission data programmatically. **How do I find my Form IDs?** Use the `list_forms` tool to retrieve your complete directory of forms along with their unique high-fidelity IDs programmatically. **What's the difference between using `list_forms` and running `get_form`?** `list_forms` provides a directory view of all your active forms. `get_form`, however, pulls deep configuration details for one specific form. This distinction is key; use listing when you just need IDs or names, but run get_form when you need to check field types, settings, or full metadata. **What file formats can I expect when calling `export_responses`?** The system supports standard structured data formats like CSV and JSON. You specify the required format in your request payload. This allows you to immediately load the data into a data warehouse or another tool that requires a specific input type. **When I call `delete_response`, is the data permanently removed from AidaForm?** Yes, calling `delete_response` performs a permanent removal of that submission record. This action ensures high-fidelity database integrity and cannot be reversed or recovered by running other tools in this MCP. **What are the constraints when I use `update_form`?** You must provide both the Form ID and specific field parameters. The tool supports partial updates, meaning you can modify descriptions or change settings without affecting other parts of your form structure. **What kind of metrics does `get_form_analytics` return?** The analytics tool returns comprehensive performance data like completion rates, submission counts over time, and demographic breakdowns. This helps you monitor overall survey success trends rather than just reviewing individual submissions.