SuperSurf

About

SuperSurf gives AI coding agents direct control of your Chrome browser through the Model Context Protocol (MCP). Connect any MCP-compatible assistant — Claude, Cursor, Windsurf — and let it navigate pages, fill forms, capture screenshots, inspect network traffic, and run JavaScript, all through a secure localhost-only WebSocket. No data ever leaves your machine.

The extension pairs with a local Node.js server (supersurf-mcp on npm) that handles the MCP handshake and tool routing. Built for developers who want their AI to see and interact with the real web — real cookies, real sessions, real browser profiles. Open source under Apache-2.0.

WHY EXTENSION-BASED?

Unlike tools that spin up headless browsers, SuperSurf operates inside your real browser profile. Page interaction runs through Chrome's content script isolated world — invisible to page JavaScript. No CDP fingerprints, no VM script artifacts, no detectable automation flags. The extension itself is a human signal to anti-bot systems.

30+ TOOLS INCLUDED

- Navigation & tab management
- Click, type, hover, scroll, drag, key press
- Accessibility tree snapshots & element lookup
- Full-page and element screenshots
- PDF export
- Network request monitoring & inspection
- Console message capture
- Form filling & secure credential injection
- CSS style inspection
- JavaScript evaluation
- Performance metrics (FCP, LCP, CLS, TTFB)
- File downloads
- Multi-agent session multiplexing

SECURE BY DESIGN

- Localhost-only WebSocket — no external connections
- Credentials injected extension-side from environment variables — your AI agent never sees raw passwords
- Zero runtime dependencies in the extension — browser APIs only
- 100% open source — read every line at github.com/LiquidBuiltIt/Supersurf

PLATFORM SUPPORT

Currently supports macOS and Linux. Windows is not yet supported — if you'd like to see it, vote here: https://github.com/LiquidBuiltIt/Supersurf/issues/1

GETTING STARTED

1. Install this extension
2. Run: npx supersurf-mcp@latest (or add to your MCP client config)
3. Your AI agent now has a browser

Full docs and source: github.com/LiquidBuiltIt/Supersurf