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 ```bash 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: ```json { "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). ```bash npm test ``` ## Requirements - Node.js >= 18 - Chromium (auto-installed via Playwright) ## License MIT