Form input

veryfront__form_input

This collects missing details, choices, or confirmation and resumes the same run; it is not runtime tool approval.

Access

This tool runs inside a project agent runtime. Attach it to an agent; it cannot be called directly through POST /mcp.

Call type: Can change resources.

Arguments

FieldTypeRequiredDescription and constraints
titlestringYesShort title shown on the Human Step card.
descriptionstringNoWhy input is needed.
submitLabelstringNoLabel for the submit button.
fieldsobject or object or object or object or object[]YesFields the human should complete. Use confirm for yes/no and password for confidential text. Password fields cannot have defaults. Select/radio fields require options.

Result

No output schema is published for this tool. The input contract does not define its return fields. Inspect the MCP response content and isError; do not assume a fixed object shape.

Full schemas

json
{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "Short title shown on the Human Step card."
    },
    "description": {
      "type": "string",
      "description": "Why input is needed."
    },
    "submitLabel": {
      "type": "string",
      "description": "Label for the submit button."
    },
    "fields": {
      "type": "array",
      "description": "Fields the human should complete. Use confirm for yes/no and password for confidential text. Password fields cannot have defaults. Select/radio fields require options.",
      "items": {
        "type": "object",
        "required": [
          "name",
          "type",
          "label"
        ],
        "additionalProperties": false,
        "anyOf": [
          {
            "properties": {
              "type": {
                "enum": [
                  "text",
                  "email",
                  "url",
                  "textarea"
                ]
              },
              "defaultValue": {
                "type": "string"
              },
              "options": {
                "maxItems": 0
              }
            }
          },
          {
            "properties": {
              "type": {
                "enum": [
                  "select",
                  "radio"
                ]
              },
              "defaultValue": {
                "type": "string"
              },
              "options": {
                "minItems": 1
              }
            },
            "required": [
              "options"
            ]
          },
          {
            "properties": {
              "type": {
                "const": "number"
              },
              "defaultValue": {
                "type": "number"
              },
              "options": {
                "maxItems": 0
              }
            }
          },
          {
            "properties": {
              "type": {
                "enum": [
                  "checkbox",
                  "confirm"
                ]
              },
              "defaultValue": {
                "type": "boolean"
              },
              "options": {
                "maxItems": 0
              }
            }
          },
          {
            "properties": {
              "type": {
                "const": "password"
              },
              "options": {
                "maxItems": 0
              }
            },
            "not": {
              "required": [
                "defaultValue"
              ]
            }
          }
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Stable field key returned in submitted values."
          },
          "type": {
            "type": "string",
            "enum": [
              "text",
              "email",
              "url",
              "password",
              "number",
              "textarea",
              "select",
              "checkbox",
              "radio",
              "confirm"
            ]
          },
          "label": {
            "type": "string",
            "description": "Human-readable field label."
          },
          "description": {
            "type": "string"
          },
          "required": {
            "type": "boolean"
          },
          "options": {
            "type": "array",
            "description": "Required for select and radio fields.",
            "items": {
              "type": "object",
              "required": [
                "value",
                "label"
              ],
              "additionalProperties": false,
              "properties": {
                "value": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "recommended": {
                  "type": "boolean"
                }
              }
            }
          },
          "defaultValue": {
            "type": [
              "string",
              "boolean",
              "number"
            ],
            "description": "A number for number fields, a boolean for checkbox and confirm fields, one of the option values for select and radio fields, otherwise a string. Password fields cannot have a default."
          }
        }
      }
    }
  },
  "required": [
    "title",
    "fields"
  ],
  "additionalProperties": false
}

Agent runtime

Use the Agents API to configure the agent's tools. Start the agent through the Execution API. The runtime supplies the execution context for this tool.