Skip to main content
Glama
Sign In
invisible-playwright-mcp

invisible-playwright-mcp

by solver492
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

browser_read_text

Read-only

Read the visible text of a page element with markup removed. Narrow the selector to target specific content, and long text is truncated at a set character limit with the cut clearly marked.

Instructions

The visible text of an element, with the markup gone.

The cheapest way to read a page. Narrow the selector when you know where the answer is; use browser_read_html instead when the structure matters, or browser_snapshot when you need something to click.

Long text is cut at max_chars (6000 by default) and the cut is marked in what comes back, so text that ends without that marker is the whole thing.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "browser_read_text"
  }
}

Input Schema

NameRequiredDescriptionDefault
browserNoDefaults to `main`; `support` is the helper beside it.
selectorNobody
max_charsNo

Output Schema

NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv0.70.2

TDQS

A4.9/5.0
Behavior5/5

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

Annotations already provide readOnly and destructive hints, so the bar is lower. The description adds real behavioral context beyond annotations: the output is stripped of markup, is the 'cheapest way to read a page,' and long text is truncated at max_chars with a marker that signals truncation. This is useful operational detail not present in the structured metadata.

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?

Four sentences, front-loaded with the core definition. The alternatives paragraph and the truncation behavior paragraph are each necessary and non-redundant; no filler.

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

Completeness5/5

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

For a read-only tool with 3 optional parameters and an output schema, the description covers what text is returned, how to target it, when to choose another tool, and how to detect truncation. Nothing essential for correct invocation is missing.

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 only 33% (browser is described), but the description compensates for the other two parameters: max_chars gains truncation and marker semantics, and selector gains purpose via 'Narrow the selector when you know where the answer is.' It doesn't specify selector syntax, but it covers the missing parameters meaningfully enough.

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 opens with a precise definition: 'The visible text of an element, with the markup gone.' It names sibling tools browser_read_html and browser_snapshot and differentiates them by structure versus clickability, so an agent can distinguish this tool from close alternatives without opening schemas.

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

Usage Guidelines5/5

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

It gives explicit when-to-use advice: 'Narrow the selector when you know where the answer is' and explicitly routes structure needs to browser_read_html and click needs to browser_snapshot. This is direct usage guidance with named alternatives and conditions.

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

Deploy Server

Other Tools