Skip to content

Browser Tools

Browser tools let a connected AI agent operate DocuBench-owned browser tabs. They are exposed through MCP and are scoped to the running workbench.

What Agents Can Do

AI agents can use browser tools to operate websites, depending on the tab type and safety rules.

ToolPurpose
browser_list_tabsList MCP tabs owned by the current workbench.
browser_navigateNavigate a general MCP tab to a URL.
browser_get_contentRead sanitized HTML or text content from a tab.
browser_screenshotCapture a tab screenshot as PNG image content.
browser_scroll_tabScroll the page by a pixel amount.
browser_create_tabCreate a new general MCP navigation tab.
browser_clickClick a link, button, or interactive icon by selector or text.
browser_typePre-fill an allowed input, textarea, or rich text editor.
browser_click_pointClick visual coordinates from a screenshot.
browser_dragDrag between two visual coordinates.
browser_mouse_wheelSend a wheel event at visual coordinates.
browser_keyboard_typeType raw keyboard events into the focused element.
browser_history_step_backNavigate back one step in the tab's browser history.
browser_history_step_forwardNavigate forward one step in the tab's browser history.

AI agents should choose tool calls based on the user's natural language instruction. You can also explicitly ask an agent to take a screenshot or use a screenshot to determine click coordinates.

Tab Types and Tool Behaviors

DocuBench defines three MCP tab types:

Tab typePurpose
Navigation tabGeneral browsing controlled by workbench navigation policy.
Site Agent tabDedicated tab for one configured website.
Developer Host tabDedicated tab for local or developer-controlled workflows.

Some tools are restricted in certain tab types. For details, see Permissions and Safety.

browser_get_content returns different results based on the tab type.

In Navigation tabs and Site Agent tabs, HTML content is sanitized. The goal is to return useful page structure and text while removing behavior, presentation noise, tracking artifacts, and large inline graphics that inflate the response without helping the AI reason about the page. Sensitive data, such as CSRF tokens and hidden session/security form fields, are also removed during this sanitization process.

In Developer Host tabs, browser_get_content returns unmodified HTML DOM data for agent-assisted development workflows.