mcp_click: Click a page element for an agent

In shidashi: A Shiny Dashboard Template Modular System with Chat Bot Support

Click a page element for an agent

Description

Asks the browser to click the first element that matches selector, for a tool call made by an agent (for example over MCP). The browser does not click an element inside [mcp-agent-disabled="true"]: such controls are for people only (for example a button that overwrites files), and agents should ask the user to click them. People's own clicks are not affected. Use this function in tools instead of sending the "shidashi.click" message.

Usage

mcp_click(
  selector,
  session = shiny::getDefaultReactiveDomain(),
  timeout = getOption("shidashi.click_timeout", 10)
)

Arguments

selector	CSS selector of the element to click
session	shiny session; for modules, the module session
timeout	seconds to wait for the browser's answer

Value

A promise resolved with a list: matched (an element matched the selector), clicked, refused (the element is disabled for agents), and note (an invalid selector, for example). The promise is rejected when the browser does not answer in time.

Examples

# In a tool function (shiny session required):
# promises::then(mcp_click("#my_button", session), function(res) {
#   if (isTRUE(res$refused)) stop("The button is for people only")
#   "Clicked"
# })

shidashi documentation built on Oct. 12, 2026, 1:11 a.m.