Skip to main content
Glama

Browser Select

browser_select
Destructive

Use this to select an option from a native HTML select control on an inspected Chromium page. Verify the selector and valid option first; selection can trigger dependent form updates.

Input Schema

NameRequiredDescriptionDefault
textNoFor action=type, Unicode text to insert. For non-type element actions without selector/browser_text, visible text may identify the target.
titleNoChoose a page whose title contains this text.
deviceYesReMCP device id returned by list_devices. Required for every device operation.
optionNoOption value to select in a browser select element.
endpointNoLoopback Chrome DevTools endpoint. Defaults to REMCP_CDP_URL or http://127.0.0.1:9222.
selectorNoCSS selector for the target element; prefer the reusable selector returned by browser_find.
target_idNoPage target id returned by browser_tabs.
timeout_msNoTimeout in milliseconds.
browser_textNoVisible text used only to locate a DOM element; use this instead of overloading text for action=type.
url_containsNoChoose a page whose URL contains this text.

Output Schema

NameRequiredDescriptionDefault
dataNoBrowser element action structured result for browser_action. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.
textYesConcise human-readable result of the tool call.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The annotations already disclose that this is destructive, non-idempotent, and open-world, so the description only needs to add useful context. It does that by warning that selection can trigger dependent form updates, which is a meaningful behavioral trait beyond the annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two tightly written sentences with no wasted language. The core action is front-loaded, followed immediately by the key safety precondition and side-effect warning.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With full schema coverage, rich annotations, and an output schema, the description supplies the most important missing behavioral caveat about dependent form updates. It is nearly complete, though it could further clarify native-select-only boundaries versus custom controls and alternatives.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all ten parameters thoroughly. The description mentions selector and option verification, but adds no syntax or format details beyond what the schema provides, making the baseline score of 3 appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: selecting an option from a native HTML select control on an inspected Chromium page. The phrase 'native HTML select control' clearly distinguishes this from sibling tools like browser_click, browser_type, or browser_set_value.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives a clear usage context and a precondition: verify the selector and valid option first. However, it does not explicitly name alternatives or say when not to use this tool, such as for custom dropdowns that are not native HTML selects.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources