inspect_form
Inspect a web form to retrieve a JSON schema of every field, including types, labels, and validation rules, enabling automated testing and data generation.
Instructions
Load a page (optionally logging in via a configured profile first) and return a JSON schema of every field in its form(s): name, type, label, placeholder, required, pattern/min/max/maxlength, select/radio/checkbox options, file accept types, hidden fields, and best-effort multi-step grouping.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"url": "<url>"
},
"name": "inspect_form"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Page URL to inspect | |
| headed | No | Show the browser window (default: visible, unless formpilot.config.json sets "headless": true) | |
| formSelector | No | CSS selector for the form; defaults to the first <form> | |
| loginProfile | No | Named profile from formpilot.config.json to log in with first |