Select option
browser_selectSelect a value on a . Required: sessionId, observationId, elementId, value. value must match an or a unique option label. A non-select element returns WRONG_ELEMENT_TYPE with the actual tag and role. Unknown values return INVALID_SELECT_VALUE and do not change the select. A disabled option, including a placeholder such as Please select an option, returns OPTION_DISABLED and does not change the select. A failure before the page changes keeps the observation valid. STALE_OBSERVATION means observe again and retry. On a sensitive site, select returns APPROVAL_REQUIRED with approvalId and does not change the control until Approve. Approve runs that select once. The completed success includes that same approvalId and approved: true. A select that did not need approval does not include approvalId. After Deny, the next select of that value returns APPROVAL_DENIED with that approvalId once, even when the observation id and element id changed. A different value asks for a new approval. A later select of the same value may ask again. While it is still pending, the same element and value returns APPROVAL_PENDING.
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": {
"sessionId": "<sessionId>",
"observationId": "<observationId>",
"elementId": "<elementId>",
"value": "<value>"
},
"name": "browser_select"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| value | Yes | ||
| elementId | Yes | ||
| sessionId | Yes | ||
| observationId | Yes | ||
| idempotencyKey | No | A key replays the original result only within ~60 seconds of the first call, only for the same Mcp-Session-Id, the same credential (API key or OAuth token), the same browser session, and the same tool. After the window, or under a different session/credential/tool, the call executes and bills normally. Reusing a key with different arguments returns IDEMPOTENCY_KEY_REUSED and is not executed or billed. Refusals (e.g. NO_HISTORY_ENTRY) are not cached, so the same key re-executes once state changes. A key passed in _meta is ignored. |