Lum Browser MCP

Automate your browser with AI - powered by lum.tools
lum.tools • Platform • Get API Key

About

Lum Browser MCP is an MCP server + Chrome extension that allows you to automate your browser using AI applications like VS Code, Claude, Cursor, and Windsurf.

This fork integrates with lrok to expose your local MCP server to the internet with secure HTTPS tunnels.

Features

• ⚡ Fast: Automation happens locally on your machine, resulting in better performance without network latency.
• 🔒 Private: Since automation happens locally, your browser activity stays on your device and isn't sent to remote servers.
• 👤 Logged In: Uses your existing browser profile, keeping you logged into all your services.
• 🥷🏼 Stealth: Avoids basic bot detection and CAPTCHAs by using your real browser fingerprint.
• 🌐 Tunnel Support: Expose your MCP server to the internet using lrok tunnels (coming soon).

Installation

npm install -g @lum-tools/browsermcp

Usage

Basic Usage

lum-browsermcp

With lrok Tunnel (Coming Soon)

# Configure your API key (get one at https://platform.lum.tools/keys)
lum-browsermcp --api-key lum_your_api_key_here

# Or use environment variable
export LUM_API_KEY=lum_your_api_key_here
lum-browsermcp --tunnel

Configuration

API Key

Get your API key from platform.lum.tools/keys and save it:

# Via environment variable
export LUM_API_KEY=lum_your_api_key_here

# Or save to config file
# Config is stored in ~/.lrok/config.toml

Links

• lum.tools: lum.tools - Main website
• Platform: platform.lum.tools - Account management
• API Keys: platform.lum.tools/keys - Get your API key
• lrok: github.com/lum-tools/lrok - Tunnel service

Contributing

This repo contains all the core MCP code for Lum Browser MCP.

Credits

Lum Browser MCP was adapted from the BrowserMCP project, which was adapted from the Playwright MCP server.

License

MIT License - see LICENSE file

---

Made with ❤️ by lum.tools