Formester

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.

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 or unpublishes a form. publish snapshots the current draft (pages/fields/settings) as the live version served at the form's live URL — required after edits made via update_form_content to make those changes visible to respondents. unpublish takes the form offline; the live URL stops serving it. Both actions change 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 before using update_form_content to get the IDs needed for move_field, delete_fields, update_fields, rename_page, move_page, and delete_page actions.

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.

Returns the current visual styling configuration for a form, including colors, typography, layout settings, and feature toggles. Also reports which plan-gated features are available. Call this before set_form_styling to inspect current values and valid property names.

Polls the status of a long-running background job started by another MCP tool (e.g., create_form, or the create_fields/update_fields actions of update_form_content). Returns one of: in_progress, success (with job-specific result), failed (with error), or not_found (expired or invalid process_id). Scope: form:read.

Lists forms in the organization with optional name search and pagination. Returns form id, uuid, name, status, submission count, and timestamps. Requires an organization-wide token.

Searches and retrieves multiple submissions from a form with optional filters. Use this to find similar past submissions, analyze trends, compare values, or gather historical context. Returns paginated results with submission data and custom fields.

Retrieves submission data including form fields, custom fields, and file attachment metadata. Returns URLs and IDs for attachments, NOT file content. To read actual file content, use fetch_file with the attachment ID from this response.