Ask the user to fill a form
elicit_formTrigger a form elicitation with a caller-supplied JSON schema; returns the raw {action, content}. For a plain OK/Cancel question, prefer elicit_confirm. MUST NOT be used to request secrets, credentials, or other sensitive information.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| message | Yes | The instruction shown to the user above the form fields. | |
| timeoutSeconds | No | How long to wait for the answer, in seconds (default 300, clamped 60-3600) — raise it for forms with several fields. | |
| requestedSchema | Yes | JSON Schema for the form, restricted to the MCP elicitation requestedSchema subset: a flat object whose properties are strings, numbers/integers, booleans, or enums — no nested objects, arrays of objects, $ref, or allOf. See https://modelcontextprotocol.io/specification/2025-11-25/client/elicitation#requested-schema |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | accept = the user submitted the form; decline = an explicit no; cancel = dismissed unanswered (including timeout); error = the elicitation failed. | |
| content | Yes | On accept, the submitted values keyed by requestedSchema property name; null for every other action. |