bwb-browser
Supports Android/Termux with native Chromium installation, enabling browser automation on mobile devices.
Uses Google Chrome via Chrome DevTools Protocol for browser automation, including navigation, screenshots, and live event capture.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@bwb-browseropen https://example.com and capture network events"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
๐ฅ bwb-browser
Browser Without Bloat โ 30KB MCP Browser Automation Server
No Playwright. No Puppeteer. No 400MB downloads. Just raw Chrome DevTools Protocol.
bwb gives any AI agent (Claude Code, OpenCode, Cline, Antigravity, Cursor, Continue, etc.) the ability to browse the web, take screenshots, click elements, fill forms, execute JavaScript, and watch live page events โ all in a 30KB package.
Created by Krish Tiwari (@krshforever).
๐ The Breakthrough: Watch Your Pages Live
bwb is the first and only MCP browser tool that captures live page events.
sequenceDiagram
Agent->>bwb: browser_watch({action:"start", events:["all"]})
bwb->>Page: ๐ฌ Recording console, network, errors...
Agent->>bwb: browser_goto({url:"https://example.com"})
bwb->>Page: Navigate, interact...
Page-->>bwb: โก Console.log, Network request, JS Error
Agent->>bwb: browser_watch({action:"poll"})
bwb-->>Agent: [{console:"React mounted"}, {network:"GET /api/data 200"}, ...]
Agent->>bwb: browser_watch({action:"stop"})
bwb-->>Agent: โ
Recording stopped, 47 events capturedNo other MCP browser tool does this. Playwright MCP, Chrome DevTools MCP, Puppeteer MCP โ all are fire-and-forget. bwb is the black box recorder for browser automation.
Your agent can now:
Debug SPAs โ see React/Vue/Angular errors in real-time
Track API calls โ every network request, response, and status code
Detect loading states โ know when the page is actually done rendering
Intercept console output โ catch warnings, logs, and errors as they happen
Related MCP server: chrome-devtools-mcp-lite
๐ฆ Why bwb?
Feature | bwb | Playwright MCP | Puppeteer MCP | Chrome DevTools MCP |
Size | 30 KB | 200+ MB | 400+ MB | 300+ MB |
Dependencies | 3 tiny | 50+ | 30+ | 50+ |
Termux/Android | โ Native | โ | โ | โ |
Works on any platform | โ Linux, macOS, Windows, CI | โ ๏ธ Needs browsers | โ ๏ธ Needs Chromium | โ ๏ธ Needs Puppeteer |
Uses your existing Chrome | โ Auto-detects | โ Downloads its own | โ Downloads its own | โ Downloads its own |
Live page events | โ
| โ | โ | โ |
Setup time | 5 seconds | 5+ minutes | 5+ minutes | 5+ minutes |
bwb is 13,000x smaller than Puppeteer MCP.
โก Quick Install
npm install -g bwb-browserThat's it. 5 seconds. You're done.
Then add to your AI agent's MCP config:
{
"mcpServers": {
"bwb": {
"command": "bwb"
}
}
}๐ก For AI Agents: See AGENTS.md for the complete copy-paste prompt that auto-installs and configures bwb on Claude Code, OpenCode, Antigravity, Cline, Cursor, Continue.dev, Aider, Codex CLI, Cody, Windsurf, and any MCP-compatible agent.
๐ฅ 15 Tools
Tool | Description | Groundbreaking? |
| Navigate to a URL | |
| Take a screenshot (saves to disk + returns base64) | |
| Get page/selector HTML | |
| Get page/selector visible text | |
| Click an element (native CDP mouse events) | |
| Fill an input field (native CDP keyboard events) | |
| List links, buttons, inputs, headings | |
| Get page title | |
| Get current URL | |
| Execute JavaScript (with exception capture) | |
| Browser connection status | |
| ๐ฅ Live console, network, error, navigation capture | โ YES |
| Wait for element to appear/disappear | |
| Change viewport size (responsive testing) | |
| Go back in browser history |
๐ฏ Live Demo (Real Results from Termux/Android)
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ bwb-browser โ LIVE DEMO โ
โ 30KB ยท 15 tools ยท raw CDP ยท zero bloat ยท on Termux โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Step 1: Hacker News scraping โ
1.7s
โ #1: 7.1 Earthquake in Japan
โ #2: About the security content of macOS Tahoe 26.6
โ #3: What Even Are Microservices?
Step 2: GitHub Trending exploration โ
5.1s
โ pascalorg/editor, jenkinsci/jenkins, moeru-ai/airi
Step 3: Google search fill + submit โ
4.0s
โ Filled "bwb browser automation termux", submitted
Step 4: Wikipedia article extraction โ
3.2s
โ "A headless browser is a web browser without a GUI..."
Step 5: Rapid-fire 5 sites in 24s โ
24.1s
โ example.com: 744ms | httpbin.org/ip: 1635ms
โ github.com: 5146ms | wikipedia.org: 15.3s
โ news.ycombinator.com: 1231ms
Step 6: System status โ
0.1s
โ Connected: true ยท Chrome PID: 15409
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Total: 44.9s ยท 6 steps ยท 7 screenshots
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ๐ Prerequisites
Just Chrome or Chromium installed anywhere on your system. bwb auto-detects it.
Platform | Install |
Termux/Android |
|
Linux (Debian/Ubuntu) |
|
macOS |
|
Windows | Download from google.com/chrome |
CI/Docker |
|
๐ Configuration
CLI flag | Env var | Default | Description |
|
| auto-detected | Path to Chrome/Chromium binary |
|
|
| Remote debugging port |
|
|
| Browser profile directory |
|
|
| Run headless ( |
|
|
| Screenshot save location |
|
|
| Navigation timeout in ms |
Note: On Android/Termux, screenshots default to /storage/emulated/0/Download/bwb-screenshots/ so they're accessible from any file manager or gallery app.
๐ค Compatible AI Agents
bwb works with every major AI coding agent via MCP:
Agent | Config File |
Claude Code |
|
OpenCode |
|
Antigravity CLI |
|
Cline (VS Code) |
|
Continue.dev |
|
Cursor |
|
Aider | Custom tool integration |
Codex CLI |
|
Cody (Sourcegraph) | MCP config |
Windsurf | MCP config |
๐ฏ Give this to any AI agent to auto-install bwb: See the copy-paste prompt in AGENTS.md
๐ฅ Using browser_watch (The Game Changer)
Start watching:
browser_watch({action: "start", events: ["all"]})Browse around:
browser_goto({url: "https://example.com"})
browser_click({selector: "button"})See everything that happened:
browser_watch({action: "poll"})
# โ [{console: "App initialized"}, {network: "GET /api/data 200"}, ...]Stop recording:
browser_watch({action: "stop"})The agent gets structured event data โ not just screenshots. It can SEE what the page is doing internally.
๐ Platform Support
Platform | Status | Notes |
Termux/Android | โ Verified | Native, no containers. Chromium via |
Linux | โ | Works with any Chrome/Chromium |
macOS | โ | Google Chrome auto-detected |
Windows | โ | Chrome auto-detected |
CI/CD (GitHub Actions) | โ | Use |
Docker | โ | Install chromium in container |
๐ฆ What's in the Box?
bwb-browser (37KB unpacked)
โโโ server.mjs MCP server โ 15 tools, CDP integration
โโโ bin/bwb CLI entry point
โโโ AGENTS.md Agent integration guide + copy-paste prompt
โโโ BENCHMARKS.md Competitive comparison data
โโโ LICENSE MIT
โโโ README.md This fileZero bloat. No AI framework. No bundled browser. Just the bridge between your agent and Chrome.
๐ Comparison: bwb vs The World
Metric | bwb | Playwright MCP | Puppeteer MCP | Chrome DevTools MCP |
Unpacked size | 30 KB | ~200 MB | ~400 MB | ~300 MB |
npm install size | ~2 MB | ~500 MB | ~400 MB | ~300 MB |
Install time | 5 seconds | 5+ minutes | 5+ minutes | 5+ minutes |
Dependencies | 3 packages | 50+ packages | 30+ packages | 50+ packages |
Live event capture | โ
| โ | โ | โ |
Termux/Android | โ Native | โ | โ | โ |
Uses existing Chrome | โ Auto-detect | โ Downloads its own | โ Downloads its own | โ Downloads its own |
Dark mode | โ MIT | โ Apache 2.0 | โ Apache 2.0 | โ Apache 2.0 |
๐ Roadmap
v2.0.x โ Current: 15 tools,
browser_watch, stablev2.1 โ Stealth mode (bot detection bypass via CDP script injection)
v2.2 โ Cookie/session management (
browser_getCookies,browser_setCookie)v3.0 โ Parallel tab management, persistent sessions, network interception
bwb Cloud โ Managed browser instances, pay-per-use (coming 2027)
๐ License
MIT ยฉ Krish Tiwari (@krshforever)
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/krshforever/bwb-browser'
If you have feedback or need assistance with the MCP directory API, please join our Discord server