Gasoline Agentic Browser Devtool MCP

Browser observability for AI coding agents - autonomously debug and fix issues in real time.

Streams console logs, network errors, WebSocket events, and exceptions to Claude Code, Cursor, Windsurf, Claude Desktop, Zed, or any MCP-compatible assistant.

Installation

pip install gasoline-mcp

The correct platform-specific binary will be installed automatically.

Usage

With Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "gasoline": {
      "type": "stdio",
      "command": "gasoline-mcp"
    }
  }
}

With Claude Code

Add to your .mcp.json:

{
  "mcpServers": {
    "gasoline": {
      "type": "stdio",
      "command": "gasoline-mcp"
    }
  }
}

Standalone

gasoline-mcp

Install MCP config + bundled skills

gasoline-mcp --install

This installs MCP config for detected clients and managed bundled skills (debug-triage, performance, regression-test, api-validation, ux-audit, site-audit) into your agent skill directories.

Chrome Extension

Install the Chrome extension to capture browser telemetry:

Chrome Web Store Link (coming soon)

Or load from source:

1. Download the extension from GitHub Releases
2. Go to chrome://extensions
3. Enable "Developer mode"
4. Click "Load unpacked" and select the extension/ folder

Features

• Console logs - All levels (log, warn, error, info, debug)
• Network requests - Full request/response capture with bodies
• WebSocket events - Real-time bidirectional message capture
• User actions - Clicks, navigation, form submissions
• Errors - Unhandled exceptions with stack traces
• Web Vitals - LCP, FID, CLS, INP, FCP, TTFB
• Accessibility audits - WCAG compliance scanning
• Security audits - CSP generation, third-party analysis
• AI Web Pilot - Execute JavaScript, highlight elements, manage state

Documentation

• Getting Started
• GitHub Repository
• Issue Tracker

Privacy

100% local. No cloud, no analytics, no telemetry. Logs never leave your machine.

License

AGPL-3.0 — Free for personal and internal company use. Commercial licensing available for proprietary integration.