Playwright MCP sends ~14,000 tokens for a content-heavy page like Hacker News. Most of that is noise. Your context window fills up. Your agent gets confused. You pay for it.
Leapfrog sends ~1,400 tokens. Same page. Same information. Up to 10x less noise.
Savings range from 2-10x depending on page complexity. Content-heavy pages see the biggest wins. Dense forms see the smallest. The median across real-world sites is ~4-5x.
Quick Start
npx leapfrog-mcp --doctor # verify everything works
npx leapfrog-mcp --stealth-audit # test all 19 stealth patches
npx leapfrog-mcp --config # print MCP config to paste
Add to ~/.mcp.json (Claude Code) or your editor's MCP config:
Leapfrog uses playwright-core (15MB) instead of playwright (1.6GB) and does not bundle a browser. Either:
Set LEAP_CHANNEL=chrome to use your installed Chrome/Chromium (recommended)
Or run npx playwright-core install chromium to install the bundled Chromium binary
Or set LEAP_CDP_ENDPOINT to connect to an already-running Chrome instance
Feature Matrix
Leapfrog
Playwright MCP
agent-browser
Tokens per page
~1,200-2,500
~3,800-15,000
~300
Parallel sessions
15
1
1
Session isolation
Yes
No
No
Multi-tab / popups
Yes
No
No
Network intercept
Yes
No
No
Console capture
Yes
Yes
No
Stealth / anti-bot
Yes
No
No
Smart wait (5 types)
Yes
Basic
No
Crash recovery
Yes
No
No
Batch actions (100/call)
Yes
No
No
Init script injection
Yes
Yes
No
Drag / upload / resize
Yes
Yes
No
Per-session proxy
Yes
No
No
Humanization (opt-in)
Yes
No
No
Auth profile reuse
Yes
No
No
Cookie persistence
Yes
No
No
Page classification (18)
Yes
No
No
Session memory
Yes
No
No
API intelligence
Yes
No
No
Adaptive wait + auto-retry
Yes
No
No
CAPTCHA auto-resolve
Yes
No
No
Self-improvement (9 dims)
Yes
No
No
Record / replay
Yes
No
No
Pagination extraction
Yes
No
No
Incremental snapshots (diff)
Yes
No
No
Stealth self-test CLI
Yes
No
No
SSRF protection
Yes
No
No
Stealth
Leapfrog ships 19 anti-detection patches enabled by default (LEAP_STEALTH=true). Four modes:
true (default) — all 19 patches active
passive — removes automation signals only (webdriver, HeadlessChrome). Does NOT fake identity (WebGL, fonts, audio). Better for sites where trust matters more than evasion.
auto — per-domain EXP3 bandit selects the optimal stealth configuration based on what's worked before
false — no stealth patches
These cover the vectors that fingerprint services like CreepJS and fingerprint-pro actually check:
Client Hints brands (strips HeadlessChrome)
navigator.webdriver forced to undefined
WebGL vendor/renderer (replaces SwiftShader with real GPU strings)
Connection RTT (non-zero)
Alert dismiss timing (human-speed delay)
Window outer/inner height offset
MIME type array population
Platform inference from user agent
chrome.app emulation
iframe contentWindow protection
Media codec spoofing (canPlayType)
document.hasFocus() override
Source URL comment stripping
Custom UA + stealth coexistence (custom user agents no longer disable stealth context)
Persistent browser profiles now use context.cookies() + addCookies() instead of storageState(), which returns empty on persistent contexts. Auth state survives across sessions.
Adaptive Wait + Stealth Escalation
Navigate automatically retries with fallback strategies when pages fail to load:
Try load (fastest) — if empty, retry with networkidle (10s cap)
If networkidle times out (Amazon, ad-heavy sites), fall back to domcontentloaded
If blocked/challenged, escalate stealth: random delays → wait for JS challenge → rotate session with fresh fingerprint
Profile sessions (auth'd) never have their session destroyed — hard-capped at Level 2
Opt-out with autoRetry: false on navigate. Control max escalation with maxRetryLevel (0-5, default 3).
Record / Replay
Export a session's action history as a replayable recording, then replay it in new sessions:
session_export — creates parameterized JSON or Playwright script from session history. @eN refs resolved to stable CSS selectors. Auto-detects emails, passwords, URLs as {{placeholders}}.
session_replay — replays a recording with parameter overrides. Supports onError: 'stop' or 'skip'.
Turn one-off agent workflows into reusable automations.
Pagination Extraction
Extract data across multiple pages in a single tool call:
Infinite scroll — scrolls and waits for new content via DOM hash comparison
URL pattern — increments ?page={page} or custom patterns
Replaces 3-4 tool calls per page. Cap: 50 pages, 100K total chars. Stops on: no next button, empty page, duplicate content, or bot detection.
Incremental Snapshots
The diff tool returns only what changed since the last snapshot — additions, removals, changes. Massive token savings for monitoring and polling workflows.
HUD Overlays (LEAP_HUD=true)
When running headed, Leapfrog overlays visual feedback on every session:
Click ripple — expanding green circle at click coordinates (agent actions only)
Zoom-to-target — browser zooms to 1.15x on the clicked element briefly so agents (and humans) can visually track what's happening in tiled windows
Scroll-to-target — scrollIntoView before clicks so you can see what the agent is about to click
Minimal by design. No borders, no status bars, no cursor overlay — just the feedback that matters.
Multi-Terminal Tiling (LEAP_TILE=true)
Multiple Leapfrog instances share the screen via file-based coordination. Each instance tracks its own windows and a TilesCoordinator assigns global grid slots — no overlap, no manual arrangement. Set LEAP_TILE=true (or LEAP_TILE=master for the primary instance). Padding between tiles is configurable with LEAP_TILE_PADDING (default 8px).
Human Intervention
Leapfrog auto-detects situations that need a human — CAPTCHAs, login forms, OAuth redirects, Cloudflare challenges — and tries to self-resolve before pausing.
Auto-resolves first: clicks reCAPTCHA checkboxes, Cloudflare verify buttons, generic verify/continue buttons, then a second-pass retry — all before asking for help
External solvers: set LEAP_CAPTCHA_PROVIDER + LEAP_CAPTCHA_API_KEY for CapSolver, 2Captcha, or NopeCHA integration
Learns what works: remembers which resolution method succeeded per domain and tries the known-good method first on revisit
Automatically dismisses cookie consent banners across 10 frameworks (OneTrust, CookieBot, TrustArc, Quantcast, Didomi, Cookielaw, Osano, Usercentrics, + generic) plus text-matching fallback. Per-domain selector caching for instant replay on revisit.
Tracing (LEAP_TRACE=true)
Per-session Playwright tracing with screenshots + DOM snapshots. Export ZIP files viewable at trace.playwright.dev via the session_export_trace tool. Auto-saves on session destroy.
Self-Improvement
Leapfrog learns from every visit. Per-domain knowledge persists at ~/.leapfrog/domains/{domain}.json — 9 dimensions, all automatic:
#
Dimension
What it does
1
Wait strategies
Learns optimal wait method per domain (networkidle vs domcontentloaded vs load) + running average timing
2
Stealth tiers
Auto-escalates 0→3 when blocks are detected (2+ blocks in 1 hour). Starts at learned tier on revisit
3
Consent selectors
Remembers cookie banner dismiss selectors, auto-clicks on revisit
4
Challenge resolution
Records which CAPTCHA method worked (reCAPTCHA checkbox, Cloudflare verify, etc.), tries known-good method first
5
Stable element suppression
Identifies nav/footer/sidebar elements seen 3+ visits, suppresses from snapshots (30-40% token savings on mature domains)
6
Selector healing
Remembers element fingerprints → selectors, heals broken refs across visits
7
API endpoint caching
Discovered API endpoints persist across sessions
8
Interaction heat maps
Tracks which elements agents actually use, suppresses untouched elements (coming)
9
Strategy selection
Adversarial bandit (EXP3) for stealth config optimization. Use LEAP_STEALTH=auto to enable.
LRU eviction at 500 domains. Inspect with the domain_knowledge tool.
SSRF Hardening
URL validation blocks hex-encoded IPs (0x7f000001), octal notation (0177.0.0.1), CGNAT ranges (100.64.0.0/10), and redirect chains that resolve to internal addresses. Localhost and 127.0.0.0/8 are allowed by default for local dev workflows — set LEAP_BLOCK_LOCALHOST=true to block them.
The Ecosystem
Leapfrog uses pond metaphors to keep things memorable. Your agent is the frog.
Concept
Leapfrog term
What it means
Sessions
Ponds
Isolated browser contexts — cookies, storage, state
Tabs
Lily pads
Where the frog lands within a pond
Navigate
Leap
Jump to a URL, get a compact snapshot back
Snapshots
Surface
What you see on the surface — interactive @eN refs
Network traffic
Ripple
HTTP requests flowing under the surface
Console errors
Croak
Something went wrong in the browser
Stealth mode
Camouflage
Anti-bot evasion patches
All 36 Tools
Pond Management (11)
Tool
What it does
session_create
Open a new pond — isolated cookies, state, viewport, locale, timezone, stealth, proxy
session_destroy
Drain a pond and free the slot
session_list
See all active ponds with URLs and idle times
session_save_profile
Save auth state to disk for future ponds
session_list_profiles
List saved auth profiles
pool_status
Pool stats, memory, uptime
session_health
Is the pond healthy? Browser connected, page responsive?
profile_list
List saved persistent browser profiles
profile_delete
Delete a saved persistent browser profile and its data
profile_import_from_chrome
Import cookies and state from an installed Chrome profile
profile_warm
Pre-warm a profile by loading key URLs to establish cookies/state
Navigation & Snapshots (12)
Tool
What it does
navigate
Leap to a URL, return a compact @eN snapshot. Adaptive wait + stealth escalation built in.
snapshot
Re-read the surface (scope with CSS selector)
diff
Incremental snapshot — returns only what changed since last snapshot