Skip to main content
Glama

start

Initiate a real Chrome session for agent-piloted automation, with stealth options, persistent profiles, and session targeting to bypass Cloudflare.

Instructions

Start a browser session (cold-launch real Chrome).

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
leaseNoOptional lease token to present if the target session is leased (0.7.0). Threaded per-call; never read from the server's env.
backendNoStealth backend: patchright (default) | nodriver | auto. nodriver needs `pip install vibatchium[nodriver]`.
profileNoPersistent profile dir (default: cache dir).
sessionNoOptional session name to target (omit for the shared 'default'). On a daemon shared with other agents, pass a UNIQUE name for stateful multi-step work (go→click→fill) so you don't collide on 'default'.
headlessNoHeadless mode — the MCP default. UA is de-Headless'd automatically; headed clears residual GPU/screen tells and is worth a retry on hard walls.
ephemeralNoDelete this session's profile dir on close — for one-shot work that shouldn't leave login state on disk. Prevents profile bloat from per-run sessions.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv0.1.0

TDQS

B3.3/5.0
Behavior2/5

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

Annotations are absent, so the description carries the full burden of behavioral disclosure. It states 'cold-launch real Chrome' which indicates a real process launch, but it does not disclose side effects like profile directory creation, resource usage, or what happens if a session already exists. For a mutation tool with no annotation support, this is a significant gap.

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 a single, concise sentence that captures the core purpose without any extraneous content. It is front-loaded with the primary action and efficiently conveys the essence of the 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?

For a start operation, the description is adequate but lacks explicit details about session conflict handling, return values, or error conditions. Given there is no output schema, the description could benefit from mentioning what happens if a session already exists or how to confirm success. It meets the minimum bar but leaves gaps.

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% across all 6 parameters, each with detailed descriptions. The tool description itself adds no additional parameter semantics beyond the schema, so the baseline of 3 is appropriate. The description does not need to duplicate schema information.

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 clearly states the action: 'Start a browser session' and adds specificity with 'cold-launch real Chrome', which differentiates it from warm-start or in-process operations. It is not a tautology and gives a distinct operational profile that separates it from sibling tools like session_new.

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?

No guidance is provided on when to use this tool versus alternatives such as session_new or session_use. The description implies this is the entry point to launch a browser, but it does not explicitly state when it should be called, when it shouldn't, or mention available alternatives. Only implied context exists.

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