Formstack MCP by usefulapi is an MCP server published by io.usefulapi, hosted at formstack.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 21 tools, including formstack_list_forms, formstack_get_form, formstack_list_form_fields, formstack_list_form_submissions, formstack_count_form_submissions.
Browse Formstack forms, submissions and webhooks, search responses, and create submissions.
3,910 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
List the forms in the account, with submission counts, live URL and folder. Filter by name or folder and sort. Formstack: GET /forms.
| Parameter | Type | Description |
|---|---|---|
| order | string | Sort direction (default ASC). |
| folder | integer | Only forms in this folder ID. |
| search | string | Match forms by name. |
| order_by | string | Column to order by, e.g. name, created, updated. |
| page_size | integer | Items per page, 10-500 (Formstack default 50). |
| page_number | integer | Page number, starting at 1. |
{
"name": "formstack_list_forms",
"title": "List forms",
"description": "List the forms in the account, with submission counts, live URL and folder. Filter by name or folder and sort. Formstack: GET /forms.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"order": {
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "Sort direction (default ASC)."
},
"folder": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Only forms in this folder ID."
},
"search": {
"type": "string",
"description": "Match forms by name."
},
"order_by": {
"type": "string",
"description": "Column to order by, e.g. name, created, updated."
},
"page_size": {
"type": "integer",
"maximum": 500,
"minimum": 10,
"description": "Items per page, 10-500 (Formstack default 50)."
},
"page_number": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1."
}
}
},
"annotations": {
"title": "List forms",
"readOnlyHint": true
}
}Fetch a form's details — name, URL, submission counts, settings — optionally with its full field list. Formstack: GET /forms/{formId}.
| Parameter | Type | Description |
|---|---|---|
| form_id * | integer | The form ID. |
| with_fields | boolean | Include the form's fields in the response. |
{
"name": "formstack_get_form",
"title": "Get one form",
"description": "Fetch a form's details — name, URL, submission counts, settings — optionally with its full field list. Formstack: GET /forms/{formId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form_id"
],
"properties": {
"form_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The form ID.",
"exclusiveMinimum": 0
},
"with_fields": {
"type": "boolean",
"description": "Include the form's fields in the response."
}
}
},
"annotations": {
"title": "Get one form",
"readOnlyHint": true
}
}List every field on a form — id, label, type, required flag, options and logic. Use this to learn field IDs before searching or creating submissions. Formstack: GET /forms/{formId}/fields.
| Parameter | Type | Description |
|---|---|---|
| form_id * | integer | The form ID. |
{
"name": "formstack_list_form_fields",
"title": "List a form's fields",
"description": "List every field on a form — id, label, type, required flag, options and logic. Use this to learn field IDs before searching or creating submissions. Formstack: GET /forms/{formId}/fields.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form_id"
],
"properties": {
"form_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The form ID.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List a form's fields",
"readOnlyHint": true
}
}List a form's submissions, newest or oldest first, filtered by keyword, date range or specific field values. Set include_data to get the answers. Formstack: GET /forms/{formId}/submissions.
| Parameter | Type | Description |
|---|---|---|
| order | string | Sort direction (default ASC). |
| form_id * | integer | The form ID. |
| keyword | string | Match submissions by content across all fields. |
| max_time | string | Only entries created on or before this date/time: YYYY-MM-DD or YYYY-MM-DD HH:MM:SS (Eastern Time). |
| min_time | string | Only entries created on or after this date/time: YYYY-MM-DD or YYYY-MM-DD HH:MM:SS (Eastern Time). |
| page_size | integer | Items per page, 10-500 (Formstack default 50). |
| data_format | string | Shape of data: legacy (object keyed by field id) or standardized (array of field objects). |
| expand_data | boolean | Include expanded field data with parsed values. |
| page_number | integer | Page number, starting at 1. |
| pretty_name |
Count a form's submissions, with a per-day breakdown over a lookback window of up to 7 days. Formstack: GET /forms/{formId}/submissions/count.
| Parameter | Type | Description |
|---|---|---|
| form_id * | integer | The form ID. |
| start_date | string | Date to count from, e.g. 2026-09-01. |
| lookback_period | integer | How many days to count backwards (maximum 7). |
{
"name": "formstack_count_form_submissions",
"title": "Count a form's submissions",
"description": "Count a form's submissions, with a per-day breakdown over a lookback window of up to 7 days. Formstack: GET /forms/{formId}/submissions/count.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form_id"
],
"properties": {
"form_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The form ID.",
"exclusiveMinimum": 0
},
"start_date": {
"type": "string",
"description": "Date to count from, e.g. 2026-09-01."
},
"lookback_period": {
"type": "integer",
"maximum": 7,
"minimum": 1,
"description": "How many days to count backwards (maximum 7)."
}
}
},
"annotations": {
"title": "Count a form's submissions",
"readOnlyHint": true
}
}Full-text search for submissions across every form in the account, e.g. by a person's email or name. Formstack: GET /submissions.
| Parameter | Type | Description |
|---|---|---|
| order | string | Sort direction (default ASC). |
| search * | string | Search term to match against submission content. |
| page_size | integer | Items per page, 10-500 (Formstack default 50). |
| page_number | integer | Page number, starting at 1. |
{
"name": "formstack_search_submissions",
"title": "Search submissions across all forms",
"description": "Full-text search for submissions across every form in the account, e.g. by a person's email or name. Formstack: GET /submissions.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"search"
],
"properties": {
"order": {
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "Sort direction (default ASC)."
},
"search": {
"type": "string",
"minLength": 1,
"description": "Search term to match against submission content."
},
"page_size": {
"type": "integer",
"maximum": 500,
"minimum": 10,
"description": "Items per page, 10-500 (Formstack default 50)."
},
"page_number": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1."
}
}
},
"annotations": {
"title": "Search submissions across all forms",
"readOnlyHint": true
}
}Fetch a single submission with every field's label, type, display value and parsed value, plus payment, approval and workflow status. Formstack: GET /submissions/{submissionId}.
| Parameter | Type | Description |
|---|---|---|
| submission_id * | integer | The submission ID. |
| encryption_password | string | Only for forms with encryption enabled: the form's encryption password, sent as the X-FS-Encryption-Password header. |
{
"name": "formstack_get_submission",
"title": "Get one submission",
"description": "Fetch a single submission with every field's label, type, display value and parsed value, plus payment, approval and workflow status. Formstack: GET /submissions/{submissionId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"submission_id"
],
"properties": {
"submission_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The submission ID.",
"exclusiveMinimum": 0
},
"encryption_password": {
"type": "string",
"description": "Only for forms with encryption enabled: the form's encryption password, sent as the X-FS-Encryption-Password header."
}
}
},
"annotations": {
"title": "Get one submission",
"readOnlyHint": true
}
}Permanently delete ONE submission and all associated data. First call with submission_id and its expected form_id to preview. Show the preview to the user and obtain their explicit confirmation, then call the SAME ids with confirm:true and the returned preview_token within 15 minutes. Changed records require a new preview. No bulk deletion, automatic replay or undo. A final read verifies absence; if unverified, inspect the submission before retrying. Formstack: GET, DELETE /submissions/{submissionId}.
| Parameter | Type | Description |
|---|---|---|
| confirm | boolean | Omit or false to preview. True only after the user explicitly confirms this exact preview. |
| form_id * | integer | The expected parent form ID. |
| preview_token | string | Account-bound token from the preview; required with confirm:true. |
| submission_id * | integer | The submission ID. |
| encryption_password | string | Only for forms with encryption enabled: the form's encryption password, sent as the X-FS-Encryption-Password header. |
{
"name": "formstack_delete_submission",
"title": "Preview or delete one submission",
"description": "Permanently delete ONE submission and all associated data. First call with submission_id and its expected form_id to preview. Show the preview to the user and obtain their explicit confirmation, then call the SAME ids with confirm:true and the returned preview_token within 15 minutes. Changed records require a new preview. No bulk deletion, automatic replay or undo. A final read verifies absence; if unverified, inspect the submission before retrying. Formstack: GET, DELETE /submissions/{submissionId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"submission_id",
"form_id"
],
"properties": {
"confirm": {
"type": "boolean",
"description": "Omit or false to preview. True only after the user explicitly confirms this exact preview."
},
"form_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The expected parent form ID.",
"exclusiveMinimum": 0
},
"preview_token": {
"type": "string",
"maxLength": 100,
"description": "Account-bound token from the preview; required with confirm:true."
},
"submission_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The submission ID.",
"exclusiveMinimum": 0
},
"encryption_password": {
"type": "string",
"description": "Only for forms with encryption enabled: the form's encryption password, sent as the X-FS-Encryption-Password header."
}
}
},
"annotations": {
"title": "Preview or delete one submission",
"readOnlyHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}List entries respondents started but did not finish (Save & Resume / abandoned), with the same filters as submissions. Formstack: GET /form/{formId}/partialsubmission.
| Parameter | Type | Description |
|---|---|---|
| order | string | Sort direction (default ASC). |
| form_id * | integer | The form ID. |
| keyword | string | Keyword to search. |
| max_time | string | Only entries created on or before this date/time: YYYY-MM-DD or YYYY-MM-DD HH:MM:SS (Eastern Time). |
| min_time | string | Only entries created on or after this date/time: YYYY-MM-DD or YYYY-MM-DD HH:MM:SS (Eastern Time). |
| page_size | integer | Items per page, 10-500 (Formstack default 50). |
| expand_data | boolean | Expand data with detailed field information. |
| page_number | integer | Page number, starting at 1. |
| pretty_name | boolean | Include pretty names. |
| include_data | boolean | Include each partial submission's data. |
List the account's form folders and their subfolders. Formstack: GET /folders.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. |
| per_page | integer | Folders per page (minimum 10). |
{
"name": "formstack_list_folders",
"title": "List folders",
"description": "List the account's form folders and their subfolders. Formstack: GET /folders.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1."
},
"per_page": {
"type": "integer",
"maximum": 500,
"minimum": 10,
"description": "Folders per page (minimum 10)."
}
}
},
"annotations": {
"title": "List folders",
"readOnlyHint": true
}
}Fetch a folder with its parent, permissions and direct subfolders. Formstack: GET /folders/{folderId}.
| Parameter | Type | Description |
|---|---|---|
| folder_id * | integer | The folder ID. |
{
"name": "formstack_get_folder",
"title": "Get one folder",
"description": "Fetch a folder with its parent, permissions and direct subfolders. Formstack: GET /folders/{folderId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"folder_id"
],
"properties": {
"folder_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The folder ID.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get one folder",
"readOnlyHint": true
}
}List the webhooks that push a form's submissions to external URLs, with their payload settings. Formstack: GET /forms/{formId}/webhooks.
| Parameter | Type | Description |
|---|---|---|
| form_id * | integer | The form ID. |
{
"name": "formstack_list_webhooks",
"title": "List a form's webhooks",
"description": "List the webhooks that push a form's submissions to external URLs, with their payload settings. Formstack: GET /forms/{formId}/webhooks.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form_id"
],
"properties": {
"form_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The form ID.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List a form's webhooks",
"readOnlyHint": true
}
}List the notification emails that alert your team when a form is submitted — recipients, subject, sender and logic. Formstack: GET /forms/{formId}/notifications.
| Parameter | Type | Description |
|---|---|---|
| form_id * | integer | The form ID. |
{
"name": "formstack_list_notification_emails",
"title": "List a form's notification emails",
"description": "List the notification emails that alert your team when a form is submitted — recipients, subject, sender and logic. Formstack: GET /forms/{formId}/notifications.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form_id"
],
"properties": {
"form_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The form ID.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List a form's notification emails",
"readOnlyHint": true
}
}List the confirmation emails sent to the person who submits a form — sender, subject, message and delay. Formstack: GET /forms/{formId}/confirmations.
| Parameter | Type | Description |
|---|---|---|
| form_id * | integer | The form ID. |
{
"name": "formstack_list_confirmation_emails",
"title": "List a form's confirmation emails",
"description": "List the confirmation emails sent to the person who submits a form — sender, subject, message and delay. Formstack: GET /forms/{formId}/confirmations.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form_id"
],
"properties": {
"form_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The form ID.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List a form's confirmation emails",
"readOnlyHint": true
}
}List what happens after a form is submitted — default processing, a custom message, or a redirect URL — with conditional logic. Formstack: GET /forms/{formId}/submitactions.
| Parameter | Type | Description |
|---|---|---|
| form_id * | integer | The form ID. |
{
"name": "formstack_list_submit_actions",
"title": "List a form's submit actions",
"description": "List what happens after a form is submitted — default processing, a custom message, or a redirect URL — with conditional logic. Formstack: GET /forms/{formId}/submitactions.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form_id"
],
"properties": {
"form_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The form ID.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List a form's submit actions",
"readOnlyHint": true
}
}Submit an entry to a form on someone's behalf. This is a real submission: it counts toward the form and can fire its notification emails, webhooks and integrations. Formstack: POST /forms/{formId}/submissions.
| Parameter | Type | Description |
|---|---|---|
| read | boolean | Mark the submission as read on creation. |
| fields * | array | Field values to submit. |
| form_id * | integer | The form ID. |
| user_agent | string | Submitter's browser user agent to record. |
| remote_addr | string | Submitter's IP address to record. |
{
"name": "formstack_create_submission",
"title": "Create a submission",
"description": "Submit an entry to a form on someone's behalf. This is a real submission: it counts toward the form and can fire its notification emails, webhooks and integrations. Formstack: POST /forms/{formId}/submissions.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form_id",
"fields"
],
"properties": {
"read": {
"type": "boolean",
"description": "Mark the submission as read on creation."
},
"fields": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"value"
],
"properties": {
"id": {
"type": [
"string",
"number"
],
"description": "The field ID."
},
"value": {
"type": "object",
"description": "The field value as an object, shaped by field type: text/email/number/phone/textarea/datetime/radio → {\"value\":\"...\"}; name → {\"first\":\"...\",\"last\":\"...\"} (also prefix, middle, initial, suffix); address → {\"address\",\"address2\",\"city\",\"state\",\"zip\",\"country\"}; checkbox/select → {\"subvalues\":[{\"subvalue\":\"...\"}]}. Use formstack_list_form_fields for field IDs and types.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"minItems": 1,
"description": "Field values to submit."
},
"form_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The form ID.",
"exclusiveMinimum": 0
},
"user_agent": {
"type": "string",
"description": "Submitter's browser user agent to record."
},
"remote_addr": {
"type": "string",
"description": "Submitter's IP address to record."
}
}
},
"annotations": {
"title": "Create a submission",
"destructiveHint": true
}
}Change field values on an existing submission, or mark it read/unread. Only the fields you pass are changed. Formstack: PUT /submissions/{submissionId}.
| Parameter | Type | Description |
|---|---|---|
| read | boolean | Mark the submission read (true) or unread (false). |
| fields | array | Field values to change. |
| submission_id * | integer | The submission ID. |
| encryption_password | string | Only for forms with encryption enabled: the form's encryption password, sent as the X-FS-Encryption-Password header. |
{
"name": "formstack_update_submission",
"title": "Update a submission",
"description": "Change field values on an existing submission, or mark it read/unread. Only the fields you pass are changed. Formstack: PUT /submissions/{submissionId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"submission_id"
],
"properties": {
"read": {
"type": "boolean",
"description": "Mark the submission read (true) or unread (false)."
},
"fields": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"value"
],
"properties": {
"id": {
"type": [
"string",
"number"
],
"description": "The field ID."
},
"value": {
"type": "object",
"description": "The field value as an object, shaped by field type: text/email/number/phone/textarea/datetime/radio → {\"value\":\"...\"}; name → {\"first\":\"...\",\"last\":\"...\"} (also prefix, middle, initial, suffix); address → {\"address\",\"address2\",\"city\",\"state\",\"zip\",\"country\"}; checkbox/select → {\"subvalues\":[{\"subvalue\":\"...\"}]}. Use formstack_list_form_fields for field IDs and types.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"minItems": 1,
"description": "Field values to change."
},
"submission_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The submission ID.",
"exclusiveMinimum": 0
},
"encryption_password": {
"type": "string",
"description": "Only for forms with encryption enabled: the form's encryption password, sent as the X-FS-Encryption-Password header."
}
}
},
"annotations": {
"title": "Update a submission",
"destructiveHint": true
}
}Generate a link to a live form with some fields already filled in — e.g. to send a customer a form with their name and account number pre-entered. Formstack stores the prefill and returns prefilledUrl. Formstack: POST /forms/{formId}/prefill.
| Parameter | Type | Description |
|---|---|---|
| fields * | array | Field values to prefill. |
| form_id * | integer | The form ID. |
| incomplete_password | string | Optional password protecting the prefilled entry. |
{
"name": "formstack_create_prefill_url",
"title": "Create a prefilled form link",
"description": "Generate a link to a live form with some fields already filled in — e.g. to send a customer a form with their name and account number pre-entered. Formstack stores the prefill and returns prefilledUrl. Formstack: POST /forms/{formId}/prefill.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form_id",
"fields"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"value"
],
"properties": {
"id": {
"type": [
"string",
"number"
],
"description": "The field ID."
},
"value": {
"type": "object",
"description": "The field value as an object, shaped by field type: text/email/number/phone/textarea/datetime/radio → {\"value\":\"...\"}; name → {\"first\":\"...\",\"last\":\"...\"} (also prefix, middle, initial, suffix); address → {\"address\",\"address2\",\"city\",\"state\",\"zip\",\"country\"}; checkbox/select → {\"subvalues\":[{\"subvalue\":\"...\"}]}. Use formstack_list_form_fields for field IDs and types.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"minItems": 1,
"description": "Field values to prefill."
},
"form_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The form ID.",
"exclusiveMinimum": 0
},
"incomplete_password": {
"type": "string",
"description": "Optional password protecting the prefilled entry."
}
}
},
"annotations": {
"title": "Create a prefilled form link",
"destructiveHint": true
}
}Rename a form, move it to a folder, change its submit-button text, timezone or language, or activate/deactivate it (with a message shown while inactive). Reversible. Formstack: PUT /forms/{formId}.
| Parameter | Type | Description |
|---|---|---|
| name | string | New form name. |
| folder | integer | Folder ID to move the form into. |
| form_id * | integer | The form ID. |
| language | string | Form language. |
| timezone | string | Form timezone. |
| is_active | boolean | Turn the live form on (true) or off (false). |
| disabled_message | string | Message shown while the form is inactive. |
| submit_button_title | string | Submit button text on the live form. |
{
"name": "formstack_update_form",
"title": "Update a form's settings",
"description": "Rename a form, move it to a folder, change its submit-button text, timezone or language, or activate/deactivate it (with a message shown while inactive). Reversible. Formstack: PUT /forms/{formId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form_id"
],
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "New form name."
},
"folder": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Folder ID to move the form into."
},
"form_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The form ID.",
"exclusiveMinimum": 0
},
"language": {
"type": "string",
"description": "Form language."
},
"timezone": {
"type": "string",
"description": "Form timezone."
},
"is_active": {
"type": "boolean",
"description": "Turn the live form on (true) or off (false)."
},
"disabled_message": {
"type": "string",
"description": "Message shown while the form is inactive."
},
"submit_button_title": {
"type": "string",
"description": "Submit button text on the live form."
}
}
},
"annotations": {
"title": "Update a form's settings",
"destructiveHint": true
}
}Create a folder for organising forms, at the root or inside a parent folder. Formstack: POST /folders.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Folder name. |
| parent | integer | Parent folder ID (omit for root level). |
{
"name": "formstack_create_folder",
"title": "Create a folder",
"description": "Create a folder for organising forms, at the root or inside a parent folder. Formstack: POST /folders.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Folder name."
},
"parent": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Parent folder ID (omit for root level)."
}
}
},
"annotations": {
"title": "Create a folder",
"destructiveHint": true
}
}Add a webhook that POSTs each new submission of a form to your URL. Formstack: POST /forms/{formId}/webhooks.
| Parameter | Type | Description |
|---|---|---|
| url * | string | HTTPS URL that receives the submission data. |
| name | string | Webhook name. |
| form_id * | integer | The form ID. |
| hmac_secret | string | Secret used to HMAC-sign each payload. |
| content_type | string | Payload encoding. |
| error_emails | string | Comma-separated emails to notify on delivery failure. |
| file_transfer_type | string | How uploaded files are delivered in the payload. |
| include_field_type | boolean | Include each field's type in the payload. |
| standardize_values | boolean | Standardize field values for consistency. |
| post_data_field_keys | string | How fields are keyed in the payload. |
Tools for Formstack, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "How many responses did my contact form get in the last 7 days?"; "Show me the latest submissions on my customer survey form."; "Which people started my application form but never finished it?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Formstack data. Free plan: 50 tool calls per month. Run formstack_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run formstack_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run formstack_upgrade without a plan: it returns both plans, each with a payment link for the user to open. formstack_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| boolean |
| Include a human-readable name per submission (from its name/email field). |
| include_data | boolean | Include each submission's field data. |
| field_filters | array | Search specific fields by value (up to 10 criteria, AND-ed). |
| encryption_password | string | Only for forms with encryption enabled: the form's encryption password, sent as the X-FS-Encryption-Password header. |
{
"name": "formstack_list_form_submissions",
"title": "List a form's submissions",
"description": "List a form's submissions, newest or oldest first, filtered by keyword, date range or specific field values. Set include_data to get the answers. Formstack: GET /forms/{formId}/submissions.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form_id"
],
"properties": {
"order": {
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "Sort direction (default ASC)."
},
"form_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The form ID.",
"exclusiveMinimum": 0
},
"keyword": {
"type": "string",
"description": "Match submissions by content across all fields."
},
"max_time": {
"type": "string",
"description": "Only entries created on or before this date/time: YYYY-MM-DD or YYYY-MM-DD HH:MM:SS (Eastern Time)."
},
"min_time": {
"type": "string",
"description": "Only entries created on or after this date/time: YYYY-MM-DD or YYYY-MM-DD HH:MM:SS (Eastern Time)."
},
"page_size": {
"type": "integer",
"maximum": 500,
"minimum": 10,
"description": "Items per page, 10-500 (Formstack default 50)."
},
"data_format": {
"enum": [
"legacy",
"standardized"
],
"type": "string",
"description": "Shape of data: legacy (object keyed by field id) or standardized (array of field objects)."
},
"expand_data": {
"type": "boolean",
"description": "Include expanded field data with parsed values."
},
"page_number": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1."
},
"pretty_name": {
"type": "boolean",
"description": "Include a human-readable name per submission (from its name/email field)."
},
"include_data": {
"type": "boolean",
"description": "Include each submission's field data."
},
"field_filters": {
"type": "array",
"items": {
"type": "object",
"required": [
"field_id",
"value"
],
"properties": {
"value": {
"type": "string",
"description": "The value to search for in that field."
},
"field_id": {
"type": [
"string",
"number"
],
"description": "The field ID to match."
}
}
},
"maxItems": 10,
"description": "Search specific fields by value (up to 10 criteria, AND-ed)."
},
"encryption_password": {
"type": "string",
"description": "Only for forms with encryption enabled: the form's encryption password, sent as the X-FS-Encryption-Password header."
}
}
},
"annotations": {
"title": "List a form's submissions",
"readOnlyHint": true
}
}| field_filters | array | Search specific fields by value (up to 10 criteria, AND-ed). |
{
"name": "formstack_list_partial_submissions",
"title": "List a form's partial submissions",
"description": "List entries respondents started but did not finish (Save & Resume / abandoned), with the same filters as submissions. Formstack: GET /form/{formId}/partialsubmission.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form_id"
],
"properties": {
"order": {
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "Sort direction (default ASC)."
},
"form_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The form ID.",
"exclusiveMinimum": 0
},
"keyword": {
"type": "string",
"description": "Keyword to search."
},
"max_time": {
"type": "string",
"description": "Only entries created on or before this date/time: YYYY-MM-DD or YYYY-MM-DD HH:MM:SS (Eastern Time)."
},
"min_time": {
"type": "string",
"description": "Only entries created on or after this date/time: YYYY-MM-DD or YYYY-MM-DD HH:MM:SS (Eastern Time)."
},
"page_size": {
"type": "integer",
"maximum": 500,
"minimum": 10,
"description": "Items per page, 10-500 (Formstack default 50)."
},
"expand_data": {
"type": "boolean",
"description": "Expand data with detailed field information."
},
"page_number": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1."
},
"pretty_name": {
"type": "boolean",
"description": "Include pretty names."
},
"include_data": {
"type": "boolean",
"description": "Include each partial submission's data."
},
"field_filters": {
"type": "array",
"items": {
"type": "object",
"required": [
"field_id",
"value"
],
"properties": {
"value": {
"type": "string",
"description": "The value to search for in that field."
},
"field_id": {
"type": [
"string",
"number"
],
"description": "The field ID to match."
}
}
},
"maxItems": 10,
"description": "Search specific fields by value (up to 10 criteria, AND-ed)."
}
}
},
"annotations": {
"title": "List a form's partial submissions",
"readOnlyHint": true
}
}| include_subfield_names |
| boolean |
| Include subfield names in the payload. |
{
"name": "formstack_create_webhook",
"title": "Create a webhook",
"description": "Add a webhook that POSTs each new submission of a form to your URL. Formstack: POST /forms/{formId}/webhooks.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form_id",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "HTTPS URL that receives the submission data."
},
"name": {
"type": "string",
"description": "Webhook name."
},
"form_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The form ID.",
"exclusiveMinimum": 0
},
"hmac_secret": {
"type": "string",
"description": "Secret used to HMAC-sign each payload."
},
"content_type": {
"enum": [
"urlencoded",
"json"
],
"type": "string",
"description": "Payload encoding."
},
"error_emails": {
"type": "string",
"description": "Comma-separated emails to notify on delivery failure."
},
"file_transfer_type": {
"enum": [
"downloadLink",
"signedUrl",
"base64encode"
],
"type": "string",
"description": "How uploaded files are delivered in the payload."
},
"include_field_type": {
"type": "boolean",
"description": "Include each field's type in the payload."
},
"standardize_values": {
"type": "boolean",
"description": "Standardize field values for consistency."
},
"post_data_field_keys": {
"enum": [
"field_names",
"field_ids",
"api_friendly_field_names",
"internal_labels",
"internal_labels_api_friendly"
],
"type": "string",
"description": "How fields are keyed in the payload."
},
"include_subfield_names": {
"type": "boolean",
"description": "Include subfield names in the payload."
}
}
},
"annotations": {
"title": "Create a webhook",
"destructiveHint": true
}
}