FoxForm is an MCP server published by io.github.vitorrocha-panda, hosted at mcp.foxform.app. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 10 tools, including foxform_list_forms, foxform_get_form, foxform_list_responses, foxform_get_response, foxform_get_form_analytics.
Build, publish and read scored forms and quizzes where the score picks the next screen.
Nothing else in the archive shares these values.
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 owned by the authenticated FoxForm account, newest first. Args: - page (number): 1-based page number (default 1) - limit (number): page size, 1-100 (default 20) - response_format ('markdown' | 'json'): output format (default markdown) Returns: { total, page, limit, count, forms: [{ id, title, status, slug, public_url, questions_count, updated_at }] } The public link of a form is `public_url` (`https://forms.foxform.app/<slug>`) — always use this exact value, do NOT build the URL yourself (the public domain is forms.foxform.app, not foxform.app). `public_url` is only live when `status` is 'published'. Use this first to discover form IDs, then call foxform_get_form / foxform_get_form_analytics.
| Parameter | Type | Description |
|---|---|---|
| page | integer | 1-based page number |
| limit | integer | Page size (1-100) |
| response_format | string | Output format: 'markdown' (human-readable) or 'json' (machine-readable) |
None yet. Changes appear after a server's second daily check.
{
"name": "foxform_list_forms",
"title": "List FoxForm forms",
"description": "List the forms owned by the authenticated FoxForm account, newest first.\n\nArgs:\n - page (number): 1-based page number (default 1)\n - limit (number): page size, 1-100 (default 20)\n - response_format ('markdown' | 'json'): output format (default markdown)\n\nReturns: { total, page, limit, count, forms: [{ id, title, status, slug, public_url, questions_count, updated_at }] }\nThe public link of a form is `public_url` (`https://forms.foxform.app/<slug>`) — always use this exact value, do NOT build the URL yourself (the public domain is forms.foxform.app, not foxform.app). `public_url` is only live when `status` is 'published'.\nUse this first to discover form IDs, then call foxform_get_form / foxform_get_form_analytics.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "1-based page number"
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Page size (1-100)"
},
"response_format": {
"enum": [
"markdown",
"json"
],
"type": "string",
"default": "markdown",
"description": "Output format: 'markdown' (human-readable) or 'json' (machine-readable)"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Fetch a single form by ID, including its full question list, per-screen conditional logic and settings. Args: - form_id (string): the form's ID (from foxform_list_forms) - response_format ('markdown' | 'json') Returns { form, public_url }: the full form object (id, title, description, slug, status, theme, questions[], thank_you_message, timestamps, plus `format` and — when set — `sections`, `chatbot_skin`, `chatbot_profile`) plus `public_url` — the public link (`https://forms.foxform.app/<slug>`), which is live only when status is 'published'. Use `public_url` verbatim; never build the URL yourself (the public domain is forms.foxform.app, not foxform.app). Each screen in `questions[]` carries its own `logic` (branching / conditional display) and, for choice screens, `choices[]`/`images[]` with their `points` and `value`. The markdown output summarises every rule; use response_format 'json' to get the exact stored objects (that's the shape foxform_update_form expects back). Form format (DEVF-296 / DEVF-322): pass `format` to choose how the form is presented. - 'single_question' (default): one screen at a time (classic). - 'single_page': every screen on one scrollable page. Optionally group screens into pages with `sections`: `[{ id }]` in order (the 'Section N' label comes from position; no editable title). - 'chatbot': an Instagram/WhatsApp DM-style conversation. Set `chatbot_skin` ('instagram' | 'whatsapp', default instagram) and `chatbot_profile` (all fields optional, each with a fallback). The question/branching engine is unchanged — only the presentation differs. These fields require the account's form-format feature to be enabled (live in production); when off the API ignores them and the form stays single_question. End screen ('end'): title + description, an optional button (buttonEnabled false hides it; buttonText, buttonLink, buttonOpenNewTab) and an optional automatic redirect after submit: autoRedirect true + autoRedirectUrl (absolute http/https URL; the form link's query params such as utm_* are passed along and {{param}} tokens are filled from them) + autoRedirectDelay (seconds 0-10, default 3). The response is recorded before the redirect; respondents see a "Redirecting in N s" line with a "Go now" link. CONDITIONAL LOGIC (branching), per screen — stored in `questions[].logic`: logic.conditionalNavigationV2 = { enabled: true, groups: [ // groups are OR-joined; FIRST matching group wins { id: "grp-1", conditions: [ // conditions inside a group are AND-joined { id: "cond-1", left: "{{quer_testar}}", operator: "equal_to", right: "Ainda não" } ], then: { type: "specific_screen", targetScreenId: "s-motivos" } } ] } - `then.type`: 'next_screen' | 'previous_screen' | 'specific_screen' (needs targetScreenId = another screen's `id`) | 'end_form'. Add `then.url` (+ optional `openNewTab`) to redirect to an external URL instead. - `operator`: 'equal_to' | 'not_equal_to' | 'greater_than' | 'greater_or_equal_than' | 'less_than' | 'less_or_equal_than' | 'contains'. - `left`/`right` are EXPRESSION strings: a literal ("10", "Ainda não"), a variable ("{{score}}", "{{minha_var}}" = the screen's `variableName`), or arithmetic ("calc({{peso}}/(({{altura}}/100)*({{altura}}/100)))"). - Comparing an ANSWER: use `left: "{{<variableName of the deciding screen>}}"` and `right` = the option's `label` OR its `value` (both match). - `{{score}}` is the running sum of `points` on the options picked so far (`choices[].points`, `images[].points`) — that is how score-based branching works. - A navigation group with no conditions NEVER matches. `enabled: false` stores the rules but disables them. - Screen-level conditional display uses the same group shape: `logic.display = { enabled: true, groups: [...], showAfterSeconds?: n }` (`then` is ignored — THEN means "show"). - Other logic keys: `logic.autoAdvance = { enabled, delaySeconds
| Parameter | Type | Description |
|---|---|---|
| form_id * | string | Form ID |
| response_format | string | Output format: 'markdown' (human-readable) or 'json' (machine-readable) |
{
"name": "foxform_get_form",
"title": "Get a FoxForm form",
"description": "Fetch a single form by ID, including its full question list, per-screen conditional logic and settings.\n\nArgs:\n - form_id (string): the form's ID (from foxform_list_forms)\n - response_format ('markdown' | 'json')\n\nReturns { form, public_url }: the full form object (id, title, description, slug, status, theme, questions[], thank_you_message, timestamps, plus `format` and — when set — `sections`, `chatbot_skin`, `chatbot_profile`) plus `public_url` — the public link (`https://forms.foxform.app/<slug>`), which is live only when status is 'published'. Use `public_url` verbatim; never build the URL yourself (the public domain is forms.foxform.app, not foxform.app).\nEach screen in `questions[]` carries its own `logic` (branching / conditional display) and, for choice screens, `choices[]`/`images[]` with their `points` and `value`. The markdown output summarises every rule; use response_format 'json' to get the exact stored objects (that's the shape foxform_update_form expects back).\n\nForm format (DEVF-296 / DEVF-322): pass `format` to choose how the form is presented.\n- 'single_question' (default): one screen at a time (classic).\n- 'single_page': every screen on one scrollable page. Optionally group screens into pages with `sections`: `[{ id }]` in order (the 'Section N' label comes from position; no editable title).\n- 'chatbot': an Instagram/WhatsApp DM-style conversation. Set `chatbot_skin` ('instagram' | 'whatsapp', default instagram) and `chatbot_profile` (all fields optional, each with a fallback). The question/branching engine is unchanged — only the presentation differs.\nThese fields require the account's form-format feature to be enabled (live in production); when off the API ignores them and the form stays single_question.\n\nEnd screen ('end'): title + description, an optional button (buttonEnabled false hides it; buttonText, buttonLink, buttonOpenNewTab) and an optional automatic redirect after submit: autoRedirect true + autoRedirectUrl (absolute http/https URL; the form link's query params such as utm_* are passed along and {{param}} tokens are filled from them) + autoRedirectDelay (seconds 0-10, default 3). The response is recorded before the redirect; respondents see a \"Redirecting in N s\" line with a \"Go now\" link.\n\nCONDITIONAL LOGIC (branching), per screen — stored in `questions[].logic`:\n\n logic.conditionalNavigationV2 = {\n enabled: true,\n groups: [ // groups are OR-joined; FIRST matching group wins\n {\n id: \"grp-1\",\n conditions: [ // conditions inside a group are AND-joined\n { id: \"cond-1\", left: \"{{quer_testar}}\", operator: \"equal_to\", right: \"Ainda não\" }\n ],\n then: { type: \"specific_screen\", targetScreenId: \"s-motivos\" }\n }\n ]\n }\n\n- `then.type`: 'next_screen' | 'previous_screen' | 'specific_screen' (needs targetScreenId = another screen's `id`) | 'end_form'.\n Add `then.url` (+ optional `openNewTab`) to redirect to an external URL instead.\n- `operator`: 'equal_to' | 'not_equal_to' | 'greater_than' | 'greater_or_equal_than' | 'less_than' | 'less_or_equal_than' | 'contains'.\n- `left`/`right` are EXPRESSION strings: a literal (\"10\", \"Ainda não\"), a variable (\"{{score}}\", \"{{minha_var}}\" = the screen's `variableName`), or arithmetic (\"calc({{peso}}/(({{altura}}/100)*({{altura}}/100)))\").\n- Comparing an ANSWER: use `left: \"{{<variableName of the deciding screen>}}\"` and `right` = the option's `label` OR its `value` (both match).\n- `{{score}}` is the running sum of `points` on the options picked so far (`choices[].points`, `images[].points`) — that is how score-based branching works.\n- A navigation group with no conditions NEVER matches. `enabled: false` stores the rules but disables them.\n- Screen-level conditional display uses the same group shape: `logic.display = { enabled: true, groups: [...], showAfterSeconds?: n }` (`then` is ignored — THEN means \"show\").\n- Other logic keys: `logic.autoAdvance = { enabled, delaySeconds",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"form_id"
],
"properties": {
"form_id": {
"type": "string",
"minLength": 1,
"description": "Form ID"
},
"response_format": {
"enum": [
"markdown",
"json"
],
"type": "string",
"default": "markdown",
"description": "Output format: 'markdown' (human-readable) or 'json' (machine-readable)"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List submitted responses for a form, newest first. Args: - form_id (string): the form's ID - page (number): 1-based page (default 1) - limit (number): page size, 1-100 (default 20) - response_format ('markdown' | 'json') Returns: { total, page, limit, count, responses: [{ id, submitted_at, answers }] }. For aggregate metrics use foxform_get_form_analytics; for a full dump use foxform_export_responses.
| Parameter | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| form_id * | string | Form ID |
| response_format | string | Output format: 'markdown' (human-readable) or 'json' (machine-readable) |
{
"name": "foxform_list_responses",
"title": "List form responses",
"description": "List submitted responses for a form, newest first.\n\nArgs:\n - form_id (string): the form's ID\n - page (number): 1-based page (default 1)\n - limit (number): page size, 1-100 (default 20)\n - response_format ('markdown' | 'json')\n\nReturns: { total, page, limit, count, responses: [{ id, submitted_at, answers }] }.\nFor aggregate metrics use foxform_get_form_analytics; for a full dump use foxform_export_responses.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"form_id"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
},
"form_id": {
"type": "string",
"minLength": 1,
"description": "Form ID"
},
"response_format": {
"enum": [
"markdown",
"json"
],
"type": "string",
"default": "markdown",
"description": "Output format: 'markdown' (human-readable) or 'json' (machine-readable)"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Fetch one response by its ID (from foxform_list_responses). Args: - response_id (string) - response_format ('markdown' | 'json') Returns the full response object (id, form_id, answers, submitted_at, metadata).
| Parameter | Type | Description |
|---|---|---|
| response_id * | string | Response ID |
| response_format | string | Output format: 'markdown' (human-readable) or 'json' (machine-readable) |
{
"name": "foxform_get_response",
"title": "Get a single response",
"description": "Fetch one response by its ID (from foxform_list_responses).\n\nArgs:\n - response_id (string)\n - response_format ('markdown' | 'json')\n\nReturns the full response object (id, form_id, answers, submitted_at, metadata).",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"response_id"
],
"properties": {
"response_id": {
"type": "string",
"minLength": 1,
"description": "Response ID"
},
"response_format": {
"enum": [
"markdown",
"json"
],
"type": "string",
"default": "markdown",
"description": "Output format: 'markdown' (human-readable) or 'json' (machine-readable)"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Aggregated analytics for a form: overview KPIs (total responses, form views, response rate, avg response time), the responses-over-time timeline, and per-question stats. Args: - form_id (string) - response_format ('markdown' | 'json') Returns: { overview, timeline: [{date,count}], questions: [...], response_time_distribution?, views_timeline? }. Note: form_views / response_rate are null until the form has tracked views (forward-only).
| Parameter | Type | Description |
|---|---|---|
| form_id * | string | Form ID |
| response_format | string | Output format: 'markdown' (human-readable) or 'json' (machine-readable) |
{
"name": "foxform_get_form_analytics",
"title": "Get form analytics",
"description": "Aggregated analytics for a form: overview KPIs (total responses, form views, response rate, avg response time), the responses-over-time timeline, and per-question stats.\n\nArgs:\n - form_id (string)\n - response_format ('markdown' | 'json')\n\nReturns: { overview, timeline: [{date,count}], questions: [...], response_time_distribution?, views_timeline? }.\nNote: form_views / response_rate are null until the form has tracked views (forward-only).",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"form_id"
],
"properties": {
"form_id": {
"type": "string",
"minLength": 1,
"description": "Form ID"
},
"response_format": {
"enum": [
"markdown",
"json"
],
"type": "string",
"default": "markdown",
"description": "Output format: 'markdown' (human-readable) or 'json' (machine-readable)"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Export all responses for a form as CSV text (one row per response, columns = questions). Large exports are truncated — use foxform_list_responses with pagination for very large datasets. Args: - form_id (string) Returns: raw CSV text.
| Parameter | Type | Description |
|---|---|---|
| form_id * | string | Form ID |
{
"name": "foxform_export_responses",
"title": "Export responses as CSV",
"description": "Export all responses for a form as CSV text (one row per response, columns = questions). Large exports are truncated — use foxform_list_responses with pagination for very large datasets.\n\nArgs:\n - form_id (string)\n\nReturns: raw CSV text.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"form_id"
],
"properties": {
"form_id": {
"type": "string",
"minLength": 1,
"description": "Form ID"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Create a new form, including per-screen conditional logic. Requires a WRITE-scoped API key. Args: - title (string): form title (required) - description (string, optional) - theme (string, optional): one of amber|base|midnight|ocean|sunset|forest|lavender|minimal (default amber, the copper-to-amber FoxForm theme) - questions (array, optional): array of screen objects ({ id, type, title, required, variableName?, choices?, logic?, ... }); omit to start empty - thank_you_message (string, optional) - format ('single_question' | 'single_page' | 'chatbot', optional): how the form is presented (see below) - sections (array, optional): single_page page groups, [{ id }] - chatbot_skin ('instagram' | 'whatsapp', optional): chatbot chrome - chatbot_profile (object, optional): chatbot header profile ({ name, handle, followers_text, phone, status, verified, avatar_url }) Returns: { form } with the created form (including its id and slug). The form starts as a draft — call foxform_publish_form to make it live. Screen fields are validated: unknown fields are REJECTED instead of being stored and ignored, and branching rules are cross-checked against the screen ids in the same payload. Form format (DEVF-296 / DEVF-322): pass `format` to choose how the form is presented. - 'single_question' (default): one screen at a time (classic). - 'single_page': every screen on one scrollable page. Optionally group screens into pages with `sections`: `[{ id }]` in order (the 'Section N' label comes from position; no editable title). - 'chatbot': an Instagram/WhatsApp DM-style conversation. Set `chatbot_skin` ('instagram' | 'whatsapp', default instagram) and `chatbot_profile` (all fields optional, each with a fallback). The question/branching engine is unchanged — only the presentation differs. These fields require the account's form-format feature to be enabled (live in production); when off the API ignores them and the form stays single_question. End screen ('end'): title + description, an optional button (buttonEnabled false hides it; buttonText, buttonLink, buttonOpenNewTab) and an optional automatic redirect after submit: autoRedirect true + autoRedirectUrl (absolute http/https URL; the form link's query params such as utm_* are passed along and {{param}} tokens are filled from them) + autoRedirectDelay (seconds 0-10, default 3). The response is recorded before the redirect; respondents see a "Redirecting in N s" line with a "Go now" link. CONDITIONAL LOGIC (branching), per screen — stored in `questions[].logic`: logic.conditionalNavigationV2 = { enabled: true, groups: [ // groups are OR-joined; FIRST matching group wins { id: "grp-1", conditions: [ // conditions inside a group are AND-joined { id: "cond-1", left: "{{quer_testar}}", operator: "equal_to", right: "Ainda não" } ], then: { type: "specific_screen", targetScreenId: "s-motivos" } } ] } - `then.type`: 'next_screen' | 'previous_screen' | 'specific_screen' (needs targetScreenId = another screen's `id`) | 'end_form'. Add `then.url` (+ optional `openNewTab`) to redirect to an external URL instead. - `operator`: 'equal_to' | 'not_equal_to' | 'greater_than' | 'greater_or_equal_than' | 'less_than' | 'less_or_equal_than' | 'contains'. - `left`/`right` are EXPRESSION strings: a literal ("10", "Ainda não"), a variable ("{{score}}", "{{minha_var}}" = the screen's `variableName`), or arithmetic ("calc({{peso}}/(({{altura}}/100)*({{altura}}/100)))"). - Comparing an ANSWER: use `left: "{{<variableName of the deciding screen>}}"` and `right` = the option's `label` OR its `value` (both match). - `{{score}}` is the running sum of `points` on the options picked so far (`choices[].points`, `images[].points`) — that is how score-based branching works. - A navigation group with no conditions NEVER matches. `enabled: false` stores the rules but disables them. - Screen-level conditional
| Parameter | Type | Description |
|---|---|---|
| theme | string | Theme key: amber|base|midnight|ocean|sunset|forest|lavender|minimal (default amber) |
| title * | string | Form title |
| format | string | Form format: 'single_question' (default — one screen at a time), 'single_page' (all screens on one scrollable page, grouped by `sections`), or 'chatbot' (an Instagram/WhatsApp DM-style conversation; set `chatbot_skin` + `chatbot_profile`). |
| sections | array | single_page only: the page groups as `[{ id }]`, in order. The 'Section N' label is derived from position; sections have no editable title. |
| questions | array | Screen objects; omit for an empty form. Conditional logic goes in each screen's `logic` (see the tool description). |
| description | string | Optional description |
| chatbot_skin | string | chatbot only: chat chrome to imitate — 'instagram' (default) or 'whatsapp'. |
| chatbot_profile | object | chatbot only: the profile shown in the chat header. |
| thank_you_message | string |
{
"name": "foxform_create_form",
"title": "Create a FoxForm form",
"description": "Create a new form, including per-screen conditional logic. Requires a WRITE-scoped API key.\n\nArgs:\n - title (string): form title (required)\n - description (string, optional)\n - theme (string, optional): one of amber|base|midnight|ocean|sunset|forest|lavender|minimal (default amber, the copper-to-amber FoxForm theme)\n - questions (array, optional): array of screen objects ({ id, type, title, required, variableName?, choices?, logic?, ... }); omit to start empty\n - thank_you_message (string, optional)\n - format ('single_question' | 'single_page' | 'chatbot', optional): how the form is presented (see below)\n - sections (array, optional): single_page page groups, [{ id }]\n - chatbot_skin ('instagram' | 'whatsapp', optional): chatbot chrome\n - chatbot_profile (object, optional): chatbot header profile ({ name, handle, followers_text, phone, status, verified, avatar_url })\n\nReturns: { form } with the created form (including its id and slug). The form starts as a draft — call foxform_publish_form to make it live.\n\nScreen fields are validated: unknown fields are REJECTED instead of being stored and ignored, and branching rules are cross-checked against the screen ids in the same payload.\n\nForm format (DEVF-296 / DEVF-322): pass `format` to choose how the form is presented.\n- 'single_question' (default): one screen at a time (classic).\n- 'single_page': every screen on one scrollable page. Optionally group screens into pages with `sections`: `[{ id }]` in order (the 'Section N' label comes from position; no editable title).\n- 'chatbot': an Instagram/WhatsApp DM-style conversation. Set `chatbot_skin` ('instagram' | 'whatsapp', default instagram) and `chatbot_profile` (all fields optional, each with a fallback). The question/branching engine is unchanged — only the presentation differs.\nThese fields require the account's form-format feature to be enabled (live in production); when off the API ignores them and the form stays single_question.\n\nEnd screen ('end'): title + description, an optional button (buttonEnabled false hides it; buttonText, buttonLink, buttonOpenNewTab) and an optional automatic redirect after submit: autoRedirect true + autoRedirectUrl (absolute http/https URL; the form link's query params such as utm_* are passed along and {{param}} tokens are filled from them) + autoRedirectDelay (seconds 0-10, default 3). The response is recorded before the redirect; respondents see a \"Redirecting in N s\" line with a \"Go now\" link.\n\nCONDITIONAL LOGIC (branching), per screen — stored in `questions[].logic`:\n\n logic.conditionalNavigationV2 = {\n enabled: true,\n groups: [ // groups are OR-joined; FIRST matching group wins\n {\n id: \"grp-1\",\n conditions: [ // conditions inside a group are AND-joined\n { id: \"cond-1\", left: \"{{quer_testar}}\", operator: \"equal_to\", right: \"Ainda não\" }\n ],\n then: { type: \"specific_screen\", targetScreenId: \"s-motivos\" }\n }\n ]\n }\n\n- `then.type`: 'next_screen' | 'previous_screen' | 'specific_screen' (needs targetScreenId = another screen's `id`) | 'end_form'.\n Add `then.url` (+ optional `openNewTab`) to redirect to an external URL instead.\n- `operator`: 'equal_to' | 'not_equal_to' | 'greater_than' | 'greater_or_equal_than' | 'less_than' | 'less_or_equal_than' | 'contains'.\n- `left`/`right` are EXPRESSION strings: a literal (\"10\", \"Ainda não\"), a variable (\"{{score}}\", \"{{minha_var}}\" = the screen's `variableName`), or arithmetic (\"calc({{peso}}/(({{altura}}/100)*({{altura}}/100)))\").\n- Comparing an ANSWER: use `left: \"{{<variableName of the deciding screen>}}\"` and `right` = the option's `label` OR its `value` (both match).\n- `{{score}}` is the running sum of `points` on the options picked so far (`choices[].points`, `images[].points`) — that is how score-based branching works.\n- A navigation group with no conditions NEVER matches. `enabled: false` stores the rules but disables them.\n- Screen-level conditional",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"title"
],
"properties": {
"theme": {
"type": "string",
"description": "Theme key: amber|base|midnight|ocean|sunset|forest|lavender|minimal (default amber)"
},
"title": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Form title"
},
"format": {
"enum": [
"single_question",
"single_page",
"chatbot"
],
"type": "string",
"description": "Form format: 'single_question' (default — one screen at a time), 'single_page' (all screens on one scrollable page, grouped by `sections`), or 'chatbot' (an Instagram/WhatsApp DM-style conversation; set `chatbot_skin` + `chatbot_profile`)."
},
"sections": {
"type": "array",
"items": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "single_page only: the page groups as `[{ id }]`, in order. The 'Section N' label is derived from position; sections have no editable title."
},
"questions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
},
"description": "Screen objects; omit for an empty form. Conditional logic goes in each screen's `logic` (see the tool description)."
},
"description": {
"type": "string",
"maxLength": 2000,
"description": "Optional description"
},
"chatbot_skin": {
"enum": [
"instagram",
"whatsapp"
],
"type": "string",
"description": "chatbot only: chat chrome to imitate — 'instagram' (default) or 'whatsapp'."
},
"chatbot_profile": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Display name in the chat header (both skins; default 'Sua Marca')."
},
"phone": {
"type": "string",
"description": "Shown phone number (WhatsApp skin only)."
},
"handle": {
"type": "string",
"description": "Instagram @handle (Instagram skin only)."
},
"status": {
"type": "string",
"description": "Header status line (both skins; empty on WhatsApp shows the phone)."
},
"verified": {
"type": "boolean",
"description": "Blue verified badge (Instagram only; default true)."
},
"avatar_url": {
"type": "string",
"description": "Avatar image URL; falls back to the name's initials."
},
"followers_text": {
"type": "string",
"description": "Free text under the name, e.g. followers/posts (Instagram only)."
}
},
"description": "chatbot only: the profile shown in the chat header.",
"additionalProperties": false
},
"thank_you_message": {
"type": "string",
"maxLength": 2000
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Update an existing form's fields, including each screen's conditional logic (branching). Requires a WRITE-scoped API key. Only the fields you pass are changed. Args: - form_id (string): the form to update (required) - title (string, optional) - description (string, optional) - theme (string, optional): one of amber|base|midnight|ocean|sunset|forest|lavender|minimal - questions (array, optional): replaces the FULL screen list — there is no per-screen patch. To add logic to one screen: call foxform_get_form with response_format 'json', edit that screen's `logic`, and send the whole array back. - thank_you_message (string, optional) - format ('single_question' | 'single_page' | 'chatbot', optional) - sections (array, optional): single_page page groups, [{ id }] - chatbot_skin ('instagram' | 'whatsapp', optional) - chatbot_profile (object, optional): chatbot header profile ({ name, handle, followers_text, phone, status, verified, avatar_url }) Returns: { form } with the updated form. Screen fields are validated: unknown fields are REJECTED instead of being stored and ignored (the API accepts arbitrary keys but no renderer reads them), `then.targetScreenId` must be the id of a screen in the same payload, and `{{variables}}` that no screen exposes come back as warnings. Form format (DEVF-296 / DEVF-322): pass `format` to choose how the form is presented. - 'single_question' (default): one screen at a time (classic). - 'single_page': every screen on one scrollable page. Optionally group screens into pages with `sections`: `[{ id }]` in order (the 'Section N' label comes from position; no editable title). - 'chatbot': an Instagram/WhatsApp DM-style conversation. Set `chatbot_skin` ('instagram' | 'whatsapp', default instagram) and `chatbot_profile` (all fields optional, each with a fallback). The question/branching engine is unchanged — only the presentation differs. These fields require the account's form-format feature to be enabled (live in production); when off the API ignores them and the form stays single_question. End screen ('end'): title + description, an optional button (buttonEnabled false hides it; buttonText, buttonLink, buttonOpenNewTab) and an optional automatic redirect after submit: autoRedirect true + autoRedirectUrl (absolute http/https URL; the form link's query params such as utm_* are passed along and {{param}} tokens are filled from them) + autoRedirectDelay (seconds 0-10, default 3). The response is recorded before the redirect; respondents see a "Redirecting in N s" line with a "Go now" link. CONDITIONAL LOGIC (branching), per screen — stored in `questions[].logic`: logic.conditionalNavigationV2 = { enabled: true, groups: [ // groups are OR-joined; FIRST matching group wins { id: "grp-1", conditions: [ // conditions inside a group are AND-joined { id: "cond-1", left: "{{quer_testar}}", operator: "equal_to", right: "Ainda não" } ], then: { type: "specific_screen", targetScreenId: "s-motivos" } } ] } - `then.type`: 'next_screen' | 'previous_screen' | 'specific_screen' (needs targetScreenId = another screen's `id`) | 'end_form'. Add `then.url` (+ optional `openNewTab`) to redirect to an external URL instead. - `operator`: 'equal_to' | 'not_equal_to' | 'greater_than' | 'greater_or_equal_than' | 'less_than' | 'less_or_equal_than' | 'contains'. - `left`/`right` are EXPRESSION strings: a literal ("10", "Ainda não"), a variable ("{{score}}", "{{minha_var}}" = the screen's `variableName`), or arithmetic ("calc({{peso}}/(({{altura}}/100)*({{altura}}/100)))"). - Comparing an ANSWER: use `left: "{{<variableName of the deciding screen>}}"` and `right` = the option's `label` OR its `value` (both match). - `{{score}}` is the running sum of `points` on the options picked so far (`choices[].points`, `images[].points`) — that is how score-based branching works. - A navigation group with no condi
| Parameter | Type | Description |
|---|---|---|
| theme | string | |
| title | string | |
| format | string | Form format: 'single_question' (default — one screen at a time), 'single_page' (all screens on one scrollable page, grouped by `sections`), or 'chatbot' (an Instagram/WhatsApp DM-style conversation; set `chatbot_skin` + `chatbot_profile`). |
| form_id * | string | Form ID |
| sections | array | single_page only: the page groups as `[{ id }]`, in order. The 'Section N' label is derived from position; sections have no editable title. |
| questions | array | Replaces the full screen list. Conditional logic goes in each screen's `logic` (see the tool description). |
| description | string | |
| chatbot_skin | string | chatbot only: chat chrome to imitate — 'instagram' (default) or 'whatsapp'. |
| chatbot_profile | object | chatbot only: the profile shown in the chat header. |
| thank_you_message | string |
{
"name": "foxform_update_form",
"title": "Update a FoxForm form",
"description": "Update an existing form's fields, including each screen's conditional logic (branching). Requires a WRITE-scoped API key. Only the fields you pass are changed.\n\nArgs:\n - form_id (string): the form to update (required)\n - title (string, optional)\n - description (string, optional)\n - theme (string, optional): one of amber|base|midnight|ocean|sunset|forest|lavender|minimal\n - questions (array, optional): replaces the FULL screen list — there is no per-screen patch. To add logic to one screen: call foxform_get_form with response_format 'json', edit that screen's `logic`, and send the whole array back.\n - thank_you_message (string, optional)\n - format ('single_question' | 'single_page' | 'chatbot', optional)\n - sections (array, optional): single_page page groups, [{ id }]\n - chatbot_skin ('instagram' | 'whatsapp', optional)\n - chatbot_profile (object, optional): chatbot header profile ({ name, handle, followers_text, phone, status, verified, avatar_url })\n\nReturns: { form } with the updated form.\n\nScreen fields are validated: unknown fields are REJECTED instead of being stored and ignored (the API accepts arbitrary keys but no renderer reads them), `then.targetScreenId` must be the id of a screen in the same payload, and `{{variables}}` that no screen exposes come back as warnings.\n\nForm format (DEVF-296 / DEVF-322): pass `format` to choose how the form is presented.\n- 'single_question' (default): one screen at a time (classic).\n- 'single_page': every screen on one scrollable page. Optionally group screens into pages with `sections`: `[{ id }]` in order (the 'Section N' label comes from position; no editable title).\n- 'chatbot': an Instagram/WhatsApp DM-style conversation. Set `chatbot_skin` ('instagram' | 'whatsapp', default instagram) and `chatbot_profile` (all fields optional, each with a fallback). The question/branching engine is unchanged — only the presentation differs.\nThese fields require the account's form-format feature to be enabled (live in production); when off the API ignores them and the form stays single_question.\n\nEnd screen ('end'): title + description, an optional button (buttonEnabled false hides it; buttonText, buttonLink, buttonOpenNewTab) and an optional automatic redirect after submit: autoRedirect true + autoRedirectUrl (absolute http/https URL; the form link's query params such as utm_* are passed along and {{param}} tokens are filled from them) + autoRedirectDelay (seconds 0-10, default 3). The response is recorded before the redirect; respondents see a \"Redirecting in N s\" line with a \"Go now\" link.\n\nCONDITIONAL LOGIC (branching), per screen — stored in `questions[].logic`:\n\n logic.conditionalNavigationV2 = {\n enabled: true,\n groups: [ // groups are OR-joined; FIRST matching group wins\n {\n id: \"grp-1\",\n conditions: [ // conditions inside a group are AND-joined\n { id: \"cond-1\", left: \"{{quer_testar}}\", operator: \"equal_to\", right: \"Ainda não\" }\n ],\n then: { type: \"specific_screen\", targetScreenId: \"s-motivos\" }\n }\n ]\n }\n\n- `then.type`: 'next_screen' | 'previous_screen' | 'specific_screen' (needs targetScreenId = another screen's `id`) | 'end_form'.\n Add `then.url` (+ optional `openNewTab`) to redirect to an external URL instead.\n- `operator`: 'equal_to' | 'not_equal_to' | 'greater_than' | 'greater_or_equal_than' | 'less_than' | 'less_or_equal_than' | 'contains'.\n- `left`/`right` are EXPRESSION strings: a literal (\"10\", \"Ainda não\"), a variable (\"{{score}}\", \"{{minha_var}}\" = the screen's `variableName`), or arithmetic (\"calc({{peso}}/(({{altura}}/100)*({{altura}}/100)))\").\n- Comparing an ANSWER: use `left: \"{{<variableName of the deciding screen>}}\"` and `right` = the option's `label` OR its `value` (both match).\n- `{{score}}` is the running sum of `points` on the options picked so far (`choices[].points`, `images[].points`) — that is how score-based branching works.\n- A navigation group with no condi",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"form_id"
],
"properties": {
"theme": {
"type": "string"
},
"title": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"format": {
"enum": [
"single_question",
"single_page",
"chatbot"
],
"type": "string",
"description": "Form format: 'single_question' (default — one screen at a time), 'single_page' (all screens on one scrollable page, grouped by `sections`), or 'chatbot' (an Instagram/WhatsApp DM-style conversation; set `chatbot_skin` + `chatbot_profile`)."
},
"form_id": {
"type": "string",
"minLength": 1,
"description": "Form ID"
},
"sections": {
"type": "array",
"items": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "single_page only: the page groups as `[{ id }]`, in order. The 'Section N' label is derived from position; sections have no editable title."
},
"questions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
},
"description": "Replaces the full screen list. Conditional logic goes in each screen's `logic` (see the tool description)."
},
"description": {
"type": "string",
"maxLength": 2000
},
"chatbot_skin": {
"enum": [
"instagram",
"whatsapp"
],
"type": "string",
"description": "chatbot only: chat chrome to imitate — 'instagram' (default) or 'whatsapp'."
},
"chatbot_profile": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Display name in the chat header (both skins; default 'Sua Marca')."
},
"phone": {
"type": "string",
"description": "Shown phone number (WhatsApp skin only)."
},
"handle": {
"type": "string",
"description": "Instagram @handle (Instagram skin only)."
},
"status": {
"type": "string",
"description": "Header status line (both skins; empty on WhatsApp shows the phone)."
},
"verified": {
"type": "boolean",
"description": "Blue verified badge (Instagram only; default true)."
},
"avatar_url": {
"type": "string",
"description": "Avatar image URL; falls back to the name's initials."
},
"followers_text": {
"type": "string",
"description": "Free text under the name, e.g. followers/posts (Instagram only)."
}
},
"description": "chatbot only: the profile shown in the chat header.",
"additionalProperties": false
},
"thank_you_message": {
"type": "string",
"maxLength": 2000
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Publish a form so it's live at its public URL and can accept responses. Requires a WRITE-scoped API key. Args: - form_id (string) Returns: { form, public_url } — the published form (status 'published') and its live public link `https://forms.foxform.app/<slug>`. When sharing the link with the user, use `public_url` EXACTLY as returned; do NOT build the URL yourself (the public domain is forms.foxform.app, NOT foxform.app or the API/app domain). (May fail with a plan-limit error on Free accounts.)
| Parameter | Type | Description |
|---|---|---|
| form_id * | string | Form ID |
{
"name": "foxform_publish_form",
"title": "Publish a form",
"description": "Publish a form so it's live at its public URL and can accept responses. Requires a WRITE-scoped API key.\n\nArgs:\n - form_id (string)\n\nReturns: { form, public_url } — the published form (status 'published') and its live public link `https://forms.foxform.app/<slug>`. When sharing the link with the user, use `public_url` EXACTLY as returned; do NOT build the URL yourself (the public domain is forms.foxform.app, NOT foxform.app or the API/app domain). (May fail with a plan-limit error on Free accounts.)",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"form_id"
],
"properties": {
"form_id": {
"type": "string",
"minLength": 1,
"description": "Form ID"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Unpublish a form (takes it offline; stops accepting responses). Requires a WRITE-scoped API key. Args: - form_id (string) Returns: a confirmation message.
| Parameter | Type | Description |
|---|---|---|
| form_id * | string | Form ID |
{
"name": "foxform_unpublish_form",
"title": "Unpublish a form",
"description": "Unpublish a form (takes it offline; stops accepting responses). Requires a WRITE-scoped API key.\n\nArgs:\n - form_id (string)\n\nReturns: a confirmation message.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"form_id"
],
"properties": {
"form_id": {
"type": "string",
"minLength": 1,
"description": "Form ID"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Names, descriptions and schemas were written by the server and are shown as data.