add_form_fields
ChatGPTAdds 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.
add_form_page
ChatGPTAdds 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.
create_form
ChatGPTStarts 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.
delete_form_fields
ChatGPTPermanently 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.
delete_form_page
ChatGPTPermanently 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.
edit_form_fields
ChatGPTChanges 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.
fetch_file
ChatGPTDownloads 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.
form_publish
ChatGPTPublishes 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.
get_form_data
ChatGPTReturns 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.
get_form_rules
ChatGPTLists 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.
get_form_styling
ChatGPTReturns 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.
get_job_status
ChatGPTPolls the status of a long-running background job started by another MCP tool (e.g., create_form, add_form_fields or edit_form_fields). Returns one of: in_progress, success (with job-specific result), failed (with error), or not_found (expired or invalid process_id). Scope: form:read.
list_forms
ChatGPTLists 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.
move_form_field
ChatGPTMoves one field of a form to a new position, on the same page or another page. Call get_form_data first to get the field and page IDs. 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.
move_form_page
ChatGPTMoves one page of a form to a new position. Call get_form_data first to get the page IDs. 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.
query_submissions
ChatGPTSearches 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.
read_submission
ChatGPTRetrieves 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.
rename_form_page
ChatGPTChanges the display name of a page of a form. Call get_form_data first to get the page 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.
set_form_rules
ChatGPTStarts an AI-powered update of a form's conditional logic rules in the background, based on a natural-language description of what to create, edit, or delete (e.g. 'Hide the shipping address fields unless the user selects Delivery, and make the email field required on page 2'). Validates the resulting rules and blocks the change if it would create a conflicting rule set. Returns immediately with a process_id; poll get_job_status with job_type='rules_update' to check completion (typical LLM duration: 5-30s). Scope: form:write.
set_form_styling
ChatGPTUpdates the visual styling of a form. Use 'stylings' for global style properties (colours, fonts, spacing) and 'page_stylings' for per-page layout. At least one must be provided. Call get_form_styling first to see current values. Setting custom_css requires a plan that includes the Custom CSS feature.
unpublish_form
ChatGPTUnpublishes a form: takes it offline so its public live URL stops serving it and no one can submit it. The draft is kept; call form_publish to put it back online. This changes what respondents see, so confirm: true is required.
update_submission
ChatGPTSaves computed values, AI-generated insights, or categorizations back to the submission as custom fields. Fields are automatically prefixed with 'custom_' if not already. Use this to persist analysis results, scores, labels, or any derived data. Supports typed columns (number, date, radio, etc.) for proper data handling. Returns confirmation with the list of updated field names.