create_form

Generate and configure Tally forms by defining fields and set publication status. Automatically converts field definitions into Tally’s block-based format, simplifying form creation.

Instructions

Create a new Tally form with specified fields and configuration. This tool converts simple field definitions into Tally's complex blocks-based structure automatically. The status field is optional and defaults to DRAFT if not specified.

Input Schema

Name	Required	Description	Default
`description`	No	Optional form description - displayed below the title to provide context
`fields`	Yes	Array of form fields/questions. Each field will be converted to appropriate Tally blocks automatically.
`status`	No	Form publication status. Use DRAFT for unpublished forms that are being worked on, or PUBLISHED for live forms. Defaults to DRAFT if not specified.	DRAFT
`title`	Yes	Form title (required) - will be displayed as the main form heading

Input Schema (JSON Schema)

{
  "additionalProperties": false,
  "examples": [
    {
      "description": "Help us improve our service",
      "fields": [
        {
          "label": "What is your name?",
          "required": true,
          "type": "text"
        },
        {
          "label": "Email address",
          "required": true,
          "type": "email"
        },
        {
          "label": "How would you rate our service?",
          "options": [
            "Excellent",
            "Good",
            "Fair",
            "Poor"
          ],
          "required": false,
          "type": "select"
        }
      ],
      "status": "DRAFT",
      "title": "Customer Feedback Survey"
    }
  ],
  "properties": {
    "description": {
      "description": "Optional form description - displayed below the title to provide context",
      "type": "string"
    },
    "fields": {
      "description": "Array of form fields/questions. Each field will be converted to appropriate Tally blocks automatically.",
      "items": {
        "additionalProperties": false,
        "properties": {
          "label": {
            "description": "Field label/question text - what the user will see",
            "minLength": 1,
            "type": "string"
          },
          "options": {
            "description": "Available options for select, checkbox, or radio field types. Required for select/checkbox/radio fields.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "required": {
            "default": false,
            "description": "Whether this field must be filled out before form submission",
            "type": "boolean"
          },
          "type": {
            "description": "Field input type. Maps to Tally blocks: text→INPUT_TEXT, email→INPUT_EMAIL, number→INPUT_NUMBER, textarea→TEXTAREA, select→DROPDOWN, checkbox→CHECKBOXES, radio→MULTIPLE_CHOICE",
            "enum": [
              "text",
              "email",
              "number",
              "textarea",
              "select",
              "checkbox",
              "radio"
            ],
            "type": "string"
          }
        },
        "required": [
          "type",
          "label"
        ],
        "type": "object"
      },
      "minItems": 1,
      "type": "array"
    },
    "status": {
      "default": "DRAFT",
      "description": "Form publication status. Use DRAFT for unpublished forms that are being worked on, or PUBLISHED for live forms. Defaults to DRAFT if not specified.",
      "enum": [
        "DRAFT",
        "PUBLISHED"
      ],
      "type": "string"
    },
    "title": {
      "description": "Form title (required) - will be displayed as the main form heading",
      "maxLength": 100,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "title",
    "fields"
  ],
  "type": "object"
}

Tally MCP

create_form

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Tally MCP

Related Tools

MCP directory API