# 123FormBuilder MCP MCP > 123FormBuilder connects your data collection into your workflow. It lets you build, manage, and analyze online forms—from simple surveys to complex lead capture tools—using natural conversation with your AI client. Instead of manually exporting CSVs and wrestling spreadsheets, you can query form structures, retrieve specific user submissions, and monitor the entire lifecycle of your data directly through an AI agent. Manage all your company's critical input sources from one place. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** form-builder, data-collection, workflow-automation, lead-capture, survey-tools, webhook ## Description Collecting good data is messy work. You build a form to capture information, but then you have to manually check that data—making sure every field was filled out, organizing the results by date, and linking it back to a specific campaign. This MCP handles all of that automatically. It lets your AI client talk directly to your 123FormBuilder account so you don't have to click through dozens of dashboards. You can ask the agent to list every form you own or pull up only the submissions from last Tuesday for 'Marketing Leads'. The system manages both the raw data and the metadata, letting you analyze what users submitted without ever touching an export file. Because Vinkius hosts this connector, your AI client gets instant access to all these capabilities—from basic querying of entries to verifying form settings. ## Tools ### create_new_form Adds an empty container for a brand new online form into your account. ### remove_form Deletes an entire form container and all its associated submissions permanently. ### remove_entry Permanently deletes a specific user submission or entry record from the system. ### get_api_status Checks the current connection status between your AI client and 123FormBuilder. ### get_form_details Retrieves detailed information and metadata about an entire form container. ### get_entry_details Reads all the specific data points from a single user submission entry. ### list_form_fields Retrieves the technical definition and structure of all input fields for a given form. ### list_active_forms Lists all the forms that are currently published and active in your account. ### list_form_entries Gets a paginated list of recent submissions across specified forms or date ranges. ### list_form_webhooks Lists all configured webhooks, showing where your forms send event data when submitted. ### test_formbuilder_auth Runs a test to verify that the API key and credentials are valid for immediate use. ### update_form_info Changes the visible name or primary information associated with an existing form. ## Prompt Examples **Prompt:** ``` List all active forms in my 123FormBuilder account. ``` **Response:** ``` I've retrieved your forms. You have 3 active forms: 'Contact Us', 'Customer Feedback Survey', and 'Event Registration'. Which one would you like to see submissions for? ``` **Prompt:** ``` Show me the last 5 submissions for the 'Customer Feedback' form. ``` **Response:** ``` I've fetched the latest entries. There are 5 recent submissions. Most users mentioned high satisfaction, but one entry (ID: 5521) reported a layout issue. Shall I retrieve the details for that entry? ``` **Prompt:** ``` Update the name of form '10293' to 'Q4 Marketing Survey'. ``` **Response:** ``` Success! The form 10293 has been renamed to 'Q4 Marketing Survey'. This change is now reflected in your 123FormBuilder dashboard. ``` ## Capabilities ### Manage Form Structure Create brand-new forms or retrieve the full technical configuration details for existing ones. ### Retrieve Submissions and Entries Query user data, fetching paginated lists of submissions or pulling specific entry records by ID. ### Analyze Form Fields Read the internal structure of any form to understand exactly what inputs are available for collection. ### Monitor Operational Status Verify the connection health and check configured webhook endpoints in your account settings. ### Control Form Lifecycle Update form names or permanently delete both entire forms and individual submission records. ## Use Cases ### Auditing Form Drift A system admin notices that an old form seems to be collecting unnecessary data. They ask their agent to run `list_form_fields` on the problematic form, immediately seeing exactly which inputs are live and if anything needs retiring. ### Post-Event Data Cleanup After a conference, an operations specialist finds 50 duplicate entries. They instruct their agent to query `list_form_entries` to identify the duplicates, then use `remove_entry` for each one, cleaning up the dataset in minutes. ### Campaign Performance Check A marketing manager needs to know which of her three recent campaigns generated the most leads. She asks their agent to run `list_active_forms` and then query submissions for each one using `list_form_entries`, getting a comparative report. ### Pre-Deployment Check Before launching a major new form, the development team runs `get_api_status` to confirm connectivity. They then use `test_formbuilder_auth` to ensure their keys are valid and ready for production load. ## Benefits - Instantly audit your setup. Instead of digging through documentation, you can use the `list_form_fields` tool to understand the exact structure of a form and what kinds of data it collects. - Control messy records. If a submission is wrong or outdated, you don't need an admin login; you simply tell the agent to run `remove_entry` and delete the bad record immediately. - Save time on maintenance. When a marketing campaign changes its focus, you can use `update_form_info` to rename the form without needing to log into the web dashboard. - Verify connectivity quickly. Before running complex queries, always run `get_api_status`. This confirms your credentials are active and ready for action. - Handle full data retrieval. You don't just get a summary; you can use `list_form_entries` to pull down the actual, detailed submission records right into your workflow. ## How It Works The bottom line is you tell the AI what data you need, and it handles the connection steps to get it for you. 1. Subscribe to this MCP on Vinkius and enter your 123FormBuilder API key in the connection settings. 2. Your AI client uses the provided credentials to authenticate against your account, establishing a secure data channel. 3. You prompt your agent with natural language requests—like 'list all forms' or 'show submissions for Q4'—and it executes the necessary actions. ## Frequently Asked Questions **How do I check if my API key works with 123FormBuilder? (get_api_status)** You run `get_api_status`. This immediately verifies your credentials and tells you if the connection is live, saving you from trying to build complex queries on a dead link. **Can I delete an entry using list_form_entries? (remove_entry)** No. While `list_form_entries` gets you the data, you use `remove_entry` to actually delete it. You must first run `list_form_entries` to get the specific ID of the record before attempting deletion. **How do I change a form's name? (update_form_info)** You use the `update_form_info` tool. You just tell your agent what the old name and the new desired name are, and it handles the modification in place. **What if I need to see all my existing forms? (list_active_forms)** Run `list_active_forms`. This gives you an immediate list of every form container that is currently published and accessible for data collection in your account. **I need to check what fields are available on a form; how do I use `list_form_fields`?** It gives you the full structure of any form, listing every input type and data point. This is key for validating exactly what kind of information users can submit. **If I have a submission ID, how do I use `get_entry_details` to read the full record?** You just provide the specific entry ID, and this MCP returns all associated data points for that single submission. It's perfect for deep analysis without retrieving everything else. **How do I monitor or manage my external integrations using `list_form_webhooks`?** This tool shows every webhook endpoint currently set up on your account. You use this list to verify that data is correctly flowing from the forms to your necessary third-party services. **I want to start a new survey quickly; how do I use `create_new_form`?** It immediately adds a blank form container to your account. This lets you kick off data collection right away without having to navigate the dashboard first. **Can I see all the fields in a specific form via AI?** Yes! Use the `list_form_fields` tool and provide the Form ID. Your agent will retrieve the complete structure, including labels and field types. **How do I retrieve the latest submissions for a form?** Run the `list_form_entries` query with your Form ID. The agent will return a paginated list of user submissions, which you can then inspect individually using `get_entry_details`. **Is it possible to check the API connection status?** Absolutely. Use the `get_api_status` or `test_formbuilder_auth` tools to verify your credentials and ensure the agent can communicate with the 123FormBuilder service.