Formester

Adds new fields to a page of a form, drafted by AI from a natural-language description. Call get_form_data first to get the page ID. Async — returns a process_id; poll get_job_status with job_type='field_create' to track completion. Changes are saved as a draft and are NOT visible to respondents yet. Afterwards, tell the user the changes are saved as a draft and ask whether they want to publish — only call form_publish if the user confirms.

Adds a new, empty page to a form. Without a position it goes before the last page (the thank-you page). Returns the new page's ID. Changes are saved as a draft and are NOT visible to respondents yet. Afterwards, tell the user the changes are saved as a draft and ask whether they want to publish — only call form_publish if the user confirms.

Starts AI-powered form creation in the background. Returns immediately with a process_id and a preview_url; poll get_job_status with job_type='form_creation' to check completion (typical LLM duration: 5-30s). Requires an organization-wide token. Scope: form:write.

Permanently deletes fields from a form. Call get_form_data first to get the field IDs. This is irreversible, so confirm: true is required. Changes are saved as a draft and are NOT visible to respondents yet. Afterwards, tell the user the changes are saved as a draft and ask whether they want to publish — only call form_publish if the user confirms.

Permanently deletes a page of a form, together with every field on it. Call get_form_data first to get the page ID. This is irreversible, so confirm: true is required. Changes are saved as a draft and are NOT visible to respondents yet. Afterwards, tell the user the changes are saved as a draft and ask whether they want to publish — only call form_publish if the user confirms.

Changes existing fields of a form with AI, from a natural-language description of the change. Call get_form_data first to get the field IDs. AI overwrites the selected fields' properties, so confirm: true is required. Async — returns a process_id; poll get_job_status with job_type='field_update' to track completion. Changes are saved as a draft and are NOT visible to respondents yet. Afterwards, tell the user the changes are saved as a draft and ask whether they want to publish — only call form_publish if the user confirms.

Downloads and returns file content from a submission attachment. Supports multiple file types: - **Images** (PNG, JPG, GIF, WebP, SVG): Returns base64-encoded image data that vision-capable AI models can analyze directly. - **PDFs**: Extracts text content for analysis. Use extract_text=true for readable text, or extract_text=false for base64. - **Text files** (TXT, MD, CSV, JSON, XML, HTML): Returns the text content directly. - **Other files**: Returns base64-encoded content with mime type for specialized processing. Call this AFTER read_submission to get file content. First call read_submission with include_files=true to get attachment IDs.

Publishes a form: snapshots the current draft (pages/fields/settings) as the live version served at the form's public live URL, where anyone with the link can view and submit it. Required after edits made over MCP to make those changes visible to respondents. This changes what respondents see, so confirm: true is required.

Returns the complete structure of a form — all pages and fields with their IDs and properties — plus its publish status (published, has_unpublished_changes, preview_url, live_url). Required workflow: Call this tool first to get the field and page IDs that edit_form_fields, move_form_field, delete_form_fields, rename_form_page, move_form_page and delete_form_page need.

Lists a form's conditional logic rules (paginated). Each rule includes its id, conditions, conjunction, actions, and visibility flag. Use set_form_rules to create, edit, or delete rules. Scope: form:read.