cdp-bridge-mcp-browser-control

Control live browser sessions via Chrome DevTools Protocol while preserving login state and cookies.

7|2|Updated May 16, 2026
One-click install
npx skills add https://github.com/reason-machines/mcp-skills --skill cdp-bridge-mcp-browser-control-reason-machines
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cdp-bridge-mcp-browser-control
Source: https://github.com/reason-machines/mcp-skills/tree/main/skills/cdp-bridge-mcp-browser-control
Command: npx skills add https://github.com/reason-machines/mcp-skills --skill cdp-bridge-mcp-browser-control-reason-machines

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Headless automation tools lose authentication state and require re-login, making it hard for LLM agents to interact with sites where you are already signed in. This Skill bridges LLM clients to your real, open browser tabs through CDP and a companion extension, keeping cookies and session state intact. ## Core Features & Use Cases - Live Tab Control: List, switch between, and navigate already-open browser tabs without launching a separate browser instance. - Token-Efficient Page Scanning: Extract simplified HTML or plain text with scripts, styles, and hidden elements removed for LLM consumption. - JavaScript Execution with CSP Fallback: Run scripts in the page's MAIN world, automatically falling back to CDP Runtime.evaluate when content security policies block injection. - Use Case: You are logged into Medium in an open tab. Ask the agent to find that tab, switch to it, and extract the article text—no credentials or cookie transfers needed. ## Quick Start Ask the agent to list your open browser tabs and extract the main article text from the tab you specify.

Frequently Asked Questions about cdp-bridge-mcp-browser-control

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I control my existing browser tabs with an LLM agent?▼

Install the cdp-bridge MCP server via uvx, load the companion Chrome extension in developer mode, and configure your MCP client for stdio or streamable-http transport. The browser_get_tabs tool then lists all connected tabs for the agent to target.

What is the difference between CDP bridge and headless browser automation?▼

CDP bridge connects to your already-open, logged-in browser tabs, preserving authentication state and cookies. Headless tools launch separate browser instances that require re-authentication and lose your current session context.

Does cdp-bridge work when a site's CSP blocks script injection?▼

Yes, the extension automatically falls back to CDP Runtime.evaluate when content security policies block chrome.scripting.executeScript. If both fail, check the browser console for specific CSP violations and wrap code in an IIFE.

Why does browser_get_tabs return no tabs?▼

Verify the extension is loaded and enabled at chrome://extensions, check its service worker console for connection status, and ensure the MCP server is running. The WebSocket server must be listening on 127.0.0.1:18765.

How do I reduce token usage when scanning web pages?▼

Use the text format option in browser_scan for plain text extraction, which produces fewer tokens than HTML. Alternatively, execute JavaScript first to narrow the DOM to a specific subtree before scanning.