# io.github.ofershap/real-browser (npm · real-browser-mcp)

MCP server + Chrome extension for AI browser control with real sessions.

- Trust score: 64/100 (medium)
- Change this week: +18
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `real-browser-mcp`: 64/100 (this document), [markdown](https://verifymcp.io/servers/ofershap-real-browser/real-browser-mcp.md), [page](https://verifymcp.io/servers/ofershap-real-browser/real-browser-mcp)

## Channel facts

- Registry: `npm`
- Package: `real-browser-mcp`
- Version: `1.2.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 145 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 70/100
  - AI-judged instruction clarity (good).
  - Tool/resource definitions use about 1169 tokens (~64/item across 18 items; 18 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 97/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 92% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add ofershap-real-browser -- npx -y real-browser-mcp
```

### Codex

```bash
codex mcp add ofershap-real-browser -- npx -y real-browser-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ofershap-real-browser": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "real-browser-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add ofershap-real-browser --command npx --arg -y --arg real-browser-mcp
```

### Hermes

```yaml
mcp_servers:
  ofershap-real-browser:
    command: "npx"
    args: ["-y", "real-browser-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "ofershap-real-browser": {
      "command": "npx",
      "args": [
        "-y",
        "real-browser-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 64, +44)

- [security regression] Provenance: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional regression] Security disclosure: unverified → fail
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] License: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Schema quality: unverified → good
- [functional] Licence: MIT

### 2026-08-02 (score 20, −1)

- [security improvement] Malware scan: unverified → pass
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Security disclosure: fail → unverified
- [functional] First check of Schema quality: unverified

### 2026-07-31 (score 21, −25)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-27 (score 46)

First indexed and scored.

## MCP tools (18)

### `browser_navigate` (~44 tokens)

Navigate to a URL in the active browser tab

Input parameters:

- `url` (string, required): The URL to navigate to
- `waitUntil` (string): When to consider navigation complete

### `browser_click` (~69 tokens)

Click an element on the page using a ref from snapshot or a CSS selector

Input parameters:

- `button` (string)
- `doubleClick` (boolean)
- `ref` (string): Element reference from snapshot (e.g. "e12")
- `selector` (string): CSS selector for the element

### `browser_type` (~60 tokens)

Type text into an input element

Input parameters:

- `clear` (boolean): Clear the field before typing
- `ref` (string): Element reference from snapshot
- `selector` (string): CSS selector for the input
- `text` (string, required): Text to type

### `browser_scroll` (~105 tokens)

Scroll the page or an element. Supports pixel offsets, scrolling to elements, and named positions (top/bottom). Works with virtual scroll containers used by social media sites.

Input parameters:

- `amount` (number): Pixels to scroll
- `direction` (string)
- `position` (string): Scroll to top or bottom of page
- `selector` (string): CSS selector of scroll container (for virtual scroll)
- `toElement` (string): Ref or CSS selector to scroll into view

### `browser_press_key` (~101 tokens)

Press a keyboard key or combination (Enter, Escape, Tab, ArrowDown, etc). Supports modifiers like Ctrl+A, Cmd+C.

Input parameters:

- `key` (string, required): Key name (e.g. "Enter", "Escape", "Tab", "ArrowDown", "a")
- `modifiers` (array): Modifier keys to hold
- `ref` (string): Element ref to focus before pressing
- `selector` (string): CSS selector to focus before pressing

### `browser_wait` (~92 tokens)

Wait for a condition: element to appear, element to disappear, or a fixed delay. Useful for SPAs and dynamic content.

Input parameters:

- `delay` (number): Fixed delay in ms (ignores selector)
- `selector` (string): CSS selector to wait for
- `state` (string): Wait until element is visible, hidden, or attached to DOM
- `timeout` (number): Max wait time in ms

### `browser_snapshot` (~84 tokens)

Get an accessibility tree snapshot of the page. Returns element refs you can use with click, type, and other tools. Use compact mode (default) for smaller output - only interactive elements.

Input parameters:

- `compact` (boolean): When true (default), returns only interactive elements with minimal nesting. Set false for full tree.
- `selector` (string): CSS selector to scope the snapshot

### `browser_screenshot` (~38 tokens)

Capture a screenshot of the visible page area

Input parameters:

- `format` (string)
- `quality` (number): JPEG quality (ignored for PNG)

### `browser_console` (~33 tokens)

Read console messages (log, warn, error) from the browser

Input parameters:

- `clear` (boolean): Clear messages after reading

### `browser_network` (~45 tokens)

Read network requests made by the page. Filter by URL pattern.

Input parameters:

- `clear` (boolean): Clear requests after reading
- `filter` (string): URL regex pattern to filter requests

### `browser_tabs` (~55 tokens)

Manage browser tabs: list, create, close, or focus

Input parameters:

- `action` (string, required): Tab action
- `tabId` (number): Tab ID for close/focus
- `url` (string): URL for create action

### `browser_find` (~62 tokens)

Find elements on the page using natural language (e.g. "login button", "search input"). Returns refs you can use with click/type.

Input parameters:

- `limit` (number): Max matches to return
- `query` (string, required): Natural language description of what to find

### `browser_text` (~46 tokens)

Extract raw text content from the page or a specific element

Input parameters:

- `maxLength` (number): Max text length to return
- `selector` (string): CSS selector to scope text extraction

### `browser_hover` (~47 tokens)

Hover over an element to trigger tooltips, dropdown menus, or hover states

Input parameters:

- `ref` (string): Element reference from snapshot
- `selector` (string): CSS selector for the element

### `browser_select` (~78 tokens)

Select an option from a dropdown/select element

Input parameters:

- `index` (number): Option index to select (0-based)
- `label` (string): Option label text to select
- `ref` (string): Element reference from snapshot
- `selector` (string): CSS selector for the select element
- `value` (string): Option value to select

### `browser_evaluate` (~56 tokens)

Execute JavaScript in the page and return the result. Use for DOM queries, reading page state, or any operation not covered by other tools.

Input parameters:

- `expression` (string, required): JavaScript expression or code to evaluate in the page context

### `browser_click_text` (~99 tokens)

Click an element by its visible text content. Works on React dropdowns, portals, and overlays that may not appear in snapshots. CSP-safe (no eval). Prefers deepest matching element.

Input parameters:

- `exact` (boolean): Require exact match instead of substring (default false)
- `index` (number): Which match to click if multiple (0-based, default 0)
- `text` (string, required): Text to match against element content (first line)

### `browser_handle_dialog` (~55 tokens)

Handle JavaScript dialogs (alert, confirm, prompt). Dialogs block page interaction until handled.

Input parameters:

- `action` (string, required): Accept or dismiss the dialog
- `promptText` (string): Text to enter for prompt() dialogs

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/ofershap-real-browser/real-browser-mcp#diagnostics

## Score history

- 2026-08-03: 64
- 2026-08-02: 20
- 2026-08-01: 21
- 2026-07-31: 21
- 2026-07-30: 46
- 2026-07-28: 46
- 2026-07-27: 46

## Links

- npm package: https://www.npmjs.com/package/real-browser-mcp
- Socket report: https://socket.dev/npm/package/real-browser-mcp
- Repository: https://github.com/ofershap/real-browser-mcp
- Changelog RSS feed: https://verifymcp.io/servers/ofershap-real-browser/real-browser-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/ofershap-real-browser/real-browser-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/ofershap-real-browser/real-browser-mcp