Blueprint MCP for Chrome

Browser automation for Claude without token limits. Uses CSS selectors, not snapshots. Open source, zero telemetry.

Give Claude Code (and other AI assistants) direct control of your real Chrome browser Stop wrestling with headless browsers, bot detection, and authentication flows. Blueprint MCP for Chrome bridges the Model Context Protocol (MCP) with your actual Chrome browser - keeping you logged into all your sites, preserving your extensions, and using your real browser fingerprint. THE CRITICAL ADVANTAGE: Efficient browser automation that does not consume your AI's context. Instead of sending massive page snapshots with every action (which quickly exhausts context limits and often exceeds MCP response size limits), Blueprint MCP lets your AI interact directly - click, type, navigate - and only fetch page content when specifically needed. This enables complex, multi-step workflows that would be impossible with snapshot-based approaches. Perfect for developers using Claude Code, Claude Desktop, Cursor, or any MCP-compatible AI client who need to automate web tasks without the headaches of Playwright/Puppeteer/Selenium. WHY BLUEPRINT MCP + CLAUDE CODE CHANGES EVERYTHING The problem: Traditional browser automation requires sending full page snapshots after every action, consuming thousands of tokens per interaction and hitting response size limits. You also lose logged-in sessions, face bot detection, and spend time configuring browser profiles. The solution: Blueprint MCP connects your AI assistant to your real Chrome browser through direct commands. Your AI controls the browser - click, type, navigate - without needing page snapshots unless explicitly requested. This preserves context for actual decision-making instead of wasting it on redundant page content. What this enables: - AI-powered web scraping that bypasses bot detection - Automated form filling with your saved passwords - Testing workflows using your logged-in accounts - Content extraction from authenticated sites - Browser automation that works with 2FA and CAPTCHAs KEY FEATURES Real Browser Automation: - Uses your actual Chrome profile - Stays logged into Gmail, GitHub, AWS, etc. - Stealth mode - No bot detection. Uses your real browser fingerprint - Extension support - Works alongside your existing Chrome extensions - Session persistence - No re-authentication needed Native MCP Integration: - 20+ browser tools exposed via Model Context Protocol - Tab management - Create, switch, close tabs programmatically - DOM inspection - Get accessible page content - Network monitoring - Capture requests, replay with authentication - JavaScript execution - Run code in page context Developer Experience: - Zero setup - Install extension, works instantly - Auto-reconnection - Survives browser restarts - Debug mode - Verbose logging for troubleshooting - Status visibility - Real-time connection status Two Connection Modes: - Free (Local) - WebSocket on localhost:5555, no cloud dependencies - PRO (Cloud Relay) - Control browser from anywhere, multiple AI clients Comprehensive Automation: - Screenshots (full page or elements) - Content extraction as Markdown - Form automation (fill, dropdowns, file uploads) - Mouse/keyboard control (click, type, hover, drag-drop) - Performance metrics (Web Vitals) Advanced Capabilities: - Tech stack detection (40+ frameworks) - Network request replay - PDF export - Dialog handling (alert/confirm/prompt) - Extension management HOW IT WORKS Setup (3 steps, 2 minutes): 1. Install MCP server: npm install -g @railsblueprint/blueprint-mcp 2. Install this Chrome extension 3. Configure AI client: claude mcp add browser npx @railsblueprint/blueprint-mcp@latest The extension auto-connects when your AI client starts the MCP server. SECURITY & PRIVACY Free Tier (Local Mode): - All communication stays on your machine (localhost WebSocket) - Zero data sent to cloud - No tracking, telemetry, or analytics - Works completely offline - No account required Open Source: - Full source: https://github.com/railsblueprint/blueprint-mcp - Apache 2.0 license - Audit the code yourself PRICING Free Tier - $0/month - All 20+ browser automation tools - Local WebSocket connection - Unlimited usage - Zero cloud dependencies PRO Tier - $5/month or $50/year - Cloud Relay (control from anywhere) - Multiple browsers - Multi-client access - Auto-reconnection - Priority support SUPPORT Documentation: https://github.com/railsblueprint/blueprint-mcp GitHub Issues: https://github.com/railsblueprint/blueprint-mcp/issues Blueprint MCP for Chrome - Give your AI assistant the browser automation it deserves. https://blueprint-mcp.railsblueprint.com