# OpnForm MCP > OpnForm gives your AI client full command over form data collection. You use it to create new forms, update existing fields, and retrieve submissions from specific workspaces—all without touching a dashboard. It lets you orchestrate entire data pipelines using natural conversation. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** opnform, form-builder, ai-forms, data-collection, lead-generation, open-source-forms, survey-automation, workspace-management, mcp ## Description Forget clicking through dashboards or building complex API calls just to check a form's status. This server gives your AI client full, direct command over OpnForm data collection and infrastructure management. You won't need to touch a single UI element; your agent handles the whole data pipeline using natural conversation. **Managing Environments & Workspaces** You can start by seeing what containers you've got going on. Use `list_workspaces` to pull an overview of every project area managed under your account. If you need details on one specific area, call `get_workspace` with the appropriate workspace ID. This gives you all the necessary metadata for that whole section. **Handling Forms Structure** When it comes to forms themselves, you've got total control over the lifecycle. You can ask your agent to **build and publish an entirely new form** using `create_form`. Need to tweak an existing setup? Use `update_form` to modify fields, settings, or content on any current structure without rebuilding it. If a form is obsolete, you delete it outright with `delete_form`, removing the specified form from the system. To keep tabs on everything, you can list all active forms within your scope using `list_forms`. If you only need to see details for one specific setup, call `get_form` to retrieve every detail about that particular structure. **Retrieving and Managing Submissions** This is where the data magic happens. You've got two ways to look at submitted records. First, you can use `list_submissions` to get a summary list of multiple responses attached to one specific form—you see all the raw counts and general data points without getting bogged down in every single field value. If you need deep detail on just one entry, call `get_submission`. This fetches the full, detailed payload for that singular submission. For tracking user context, your agent can check your profile details by using `get_me`, which returns all current account and user information. **Data Cleanup & Maintenance** Keeping data clean is half the battle. If a specific record gets corrupted or needs to be removed entirely, you delete it with `delete_submission`, removing that single data entry. Remember that cleanup applies not just to submissions; you've also got full power to remove entire forms using `delete_form`. Your AI client uses this suite of tools to orchestrate complex data workflows: it can list all available projects via `list_workspaces`, get the details for a specific project area with `get_workspace`, then use `list_forms` and `get_form` to verify the form structure, build new forms using `create_form`, or modify old ones with `update_form`. When data comes in, it uses `list_submissions` for summaries and `get_submission` for granular inspection. It can also manage user context via `get_me`. Finally, if you need to wipe something clean—whether it's an entire form structure using `delete_form`, or just one bad record with `delete_submission`—you've got the commands ready. ## Tools ### create_form Builds and publishes an entirely new form within OpnForm. ### delete_form Removes a specified form from the system. ### delete_submission Deletes a single, specific data entry (submission). ### get_form Retrieves all details for one particular form. ### get_submission Fetches the detailed data payload of a single, specific submission. ### get_workspace Retrieves all metadata and details for one defined workspace. ### list_forms Lists all active forms within the current scope or specified workspace. ### list_submissions Lists multiple submitted records for a given form, providing summary data. ### list_workspaces Gets an overview of all available workspaces managed by the account. ### get_me Returns current user account and profile information. ### update_form Modifies fields, settings, or content on an existing form structure. ## Prompt Examples **Prompt:** ``` List all active forms in my 'Marketing' workspace. ``` **Response:** ``` I've retrieved your forms. You have 3 active environments: 'Contact Us', 'Q4 Feedback', and 'Lead Magnet'. Which one would you like to see submissions for? ``` **Prompt:** ``` List all submissions received on my contact form this week with their responses. ``` **Response:** ``` Your "Contact Us" form (form_821) received 14 submissions this week. 6 are general inquiries, 5 are support requests, and 3 are partnership proposals. The most recent submission is from Elena Torres at Meridian Corp, requesting a product demo for their 200-person engineering team. ``` **Prompt:** ``` Create a new feedback survey form in my Product workspace with rating and comment fields. ``` **Response:** ``` New form "Product Feedback Survey" created successfully in the Product workspace (ID: form_847). It includes a 5-star rating field, a text area for comments, an email field for follow-ups, and a dropdown for product category selection. The form is currently in draft mode and ready for customization before publishing. ``` ## Capabilities ### Create or modify forms Generate new OpnForm structures using `create_form` or adjust existing ones with `update_form`. ### List and manage environments Use `list_workspaces` to see all available project containers, or `list_forms` to get a rundown of forms within a workspace. ### Retrieve submission details Pull specific form data using `get_submission`, or list multiple responses from one form using `list_submissions`. ### Perform content lifecycle actions Delete forms (`delete_form`) or clean up individual entries (`delete_submission`) with simple commands. ### Get user and workspace context Check your profile info via `get_me`, or get details on a specific project area using `get_workspace`. ## Use Cases ### Checking Campaign Status Across Sites The Marketing Manager needs to know if the new 'Q4 Feedback' form is live on all 5 regional sites. Instead of checking five different dashboards, they ask their agent to run `list_workspaces` and then iterate through them using `list_forms`. The agent returns a status report listing all active forms in one response. ### Analyzing High-Volume Leads The Sales Director wants a count of how many partnership proposals came in last week. They instruct the agent to use `list_submissions` on the 'Contact Us' form and filter by metadata (e.g., 'Proposal'). The agent processes the data and gives a summary: 12 general, 7 sales-focused. ### Updating Form Logic Mid-Campaign The Product Owner realizes the sign-up form is missing an optional field for product usage. They use `get_form` to verify the existing structure, then call `update_form`, telling the agent exactly where and what new field code to insert. ### Cleaning Up Dead Data The Ops Engineer notices three abandoned pilot forms that are cluttering the system. They use `list_forms` to get a list of candidates, then call `delete_form` for each one systematically, keeping the workspace tidy. ## Benefits - Manage multiple environments quickly. Use `list_workspaces` to see all your project containers, so you don't have to guess where a form lives. - Instant deployment is possible. Need a new survey? Call `create_form` and get the basic structure running in seconds, bypassing UI setup. - Deep data access via tools. Instead of exporting CSVs, run `list_submissions` to get real-time summaries and insights directly in your chat window. - Centralized control flow. Use `get_form` or `update_form` to modify form logic (like adding a conditional field) without logging into the builder. - Clean up fast. When a campaign ends, use `delete_form` to remove the asset entirely, keeping your data infrastructure clean. - See everything in one place. Running `list_forms` and then `list_submissions` lets you check status and content simultaneously. ## How It Works The bottom line is: Your agent gets full programmatic access to OpnForm's API, treating form management like a conversation. 1. Subscribe to the OpnForm server and input your Personal Access Token from your dashboard settings. 2. Instruct your AI client (e.g., 'List all active forms in the Marketing workspace'). 3. The agent calls the appropriate tool (`list_forms`) and returns structured data about your form assets. ## Frequently Asked Questions **How do I list every single workspace using OpnForm MCP Server?** You call `list_workspaces`. This tool gives you an overview of all containers managed by your account, letting you see the scope of data available before targeting any specific form. **Can I update a field on a form using OpnForm MCP Server?** Yes. Use the `update_form` tool. You pass the Form ID and details of the fields you want to change, like adding an optional phone number field. **What's the difference between list_submissions and get_submission?** Use `list_submissions` when you need a summary (e.g., 'How many entries came in?'). Use `get_submission` when you need all the raw detail for one specific entry, like digging into a single applicant's full record. **I want to create a new form using OpnForm MCP Server. What do I use?** You call `create_form`. You just need to specify the intended purpose and any initial fields, and it handles the creation process for you. **How do I check my current API token credentials or profile details using the `get_me` tool?** The `get_me` tool immediately retrieves your account's core user data. This confirms that your AI client is connected with the correct permissions and provides necessary metadata about your active OpnForm account. **What happens when I use the `delete_submission` tool? Does it recover the data?** Using `delete_submission` permanently removes a specific form response. This action is irreversible and deletes the record from your OpnForm workspace entirely. **If I run into an issue while calling `list_forms`, what might be causing the error?** Errors usually point to either insufficient API permissions or incorrect workspace IDs. Always check that the token used by your agent has read access across all necessary form environments. **How does `get_workspace` help me understand the context of my forms?** `get_workspace` provides top-level metadata for a container, confirming which specific set of forms and submissions belong together. This is crucial when managing related data flows across different projects. **Can my AI automatically create a new form by describing it?** Yes! Use the `create_form` tool. Provide a title and optional fields, and your agent will generate the form in your workspace instantly. You can then refine it via natural language. **How do I find my OpnForm Personal Access Token?** Log in to OpnForm, navigate to **Settings** > **API Keys**, and click 'Create a new token'. Copy the generated key immediately as it will only be shown once. **Does it support listing all submissions?** Yes, use the `list_submissions` tool with your Form ID. The AI can then help you search, filter, or summarize the results directly in the chat.