Skip to main content
Glama

CloudBrowser

connect_to_browser

Connect to CloudBrowser browser for direct control

Input Schema

NameRequiredDescriptionDefault
sessionIdYesUnique ID for the control session
browserAddressYesWebSocket URL of the CloudBrowser browser (format: ws://browser.cloudbrowser.ai/devtools/browser/[ID])

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

B3.2/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=false, destructiveHint=false, openWorldHint=false, so the safety profile is covered. The description adds only the notion of 'direct control', which implies a persistent session, but says nothing about whether the connection stays open, whether a session must be released with disconnect_browser, or what happens on failure.

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

Conciseness4/5

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

A single compact sentence with the key concept front-loaded and no filler. It is efficient, though its brevity borders on under-specification for a stateful connection tool.

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?

With only two fully-documented parameters, an annotation set, and no output schema, the minimum is met. Still missing is what the agent should expect after connecting (does it return a handle? a confirmation?) and how this tool relates to open_browser and disconnect_browser in a typical workflow.

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%; both browserAddress (with WebSocket URL format) and sessionId are fully documented in the schema. The description adds no meaning beyond that, so the baseline 3 applies.

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: 'Connect to CloudBrowser browser for direct control'. An agent can distinguish this from close_browser and disconnect_browser by the verb alone, though it never explicitly contrasts with the similarly-named open_browser sibling.

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

Usage Guidelines2/5

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

There is no explicit when-to-use guidance, no prerequisites (e.g. where sessionId comes from), and no mention of the alternative open_browser or of disconnecting afterwards. 'For direct control' hints that it precedes the element/script tools, but that is left entirely to inference.

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