Tools reference

The 10 tools the Formclick MCP server provides, the scope each needs, and their arguments.

Your assistant only sees the tools your approval allows. Read-only access shows the first six; read + write access adds the rest.

Tool	Scope	What it does
`list_forms`	`forms:read`	List your HTML Forms with IDs, status, submission counts and dashboard links.
`get_form`	`forms:read`	One form’s endpoint, access key, notification emails, redirect URL, success message and webhooks.
`get_embed_snippet`	`forms:read`	Ready-to-paste HTML `<form>` and `fetch()` code for a form.
`list_submissions`	`submissions:read`	Submissions, newest first, with search, date range and filters.
`get_submission`	`submissions:read`	One submission with all its field values.
`get_usage`	`usage:read`	Your plan, submissions used this period and number of forms.
`create_html_form`	`forms:write`	Create a form and return its endpoint, access key and snippets.
`update_form_settings`	`forms:write`	Change name, notification emails, redirect URL, success message or active status.
`add_webhook`	`webhooks:write`	Send each new submission to a URL as JSON.
`remove_webhook`	`webhooks:write`	Remove a webhook from a form.

list_submissions

Argument	Type	Description
`form_id`	uuid	Required. From `list_forms`.
`page`	integer	Page number, from 1.
`limit`	integer	Results per page, default 20, max 50.
`search`	string	Case-insensitive text matched in any field.
`from` / `to`	ISO 8601	Only submissions in this time range.
`filter`	enum	`all`, `unread`, `read`, `starred`, `spam` or `archived`.

create_html_form

Argument	Type	Description
`name`	string	Required. Up to 120 characters.
`description`	string	Optional internal description.
`fields`	field[]	Up to 30 inputs for the generated snippet (see below).
`submit_text`	string	Submit button label.
`notification_emails`	string[]	Up to 5 recipients. Default: your account email.
`redirect_url`	url	Where visitors go after submitting.

A field has name (required), label, type (text, email, tel, url, number, date, textarea, select, checkbox), required, placeholder and options (for selects).

update_form_settings

Argument	Type	Description
`form_id`	uuid	Required.
`name`	string	New name.
`notification_emails`	string[]	1–5 recipients.
`redirect_url`	url \| null	`null` removes the redirect.
`success_message`	string	Up to 500 characters.
`is_active`	boolean	`false` pauses the form.

Only the arguments you pass are changed.

add_webhook

Argument	Type	Description
`form_id`	uuid	Required.
`url`	url	Required. Must be a public internet address.
`name`	string	Label shown in the dashboard.
`method`	enum	`POST`, `PUT`, `PATCH` or `GET`.
`headers`	object	Custom headers, e.g. `Authorization`.
`events`	enum[]	`submission.created`.

The payload is described in Webhook events. remove_webhook takes form_id and webhook_id (from get_form).

Other tools

list_forms and get_usage take no arguments.
get_form takes form_id.
get_embed_snippet takes form_id, optional fields and submit_text.
get_submission takes form_id and submission_id.

Still need help? Contact support or email support@formclick.io.