KEkernel
Browser WebMCP

Invoke a discovered WebMCP tool

Changed on

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 and the tool is not retried. CDP-backed custom tool outputs above 240 KiB return an error rather than a truncated result.

post/browsers/{id_or_name}/webmcp/invoke

Request

  • Base URL
    https://api.onkernel.com
  • URL
    https://api.onkernel.com/browsers/{id_or_name}/webmcp/invoke
  • Auth
    HTTP bearer

Path parameters

id_or_namestring required

Browser session ID or name

Request body

inputobject required

Tool input, limited to 1 MiB after JSON serialization.

timeout_secinteger
tool_refstring required

Response

The populated non-autosubmit form state or the tool's terminal result

error_textstring
invocation_idstring required
outputunknown
status'completed' | 'canceled' | 'error' | 'awaiting_submission' required

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.

Changes