session_click_selector
Clicks an element on the current session page by CSS selector; use an optional index to target one match when several elements share the selector.
Instructions
Click an element on the session's current page, located by a CSS selector.
Requires a session opened with profile_start first. selector is a CSS
selector (e.g. "button#submit", "a.nav-link") — not an XPath, not a role/name
pair (use session_snapshot to find one).
Args: name: identity name, exactly as profiles_list reports it. selector: CSS selector for the element to click. nth: optional, 0-based — which element to use when the selector matches several. Leave it out and a selector that matches several elements fails with "matched N elements"; then write a more specific selector or pass nth.
Returns {ok: true}. Fails with a readable message if the session is not open (409 — call profile_start first), the identity does not exist (404), the selector matches several elements and no nth was given, or the selector never matches / the click times out (502).
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": {
"name": "<name>",
"selector": "<selector>"
},
"name": "session_click_selector"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nth | No | ||
| name | Yes | ||
| selector | Yes |