Invoke a discovered WebMCP tool
Invokes the exact live registration identified by tool_ref. Non-autosubmit declarative form tools return after their fields are populated with an awaiting_submission status. Other tools wait for a terminal result, including across navigation. Inspect a populated form, obtain any required confirmation, then submit through Playwright or computer interaction without invoking the tool again. If the tab or embedded frame disappears, or the request times out after invocation begins, the response reports outcome_unknown. If the tool’s page is reloaded or replaced by a navigation the tool did not start, and the tool never responds, the response reports tool_page_unloaded once the replacement page loads, or right away if the tool’s tab crashes. Neither failure is retried, and both set X-Should-Retry to false because the tool may have had side effects. CDP-backed custom tool outputs above 240 KiB return an error rather than a truncated result.
Authorizations
Body
The raw JSON request body is limited to 4 MiB plus 4 KiB of envelope overhead before decoding.
Response
The populated non-autosubmit form state or the tool's terminal result
awaiting_submission means a non-autosubmit declarative form was populated but not submitted. Inspect the form, obtain any required confirmation, then submit through Playwright or computer interaction without invoking the tool again. The other statuses are terminal results.
completed, canceled, error, awaiting_submission