# Formsite MCP > Formsite MCP connects your AI agent directly to your form builder data. You can list every form you own, pull real-time submission results for analysis, and manage complex webhook triggers—all through natural conversation. Stop jumping between dashboards; get all your form data and operational insights in one place. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** online-forms, data-collection, webhooks, survey-builder, reporting, automation ## Description This connector lets your AI client treat your forms like a database it can query directly. You don't need to log into the Formsite dashboard or manually export CSVs anymore. Instead, you talk to your agent, and it handles the heavy lifting. Want to know what people are saying about your latest survey? Just ask for recent results. Need to update how new submissions get routed when they come in? The MCP lets your agent manage webhooks automatically. It gives you full visibility into every form you run, letting you inspect field definitions or pull high-level report summaries instantly. You'll find this integrated data management capability is a core feature available across the Vinkius catalog, making it easy to connect disparate business tools without writing any code. ## Tools ### create_webhook Sets up a new automated notification trigger for your forms. ### delete_webhook Removes an existing data notification trigger from your account. ### get_form_details Pulls metadata to describe a specific form and its structure within the system. ### get_form_reports Fetches high-level summary reports about the performance of your forms. ### list_form_items Shows a list of all specific fields and data points defined within a selected form. ### list_forms Lists every single form directory available in your account for quick selection. ### list_results Retrieves a list of completed submissions and the data submitted by users. ### list_webhooks Shows all currently active or configured data notification triggers. ## Prompt Examples **Prompt:** ``` List all forms in my Formsite account and their directory names. ``` **Response:** ``` Retrieving forms... I found 5 forms, including 'Annual Survey' (dir: survey_2023) and 'Contact Form' (dir: contact_us). Which one would you like to check results for? ``` **Prompt:** ``` Show me the 10 most recent results for form 'survey_2023'. ``` **Response:** ``` Fetching results... For survey_2023, I found 10 recent submissions. Key feedback includes requests for 'Faster shipping' and 'More color options'. ``` **Prompt:** ``` What fields are defined in my 'Contact' form (dir: contact_us)? ``` **Response:** ``` Inspecting form items... The 'Contact Form' includes fields for 'Name', 'Email Address', 'Subject', and 'Message (Paragraph Text)'. ``` ## Capabilities ### List all forms Retrieves a comprehensive directory of every form you have created in your account. ### Fetch submission results Pulls the most recent or specific data entries from any existing form, including detailed answers and timestamps. ### Inspect form fields Shows the exact structure of a selected form by listing all defined input types and items. ### Manage webhooks Creates, deletes, or lists automated triggers that send notifications when new data arrives. ### Retrieve report summaries Gathers high-level reports and metadata about the form's overall performance metrics. ## Use Cases ### Onboarding new survey data A marketing manager needs to know the performance of their Q3 customer satisfaction survey. They ask their agent, 'What are the top three pain points from the last month?' The agent uses `list_results` and summarizes key themes without opening any dashboards. ### Setting up real-time alerts An operations team needs to know when a specific form (e.g., an incident report) is completed so the ticketing system updates immediately. They use `create_webhook` and configure the trigger via conversation, ensuring zero manual monitoring. ### Auditing data collection structure A developer needs to verify if a form has been updated with new fields before integrating it into an application. They run 'What fields are in my main contact form?' and the agent uses `list_form_items` to give them the exact list. ### Comparing multiple data sources A researcher wants a high-level view of three different surveys (user feedback, product usage, onboarding). They ask the agent to 'List all forms' and then request `get_form_reports` for each one in sequence. ## Benefits - Access all forms with the `list_forms` tool. You never have to guess what data you have; you can see every collector directory right from your agent chat. - Stop manually exporting results. Use `list_results` to pull recent submission batches directly into your conversation for instant analysis and pattern spotting. - Need to know the structure of a form? The `list_form_items` tool shows exactly what fields exist, helping you map data before writing any automation scripts. - Automate responses with webhooks. You can use `create_webhook` or `delete_webhook` to ensure that when new feedback comes in, your backend system gets notified instantly. - Get a performance overview by using `get_form_reports`. This tool provides high-level summaries so you don't have to sift through thousands of individual entries. ## How It Works The bottom line is you tell your AI what data you need from Formsite; the MCP handles connecting and retrieving it. 1. Subscribe to this MCP on Vinkius, then provide your specific Formsite server credentials and access token. 2. Your AI client uses these credentials to authenticate with your account's data layer. 3. You prompt your agent using natural language—for example, 'Show me the results for my annual survey'—and it executes the necessary calls. ## Frequently Asked Questions **How do I list all my forms using the Formsite MCP?** You use the `list_forms` tool. It pulls a full directory of every form in your account, letting you know exactly what data collectors are available. **Can the Formsite MCP retrieve results for multiple forms at once?** Yes. You can ask your agent to `list_results` across different directories or provide specific filters, giving you a consolidated view of submissions. **What is the difference between listing form fields and getting form details in Formsite MCP?** The `get_form_details` tool gives overall metadata about the form (like its creation date). The `list_form_items` tool specifically shows the name and type of every input field defined within that form. **Does Formsite MCP handle webhooks for me?** Yes. You can use `create_webhook` to set up a new automated notification trigger, or `list_webhooks` to review all the currently active triggers in your account. **Is this Formsite MCP safe to connect with my business data?** The connection requires you to provide specific credentials (Server, User Directory, Token) which the Vinkius platform manages securely. It only exposes the functions defined by the available tools.