Skip to main content
Glama

chrome_use_open

Navigates the browser to a URL or launches it blank for cookie/route setup; supports new tabs, labels, and navigation wait states.

Instructions

Navigate to a URL. Omitting url just launches the browser and stays on about:blank (useful before setting up cookies/routes).

Input Schema

NameRequiredDescriptionDefault
urlNoURL to open. https:// is assumed if no scheme is given.
labelNoAssign a memorable label to the tab (--label).
newTabNoOpen the URL in a new tab instead of navigating the current tab.
observeNoObserve the action's effect (--observe): a page snapshot before and after, the change, and whether the page now waits for a person. Use it when the action should submit, save, pay or send, then confirm the effect with chrome_use_expect.
sessionNoIsolated session name (chrome-use --session <name>). Each session gets its own tab group, browser tab and element refs. Omit it unless several agents share ONE MCP server — the session is otherwise derived per agent automatically. When you do share a server with sibling agents, pass a name unique to you on every call, or you will drive their tabs and invalidate their refs.
reuseTabNoAdopt an existing tab already on this URL instead of opening a new one.
timeoutMsNoKill the underlying chrome-use process if it hasn't responded after this many ms (default 30000).
waitUntilNoNavigation readiness to wait for (default: load).

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv0.1.0

TDQS

A3.6/5.0
Behavior3/5

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

No annotations exist, so the description carries the full burden. It does disclose a non-obvious behavior beyond the schema: omitting `url` launches the browser and leaves it on about:blank. It does not state what happens to the current tab versus new tabs, whether navigation failures throw, or that this is a side-effecting action on live browser state.

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?

Two sentences, front-loaded with the primary action and followed by the one non-obvious edge case. No filler and nothing buried.

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

Completeness3/5

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

For an 8-parameter, side-effecting browser tool with no annotations and no output schema, the definition is thin. The rich schema compensates for parameter detail, but the agent gets no statement about side effects on existing tabs, failure behavior, or what a successful call yields (page refs, snapshot), which matters before the subsequent click/fill calls.

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

Parameters4/5

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

Schema coverage is 100%, so the baseline is 3, but the description adds real meaning not in the schema: the schema marks `url` as optional without explaining the consequence, and the description fills that gap with the about:blank launch behavior. The remaining seven parameters are left entirely to their schema descriptions.

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

Purpose4/5

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

States a specific verb and resource: "Navigate to a URL." That is enough to separate it from the interaction siblings (click, fill, type), though it does not explicitly differentiate from navigation-adjacent siblings like chrome_use_reload, chrome_use_forward, or chrome_use_back.

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

Usage Guidelines3/5

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

The description gives one concrete usage case (omit `url` to sit on about:blank before setting up cookies/routes), which is genuinely useful routing guidance. It says nothing about when to prefer this over chrome_use_reload or chrome_use_forward for reaching a page, so the alternative-selection guidance is only partial.

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