Getform MCP by usefulapi

List the submissions of one Getform (Forminit) form, one page at a time: id, date, status (open/closed/spam) and every submitted answer (sender name/email/phone and fields). This is personal data: use query, a small size, or include_answers=false when you need less. Needs a paid Getform plan (the read API). GET /v1/forms/{formId}.

{
  "type": "object",
  "properties": {
    "form_id": {
      "description": "The form id (the last part of the form's endpoint URL). Default: the form you entered at sign-in.",
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,100}$"
    },
    "page": {
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100000
    },
    "size": {
      "description": "Submissions per page, 1-100 (default 30).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "query": {
      "description": "Only submissions that contain this keyword, e.g. an email address.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "include_answers": {
      "description": "Return the sender details and answers of each submission (default true). Pass false to get only id, date and status.",
      "type": "boolean"
    },
    "include_files": {
      "description": "Also return file attachment metadata and download links (default false).",
      "type": "boolean"
    },
    "timezone": {
      "description": "IANA time zone for the dates, e.g. Europe/London (default UTC).",
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

WRITE: create ONE new submission on a Getform (Forminit) form, as if a visitor had filled it in. The form's own workflow then runs: notification emails, autoresponder to the sender's email, webhooks, Slack, Google Sheets. It counts against the plan's monthly submissions and can not be undone from here. Use it only when the user asked for a submission, and with the data the user gave. Never retried. POST /f/{formId}. Returns only the new submission's id and date.

{
  "type": "object",
  "properties": {
    "form_id": {
      "description": "The form id (the last part of the form's endpoint URL). Default: the form you entered at sign-in.",
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,100}$"
    },
    "sender": {
      "description": "Who is submitting. Getform needs at least one of email, fullName, firstName, lastName or phone.",
      "type": "object",
      "properties": {
        "email": {
          "type": "string",
          "maxLength": 320
        },
        "fullName": {
          "type": "string",
          "maxLength": 200
        },
        "firstName": {
          "type": "string",
          "maxLength": 100
        },
        "lastName": {
          "type": "string",
          "maxLength": 100
        },
        "phone": {
          "description": "E.164, e.g. +12025550123.",
          "type": "string",
          "maxLength": 40
        },
        "company": {
          "type": "string",
          "maxLength": 200
        },
        "position": {
          "type": "string",
          "maxLength": 200
        },
        "country": {
          "description": "ISO 3166-1 alpha-2, e.g. US.",
          "type": "string",
          "minLength": 2,
          "maxLength": 2
        }
      },
      "additionalProperties": false
    },
    "fields": {
      "description": "Field blocks; every name must be unique. File uploads are not supported.",
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "text",
              "number",
              "email",
              "phone",
              "url",
              "date",
              "rating",
              "select",
              "radio",
              "checkbox",
              "country"
            ],
            "description": "Block type: text, number, email, phone (E.164), url, date (ISO 8601), rating (1-5), select/radio/checkbox, country (ISO alpha-2)."
          },
          "name": {
            "type": "string",
            "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$",
            "description": "Unique field name, e.g. message."
          },
          "value": {
            "anyOf": [
              {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 10000
                  },
                  {
                    "type": "number"
                  },
                  {
                    "type": "boolean"
                  }
                ]
              },
              {
                "maxItems": 100,
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 1000
                }
              }
            ],
            "description": "The value; select and checkbox also take a list of strings."
          }
        },
        "required": [
          "type",
          "name",
          "value"
        ],
        "additionalProperties": false
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}