io.github.Samrj12/doppel

NPM · DOPPEL-MCP · SCANNED AUG 3

Drive your real, logged-in Chrome/Edge from AI agents over CDP. Faster. Sharper.

Available components

+24 this week 64 64 Trust /100

Trust breakdown (6 categories)

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. How we score →

Supply Chain Security87

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (96 of 100), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (96 of 100), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency19

Repository check failed: no source repository is declared. See how to fix → View diagnostics → Fail
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 14 days ago).Pass
Security-disclosure policy not yet verified: we couldn't inspect the source repository.Unverified

Schema Quality & AI Usability77

AI-judged instruction clarity (excellent).Pass
Tool/resource definitions use about 1518 tokens (~89/item across 17 items; 17 tools + 0 resources), lean.Pass
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · doppel-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add samrj12-doppel -- npx -y doppel-mcp

# add to Codex CLI

codex mcp add samrj12-doppel -- npx -y doppel-mcp

// opencode.json

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

# add to OpenClaw

openclaw mcp add samrj12-doppel --command npx --arg -y --arg doppel-mcp

# ~/.hermes/config.yaml

mcp_servers:
  samrj12-doppel:
    command: "npx"
    args: ["-y", "doppel-mcp"]

// mcp.json

{
  "mcpServers": {
    "samrj12-doppel": {
      "command": "npx",
      "args": [
        "-y",
        "doppel-mcp"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

2 Aug 26 +43
- Provenance: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. security
- Tool coverage: 100 → unverified ▼ functional
- Capabilities: pass → unverified ▼ functional
- Maintenance: unverified → pass ▲ functional
- Stability: unverified → 0.23 ▲ functional
- License: unverified → pass ▲ functional
- Schema quality: unverified → excellent ▲ functional
- Dependency health: unverified → partial ▲ functional
- Licence: MIT functional
1 Aug 26 +5
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- MCP protocol: unverified → pass ▲ functional
31 Jul 26 −2
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
28 Jul 26 −22
- Tool coverage: 100 → unverified ▼ functional
- First check of Schema quality: unverified functional
27 Jul 26 40

First indexed and scored.

Show 3 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 96 packages

96 packages in the resolved dependency tree · 96 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 19 exposed · ~2,223 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

doppel_batch ~159

Apply a SEQUENCE of actions (click/type/press_key/hover) in ONE call, in order. PREFER THIS over separate click/type calls whenever you can already see the targets in the current snapshot - e.g. filling a form, ticking several checkboxes, or 'pick an option then click Continue'. Each separate tool call costs a full model round-trip; a batch is one. Refs come from the latest snapshot, so all targets must exist on the SAME page (a batch can't span a navigation). Stops at the first failed op and reports which one. Returns one snapshot at the end.

Input Output Examples

Name	Type	Req	Description
includeSnapshot	boolean	—	Return a snapshot after the batch. Default true.
ops	array	yes	Ordered list of actions.

No output schema declared.

No examples provided.

doppel_cleanup_tabs ~92

Close leftover Doppel automation tabs. By default only the generic 'Doppel' / 'Doppel Test' groups (debris from past sessions), leaving purpose-named task groups alone. Pass all:true to also close every purpose-named Doppel task group. Non-Doppel tabs and groups are never touched.

Input Output Examples

Name	Type	Req	Description
all	boolean	—	Also close purpose-named Doppel task groups, not just the generic ones.

No output schema declared.

No examples provided.

doppel_click ~87

Click an element by its [ref] from the latest snapshot. Waits until it's actionable, then uses trusted native input. If you already know several actions from this snapshot, prefer doppel_batch to run them in one call.

Input Output Examples

Name	Type	Req	Description
includeSnapshot	boolean	—	Return a fresh snapshot after clicking. Default true.
ref	integer	yes	The [ref] number from a snapshot

No output schema declared.

No examples provided.

doppel_close_tab ~36

Close a tab Doppel controls and drop its session.

Input Output Examples

Name	Type	Req	Description
tabId	integer	yes	The tab id from doppel_list_tabs

No output schema declared.

No examples provided.

doppel_console ~221

See the page's console output + JS errors, captured read-only. By default shows browser-level problems (errors, warnings, failed network/CSP/deprecation), which is fully stealthy. Page console.log/info is NOT captured unless you set `pageConsole:true`, which enables the CDP Runtime domain (detectable by a hostile page while on, so off by default; captures from that point forward). Uncaught JS exceptions are merged in as errors; consecutive duplicates collapse with [xN].

Input Output Examples

Name	Type	Req	Description
grep	string	—	Keep messages whose text matches this substring or regex.
includeStack	boolean	—	Include stack traces (capped ~50 frames).
level	string	—	Minimum severity to show. Default 'warn' (warnings + errors + failures).
limit	integer	—	Max messages. Default 50.
offset	integer	—	Skip the first N matching messages (paginate).
pageConsole	boolean	—	Capture page console.log/info too (enables Runtime; detectable while on). Set false to turn it back off.

No output schema declared.

No examples provided.

doppel_hover ~64

Hover the mouse over an element by its [ref] (reveals menus/tooltips). Waits until it's actionable.

Input Output Examples

Name	Type	Req	Description
includeSnapshot	boolean	—	Return a fresh snapshot after hovering. Default true.
ref	integer	yes	The [ref] from a snapshot

No output schema declared.

No examples provided.

doppel_list_tabs ~27

List the tabs Doppel controls (its tab group), with URLs and which is active.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

doppel_navigate ~92

Navigate the active tab: go to a URL, or go back/forward/reload. Waits for load. Returns the final URL plus a fresh page snapshot (by default).

Input Output Examples

Name	Type	Req	Description
includeSnapshot	boolean	—	Return a fresh snapshot after navigating. Default true.
type	string	—	Navigation type. Default 'url'.
url	string	—	Absolute URL (required when type is 'url').

No output schema declared.

No examples provided.

doppel_network ~424

See the page's network activity, captured read-only from the moment the tab attaches. Without `reqid`, returns a compact one-line-per-request list; pass `reqid` for full detail plus the response body. Successful static assets (images/fonts/scripts/css) are hidden unless `includeStatic`. Filter with `grep` (URL), `status`, `method`, `resourceType`, `failedOnly`, `xhrOnly` (just API calls), or `sinceLastAction` (only what the last click/type/navigate triggered).

Input Output Examples

Name	Type	Req	Description
body	string	—	With reqid: which body to include. Default 'response'.
failedOnly	boolean	—	Only failed requests (transport error or status >= 400).
grep	string	—	Keep requests whose URL matches this substring or regex (case-insensitive).
includeStatic	boolean	—	Include successful images/fonts/scripts/css (hidden by default).
limit	integer	—	Max requests in the list. Default 50.
maxBytes	integer	—	With reqid: truncate inlined bodies to N bytes (default 10000).
method	string	—	HTTP method, e.g. GET, POST.
offset	integer	—	Skip the first N matching requests (paginate).
reqid	integer	—	Drill into one request by its [id] from the list (full detail + body).
resourceType	string	—	doc \| css \| img \| script \| font \| xhr \| fetch \| ws \| media \| other.
saveToFile	string	—	With reqid: write the FULL response body to a file (filename only) in the Doppel captures dir (~/.doppel/captures or $DOPPEL_CAPTURE_DIR), instead of inlining it.
sinceLastAction	boolean	—	Only requests triggered since the last click/type/navigate.
status	string	—	Status filter: "404", "5xx", ">=400".
xhrOnly	boolean	—	Only XHR/fetch requests (the API-call case).

No output schema declared.

No examples provided.

doppel_new_tab ~125

Open a new tab (background, no focus stealing) and make it active. Optionally load a URL. Pass `group` to name the tab group by the task's purpose (e.g. '27in Monitor'); tabs sharing a group cluster together.

Input Output Examples

Name	Type	Req	Description
group	string	—	Short purpose label for the tab group, e.g. '27in Monitor', 'Job Apply'. Defaults to 'Doppel'.
includeSnapshot	boolean	—	Return a snapshot after opening. Default true.
url	string	—	URL to load. Default about:blank.

No output schema declared.

No examples provided.

doppel_press_key ~72

Press a special key (Enter, Tab, Backspace, Delete, Escape, Arrow keys) via trusted native input.

Input Output Examples

Name	Type	Req	Description
includeSnapshot	boolean	—	Return a fresh snapshot after the keypress. Default true.
key	string	yes	Key name, e.g. Enter, Tab, ArrowDown

No output schema declared.

No examples provided.

doppel_screenshot ~91

Screenshot the current page (PNG by default). Returns the image. Prefer doppel_snapshot (text) when possible; use this only when you need to SEE pixels.

Input Output Examples

Name	Type	Req	Description
format	string	—	Image format. Default png.
fullPage	boolean	—	Capture the full scrollable page, not just the viewport.
quality	integer	—	Quality 0-100 (jpeg/webp only).

No output schema declared.

No examples provided.

doppel_select_tab ~63

Switch the active tab to another tab Doppel controls (tabId from doppel_list_tabs).

Input Output Examples

Name	Type	Req	Description
includeSnapshot	boolean	—	Return a snapshot of the newly active tab. Default true.
tabId	integer	yes	The tab id from doppel_list_tabs

No output schema declared.

No examples provided.

doppel_set_group ~79

Name the current tab's group by the task's PURPOSE (e.g. '27in Monitor', 'Job Apply'), not the site. Call this at the start of a task so the group chip reads as what you're doing instead of 'Doppel'.

Input Output Examples

Name	Type	Req	Description
name	string	yes	Short purpose label, e.g. '27in Monitor'.

No output schema declared.

No examples provided.

doppel_snapshot ~189

Capture a structured accessibility snapshot of the current page. Elements are tagged with a [ref] for doppel_click/doppel_type; refs stay stable across grep/offset within a snapshot. Fast: no screenshot. On dense pages (search results, shopping) use interactive:true and/or grep to cut noise, and offset to page through results.

Input Output Examples

Name	Type	Req	Description
grep	string	—	Keep only elements whose role/name/value matches this text or regex (case-insensitive), e.g. 'Dell' or 'button'.
interactive	boolean	—	Only actionable elements (links/buttons/inputs); skips headings/static text/lists. Best for dense pages.
limit	integer	—	Max elements to return. Default 500; 300-1000 is a good range. Prefer interactive/grep over a huge limit.
offset	integer	—	Skip the first N matching elements (paginate a long page).

No output schema declared.

No examples provided.

doppel_status ~27

Check whether the Doppel browser extension is connected. Call this first if other tools error out.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

doppel_type ~86

Type text into an element by its [ref]. Waits until actionable, focuses it, and inserts trusted text (works with React/controlled inputs).

Input Output Examples

Name	Type	Req	Description
includeSnapshot	boolean	—	Return a fresh snapshot after typing. Default true.
ref	integer	yes	The [ref] of the input/textarea from a snapshot
text	string	yes	The text to type

No output schema declared.

No examples provided.

doppel_upload ~184

Upload local file(s) to a file input WITHOUT opening the native OS file dialog. Point `ref` at the upload control from a snapshot - the file input itself, or the button/label that opens it (Doppel finds the underlying <input type=file>). `path` is an absolute path on this machine; pass an array for a multi-file input. Fires the real change event, so the page reacts exactly as if a human picked the file.

Input Output Examples

Name	Type	Req	Description
includeSnapshot	boolean	—	Return a fresh snapshot after uploading. Default true.
path	—	yes	Absolute path to a local file (must be under Downloads/Documents/Desktop/Pictures/temp or $DOPPEL_UPLOAD_DIRS), or an array for a multi-file input.
ref	integer	yes	The [ref] of the upload control (the file input, or the button/label that opens it).

No output schema declared.

No examples provided.

doppel_wait_for ~105

Wait until specific text appears on the page, or for a fixed time. Use after an action that loads content.

Input Output Examples

Name	Type	Req	Description
includeSnapshot	boolean	—	Return a snapshot after waiting. Default true.
text	string	—	Text to wait for (case-insensitive substring).
timeMs	integer	—	Or wait a fixed number of milliseconds (max 60000).
timeoutMs	integer	—	Max wait when using 'text' (default 10000).

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug