Fillout MCP by usefulapi

Working · 2.3 s

io.usefulapi/filloutv1.21.0 Domain verified

Read Fillout forms and submissions, export responses, and create submissions and webhooks.

Data & Databases

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://fillout.usefulapi.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

fillout_count_submissions Read-only

Count a form's submissions matching the same filters as fillout_list_submissions (date range, status, search) without pulling the answers — e.g. 'how many responses this week?' or 'how many partial submissions?'. Reads totalResponses from GET /forms/{formId}/submissions with limit=1.

formIdstring, required

The form's public id (the formId from fillout_list_forms, also the id in the form's share URL).

searchstring

Only submissions containing this text.

statusstring

'finished' (default) or 'in_progress' for unfinished / partial submissions.

afterDatestring

Only submissions submitted after this ISO 8601 date-time, e.g. 2026-09-01T00:00:00Z.

beforeDatestring

Only submissions submitted before this ISO 8601 date-time.

includePreviewboolean

Also include preview (test) responses.

Tools (9)

fillout_count_submissions

read-only

Argument	Type	Description
formId*	string	The form's public id (the formId from fillout_list_forms, also the id in the form's share URL).
search	string	Only submissions containing this text.
status	string	'finished' (default) or 'in_progress' for unfinished / partial submissions.
afterDate	string	Only submissions submitted after this ISO 8601 date-time, e.g. 2026-09-01T00:00:00Z.
beforeDate	string	Only submissions submitted before this ISO 8601 date-time.
includePreview	boolean	Also include preview (test) responses.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "formId"
  ],
  "properties": {
    "formId": {
      "type": "string",
      "minLength": 1,
      "description": "The form's public id (the formId from fillout_list_forms, also the id in the form's share URL)."
    },
    "search": {
      "type": "string",
      "description": "Only submissions containing this text."
    },
    "status": {
      "enum": [
        "finished",
        "in_progress"
      ],
      "type": "string",
      "description": "'finished' (default) or 'in_progress' for unfinished / partial submissions."
    },
    "afterDate": {
      "type": "string",
      "description": "Only submissions submitted after this ISO 8601 date-time, e.g. 2026-09-01T00:00:00Z."
    },
    "beforeDate": {
      "type": "string",
      "description": "Only submissions submitted before this ISO 8601 date-time."
    },
    "includePreview": {
      "type": "boolean",
      "description": "Also include preview (test) responses."
    }
  }
}

fillout_create_submissions

Create up to 10 new submissions on a form, as if respondents had filled it in — e.g. to import responses collected elsewhere. Each submission needs its question answers (question ids from fillout_get_form); URL parameters, scheduling, payments, login email and timestamps are optional. Creates real records that trigger the form's integrations. Fillout: POST /forms/{formId}/submissions.

destructive

Argument	Type	Description
formId*	string	The form's public id (the formId from fillout_list_forms, also the id in the form's share URL).
submissions*	array	1-10 submissions to create.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "formId",
    "submissions"
  ],
  "properties": {
    "formId": {
      "type": "string",
      "minLength": 1,
      "description": "The form's public id (the formId from fillout_list_forms, also the id in the form's share URL)."
    },
    "submissions": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "questions"
        ],
        "properties": {
          "login": {
            "type": "object",
            "required": [
              "email"
            ],
            "properties": {
              "email": {
                "type": "string",
                "description": "Verified respondent email."
              }
            },
            "description": "Login-page information."
          },
          "payments": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "id",
                "value"
              ],
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Payment field id."
                },
                "value": {
                  "type": "object",
                  "required": [
                    "paymentId"
                  ],
                  "properties": {
                    "email": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string"
                    },
                    "currency": {
                      "type": "string"
                    },
                    "paymentId": {
                      "type": "string",
                      "description": "Stripe payment id."
                    },
                    "totalAmount": {
                      "type": "integer",
                      "maximum": 9007199254740991,
                      "minimum": -9007199254740991,
                      "description": "Amount in cents."
                    },
                    "stripeCustomerId": {
                      "type": "string"
                    },
                    "stripePaymentUrl": {
                      "type": "string"
                    },
                    "stripeCustomerUrl": {
                      "type": "string"
                    },
                    "stripeSubscriptionId": {
                      "type": "string"
                    }
                  },
                  "description": "A record of an existing Stripe payment — this does NOT charge anyone."
                }
              }
            },
            "description": "Payment answers (records only; no money moves)."
          },
          "questions": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "id",
                "value"
              ],
              "properties": {
                "id": {
                  "type": "string",
                  "description": "The question id (from fillout_get_form)."
                },
                "value": {
                  "description": "The answer, shaped for the question type (string, number, array of choices, object...)."
                }
              }
            },
            "description": "Answers, one per question id."
          },
          "scheduling": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "id",
                "value"
              ],
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Scheduling field id."
                },
                "value": {
                  "type": "object",
                  "required": [
                    "fullName",
                    "email",
                    "eventStartTime",
                    "eventEndTime",
                    "timezone"
                  ],
                  "properties": {
                    "email": {
                      "type": "string"
                    },
                    "userId": {
                      "type": "integer",
                      "maximum": 9007199254740991,
                      "minimum": -9007199254740991
                    },
                    "eventId": {
                      "type": "string"
                    },
                    "eventUrl": {
                      "type": "string"
                    },
                    "fullName": {
                      "type": "string"
                    },
                    "timezone": {
                      "type": "string",
                      "description": "IANA timezone, e.g. Europe/Prague."
                    },
                    "eventEndTime": {
                      "type": "string",
                      "description": "ISO 8601."
                    },
                    "meetingNotes": {
                      "type": "string"
                    },
                    "eventStartTime": {
                      "type": "string",
                      "description": "ISO 8601."
                    },
                    "scheduledUserEmail": {
                      "type": "string"
                    },
                    "rescheduleOrCancelUrl": {
                      "type": "string"
                    }
                  },
                  "description": "Booking details."
                }
              }
            },
            "description": "Scheduling (booking) answers."
          },
          "lastUpdatedAt": {
            "type": "string",
            "description": "When it was last updated, ISO 8601."
          },
          "urlParameters": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "id",
                "name",
                "value"
              ],
              "properties": {
                "id": {
                  "type": "string",
                  "description": "URL parameter id (from fillout_get_form)."
                },
                "name": {
                  "type": "string",
                  "description": "URL parameter name."
                },
                "value": {
                  "type": "string",
                  "description": "URL parameter value."
                }
              }
            },
            "description": "URL parameter values."
          },
          "submissionTime": {
            "type": "string",
            "description": "When it was submitted, ISO 8601 (default now)."
          }
        }
      },
      "maxItems": 10,
      "minItems": 1,
      "description": "1-10 submissions to create."
    }
  }
}

fillout_create_webhook

Subscribe a URL to a form's new submissions: Fillout will POST each submission (same shape as a fillout_list_submissions entry) to it. Returns the webhook id — keep it, it is the only handle for removing the webhook later. Fillout: POST /webhook/create.

destructive

Argument	Type	Description
url*	string	The HTTPS endpoint that should receive submissions.
formId*	string	The form's public id (the formId from fillout_list_forms, also the id in the form's share URL).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "formId",
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "The HTTPS endpoint that should receive submissions."
    },
    "formId": {
      "type": "string",
      "minLength": 1,
      "description": "The form's public id (the formId from fillout_list_forms, also the id in the form's share URL)."
    }
  }
}

fillout_export_submissions

Fetch many submissions in one call by walking the offset pagination (150 per page, paced under Fillout's 5 requests/second limit), up to max_submissions. Same filters as fillout_list_submissions. Use this for analysis across a whole response set; the result says whether it was truncated. Fillout: GET /forms/{formId}/submissions (repeated).

read-only

Argument	Type	Description
sort	string	'asc' (default, oldest first) or 'desc'.
formId*	string	The form's public id (the formId from fillout_list_forms, also the id in the form's share URL).
search	string	Only submissions containing this text.
status	string	'finished' (default) or 'in_progress' for unfinished / partial submissions.
afterDate	string	Only submissions submitted after this ISO 8601 date-time, e.g. 2026-09-01T00:00:00Z.
beforeDate	string	Only submissions submitted before this ISO 8601 date-time.
includePreview	boolean	Also include preview (test) responses.
max_submissions

fillout_get_form

Fetch one form's metadata: every question (id, name, type), calculations, URL parameters, scheduling and payment fields, and quiz settings. Use the question ids to read answers or to create submissions. Fillout: GET /forms/{formId}.

read-only

Argument	Type	Description
formId*	string	The form's public id (the formId from fillout_list_forms, also the id in the form's share URL).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "formId"
  ],
  "properties": {
    "formId": {
      "type": "string",
      "minLength": 1,
      "description": "The form's public id (the formId from fillout_list_forms, also the id in the form's share URL)."
    }
  }
}

fillout_get_submission

Fetch a single submission by id, with every answer. Fillout: GET /forms/{formId}/submissions/{submissionId}.

read-only

Argument	Type	Description
formId*	string	The form's public id (the formId from fillout_list_forms, also the id in the form's share URL).
submissionId*	string	The submission's id (submissionId).
includeEditLink	boolean	Include an editLink for the submission.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "formId",
    "submissionId"
  ],
  "properties": {
    "formId": {
      "type": "string",
      "minLength": 1,
      "description": "The form's public id (the formId from fillout_list_forms, also the id in the form's share URL)."
    },
    "submissionId": {
      "type": "string",
      "minLength": 1,
      "description": "The submission's id (submissionId)."
    },
    "includeEditLink": {
      "type": "boolean",
      "description": "Include an editLink for the submission."
    }
  }
}

fillout_list_forms

List every form in the Fillout account — each form's name and formId. Start here to find the formId the other tools need. Fillout: GET /forms.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

fillout_list_submissions

List one page of a form's submissions (answers to every question, calculations, URL parameters, scheduling, payments, quiz score, login email), filtered by date range, status or free-text search. Offset pagination: the response carries totalResponses and pageCount. Fillout: GET /forms/{formId}/submissions.

read-only

Argument	Type	Description
sort	string	Sort by submission time: 'asc' (default) or 'desc' for newest first.
limit	integer	Submissions per page, 1-150 (Fillout default 50).
formId*	string	The form's public id (the formId from fillout_list_forms, also the id in the form's share URL).
offset	integer	Starting position (0-based) for this page.
search	string	Only submissions containing this text.
status	string	'finished' (default) or 'in_progress' for unfinished / partial submissions.
afterDate	string	Only submissions submitted after this ISO 8601 date-time, e.g. 2026-09-01T00:00:00Z.
beforeDate	string

fillout_remove_webhook

Stop a webhook from receiving submissions. Recoverable: create it again with fillout_create_webhook (it gets a new id). Fillout: POST /webhook/delete.

destructive

Argument	Type	Description
webhookId*	any	The webhook id returned by fillout_create_webhook.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "webhookId"
  ],
  "properties": {
    "webhookId": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "minimum": -9007199254740991
        }
      ],
      "description": "The webhook id returned by fillout_create_webhook."
    }
  }
}