leapfrog

Leapfrog

Multi-session browser MCP for AI agents.
21 tools. 15 parallel sessions. Stealth. Humanization. Up to 10x fewer tokens.

npm i leapfrog  |  Works with Claude Code, Cursor, Windsurf

---

The Problem

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.

┌─────────────────────────────────────────────────────┐
│  Playwright MCP                                     │
│  ████████████████████████████████████████  ~14,000   │
│                                                     │
│  Leapfrog                                           │
│  █████                                    ~1,400    │
└─────────────────────────────────────────────────────┘
          tokens per page (Hacker News, real test)

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 --doctor   # verify everything works
npx leapfrog --config   # print MCP config to paste

Add to ~/.mcp.json (Claude Code) or your editor's MCP config:

{
  "leapfrog": {
    "command": "npx",
    "args": ["-y", "leapfrog"],
    "env": {
      "LEAP_MAX_SESSIONS": "15"
    }
  }
}

Chromium installs automatically. If it fails: npx playwright install chromium

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
Auth profile reuse	Yes	No	No
SSRF protection	Yes	No	No

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 19 Tools

Pond Management (7)

Tool	What it does
session_create	Open a new pond — isolated cookies, state, viewport
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?

Navigation & Snapshots (6)

Tool	What it does
navigate	Leap to a URL, return a compact @eN snapshot
snapshot	Re-read the surface (scope with CSS selector)
act	Click, fill, type, check, select, press, scroll, hover, back, forward
wait_for	Wait for element / text / network idle / navigation / JS expression
screenshot	Capture PNG (full page or element)
extract	Pull text, HTML, title, URL, or evaluate JS

Tab Management (3)

Tool	What it does
tabs_list	List all pads in a pond
tab_switch	Hop to another pad (-1 for most recent popup)
tab_close	Close a pad (can't close the last one)

Network Intelligence (3)

Tool	What it does
network_log	See HTTP traffic — filter by URL, method, status, content-type
console_log	Read browser console output, filtered by level
network_intercept	Block, mock, or log requests by URL pattern

Environment Variables

Variable	Default	Description
LEAP_MAX_SESSIONS	15	Max concurrent sessions
LEAP_IDLE_TIMEOUT	300000	Session idle timeout in ms (5 min)
LEAP_HEADLESS	true	Set false to watch the browser
LEAP_ALLOW_JS	true	Allow JS evaluation in extract and wait_for
LEAP_STEALTH	true	Stealth mode (anti-bot evasion)
LEAP_LOG_LEVEL	info	debug / info / warn / error

Tests

 74 passing across 5 suites

Session management, snapshot engine, network intelligence, tab management, security (SSRF, URL scheme blocking, path traversal).

npm test

Requirements

• Node.js >= 18
• Chromium (auto-installed via Playwright)

License

MIT