$ man form-fill-plan
/form-fill-plan
PRICE / CALL
$0.02
USDC · base mainnet · scheme: exact
──────────────────────────────────────────────────────────────────────────────
NAME
form-fill-plan — form fill plan api that turns an html form plus a plain-language goal into an ordered browser form automation plan: selector, field label…
SYNOPSIS
POST https://x402.agentutility.ai/form-fill-plan
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.
DESCRIPTION
Form fill plan API that turns an HTML form plus a plain-language goal into an ordered browser form automation plan: selector, field label, value, and action (fill/select/check/uncheck/click) for each step. Built for autofill steps and Playwright form plan generation ahead of a real run. Send form_html, a goal like 'sign up for the newsletter with my email', and any known data values, and get back a step-by-step plan with unresolved fields flagged rather than guessed. Advisory only: the plan is heuristic guidance from static HTML, not a guarantee, and should be verified against the live DOM before executing. Use it as a browser form automation API, an autofill planning tool, or a pre-run checklist generator for RPA and agent browser workflows.
INPUT — request schema
| property | type | description | req? |
|---|
| form_html | string | The HTML of the form to plan a fill for, including its input/select/textarea elements. Required, max 200,000 chars. | required |
| goal | string | Plain-language description of what the fill should accomplish, e.g. 'sign up for the newsletter with my email'. Required, max 500 chars. | required |
| data | object | Optional known field values keyed by a human-readable name (e.g. { email: 'a@b.com' }) the planner should use to resolve steps. | optional |
OUTPUT — response shape
| field | type | description |
|---|
| goal | string | — |
| steps | string | — |
| unresolved_fields | string | — |
| advisory | string | — |
| advisory_note | string | — |
| model | string | — |
| source | string | — |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/form-fill-plan \
-H 'Content-Type: application/json' \
-d '{ }'first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.
EXAMPLE 2 · mcp
# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>
# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...
# Then call the form-fill-plan tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- browser-workflowformfillplanform-fill-plan
- methods
- POST
- cluster
- browserworkflow
- price
- $0.02 USDC per call
ADJACENT — other endpoints in browserworkflow
| endpoint | description | price |
|---|
| browser-flow-digest | Browser flow digest API that compresses a recorded trajectory or trace into reusable workflow memory: an ordered step list, the precondit… | $0.02 |
| dom-change-diff | DOM diff for two HTML snapshots of the same page or component, built for browser-automation scripts whose CSS selectors quietly break aft… | $0.01 |
agentutility(7)