# Browspark

> Local MCP server and Chrome extension that let AI agents operate and debug websites in your browser.

- [Introduction](https://docs.browspark.krishm.dev/index.md): Browspark lets AI agents operate and debug websites in your own Chrome, with the user in control of what is shared.
- [Quickstart](https://docs.browspark.krishm.dev/get-started/quickstart.md): From zero to an agent driving a tab in about five minutes.
- [Installation](https://docs.browspark.krishm.dev/get-started/installation.md): Every install option in detail: source, packaged extension, compiled companion, and browser choices.
- [How it works](https://docs.browspark.krishm.dev/get-started/how-it-works.md): The three pieces, how they talk, and what happens on a single tool call.
- [Connect an agent](https://docs.browspark.krishm.dev/connect/agents.md): Register the companion with Claude Code, Codex, OpenCode, Cursor, Kilo or Antigravity over stdio.
- [HTTP endpoint](https://docs.browspark.krishm.dev/connect/http-endpoint.md): Connect clients that take a URL instead of a command: web agents, hosted assistants, sandboxed IDEs.
- [Multiple agents](https://docs.browspark.krishm.dev/connect/multiple-agents.md): Run Claude Code, Codex, OpenCode, Cursor and HTTP clients against the same browser at once without collisions.
- [Extension mode and developer mode](https://docs.browspark.krishm.dev/concepts/modes.md): What each mode can do, what Chrome blocks for extensions, and how the companion picks between them.
- [Tabs and sharing](https://docs.browspark.krishm.dev/concepts/tabs-and-sharing.md): Which tabs an agent can see, how a target tab is chosen, and what attaching means.
- [Snapshots and refs](https://docs.browspark.krishm.dev/concepts/snapshots-and-refs.md): How the agent sees a page and addresses elements without CSS selectors.
- [Developer browser](https://docs.browspark.krishm.dev/concepts/developer-browser.md): Named contexts, persistent profiles, proxies, extensions, headless runs, live view and the CDP endpoint.
- [Tool policy](https://docs.browspark.krishm.dev/concepts/tool-policy.md): Switch individual tools off from the dashboard and control whether a developer browser may open.
- [Privacy and security](https://docs.browspark.krishm.dev/concepts/privacy-and-security.md): What leaves your machine (nothing), what the agent can reach, and how access is bounded.
- [Overview page](https://docs.browspark.krishm.dev/dashboard/overview.md): Connection state, setup snippets for every client, and today's numbers at a glance.
- [Tabs page](https://docs.browspark.krishm.dev/dashboard/tabs.md): Share and unshare tabs across every window, or share everything.
- [Tools page](https://docs.browspark.krishm.dev/dashboard/tools.md): Every tool the companion exposes, with a switch to turn it off.
- [Activity page](https://docs.browspark.krishm.dev/dashboard/activity.md): A live log of what agents did, when the activity log is switched on.
- [Settings page](https://docs.browspark.krishm.dev/dashboard/settings.md): Pairing, port, HTTP endpoint, developer-browser policy, agent overlay, activity log, appearance and the emergency stop.
- [Automate a website](https://docs.browspark.krishm.dev/guides/automate-a-website.md): The snapshot → act → verify loop, with the tools an agent uses for each step.
- [Read and extract](https://docs.browspark.krishm.dev/guides/read-and-extract.md): Markdown from pages and URLs, tables, links, structured records, and WebMCP tools.
- [Debug a web app](https://docs.browspark.krishm.dev/guides/debug-a-web-app.md): Inspection sessions, console and network search, source maps, breakpoints, elements, storage and workers.
- [Network mocking and throttling](https://docs.browspark.krishm.dev/guides/network-mocking.md): Mock endpoints, block hosts, throttle, disable the cache, and replay requests during an inspection session.
- [Performance and memory](https://docs.browspark.krishm.dev/guides/performance-and-memory.md): Traces with Web Vitals, CPU profiles, heap snapshots and leak detection, coverage, and Lighthouse.
- [Record and export to Playwright](https://docs.browspark.krishm.dev/guides/record-and-export.md): Record a flow, add assertions and parameters, replay it, and export a Playwright test.
- [Downloads, PDFs and domain policies](https://docs.browspark.krishm.dev/guides/downloads-pdf-and-policies.md): Collect files the browser downloads, print pages to PDF, and fence where tabs may go.
- [Troubleshooting](https://docs.browspark.krishm.dev/guides/troubleshooting.md): Symptoms, causes and fixes for connection, tab, tool and developer-browser problems.
- [CLI and environment](https://docs.browspark.krishm.dev/reference/cli-and-environment.md): Flags, environment variables, scripts and what the companion prints.
- [Files and directories](https://docs.browspark.krishm.dev/reference/files-and-directories.md): Everything Browspark writes to disk and what each file is for.
- [Capability matrix](https://docs.browspark.krishm.dev/reference/capability-matrix.md): Which DevTools Protocol domains work in extension mode versus developer mode, probed live.
- [Wire protocol](https://docs.browspark.krishm.dev/reference/wire-protocol.md): The JSON messages between the companion and the extension over the local WebSocket.
- [Development](https://docs.browspark.krishm.dev/reference/development.md): Building, testing, regenerating docs, and how the code is organised.
- [Tools overview](https://docs.browspark.krishm.dev/tools/overview.md): All 43 tools by group, with the mode each needs.
- [browser_status](https://docs.browspark.krishm.dev/tools/browser/browser_status.md): Connection status for both modes, pairing instructions, shared tabs across all windows, and open dialogs.
- [browser_session](https://docs.browspark.krishm.dev/tools/browser/browser_session.md): Developer-mode browsers: a separate Chrome the companion launches, without the user's logins.
- [browser_tabs](https://docs.browspark.krishm.dev/tools/browser/browser_tabs.md): List, open, close, or activate tabs across all windows.
- [browser_navigate](https://docs.browspark.krishm.dev/tools/browser/browser_navigate.md): Navigate a tab: goto a URL, reload, back, or forward.
- [browser_snapshot](https://docs.browspark.krishm.dev/tools/browser/browser_snapshot.md): Accessible snapshot of the page as an indented tree.
- [browser_read](https://docs.browspark.krishm.dev/tools/browser/browser_read.md): Read page content: visible text, markdown (main content converted with headings, lists, links, code, tables), links, tables (as row arrays), or raw HTML.
- [browser_fetch](https://docs.browspark.krishm.dev/tools/browser/browser_fetch.md): Fetch a URL and return its main content as markdown (or text/html) without leaving a tab behind: opens a background agent tab, waits for load, reads, closes.
- [browser_policy](https://docs.browspark.krishm.dev/tools/browser/browser_policy.md): Restrict where a tab (or every tab the agent opens from now on) may navigate and load from: allow lists domains that are permitted (everything else is blocked),
- [browser_download](https://docs.browspark.krishm.dev/tools/browser/browser_download.md): Downloads started in the browser: list them, or wait for the newest matching download to complete, including one already completed, and get its file path when a
- [browser_pdf](https://docs.browspark.krishm.dev/tools/browser/browser_pdf.md): Print the page to a PDF file (like Print → Save as PDF).
- [browser_webmcp](https://docs.browspark.krishm.dev/tools/browser/browser_webmcp.md): WebMCP: pages can expose typed tools to agents via navigator.modelContext.
- [browser_extract](https://docs.browspark.krishm.dev/tools/browser/browser_extract.md): Structured extraction: for every element matching `items`, read named fields as text or an attribute.
- [browser_click](https://docs.browspark.krishm.dev/tools/browser/browser_click.md): Click an element by ref with real mouse events.
- [browser_fill](https://docs.browspark.krishm.dev/tools/browser/browser_fill.md): Replace the contents of a text input, textarea, or contenteditable.
- [browser_select](https://docs.browspark.krishm.dev/tools/browser/browser_select.md): Choose option(s) in a select by value or visible label.
- [browser_upload](https://docs.browspark.krishm.dev/tools/browser/browser_upload.md): Set files on an input type=file by ref.
- [browser_key](https://docs.browspark.krishm.dev/tools/browser/browser_key.md): Press a key or chord on the focused element ("Enter", "Tab", "Escape", "ArrowDown", "Shift+Tab", "a"), or type text.
- [browser_scroll](https://docs.browspark.krishm.dev/tools/browser/browser_scroll.md): Scroll the page, or the nearest scrollable ancestor of a ref.
- [browser_screenshot](https://docs.browspark.krishm.dev/tools/browser/browser_screenshot.md): Screenshot the viewport, the full page, or one element.
- [browser_wait](https://docs.browspark.krishm.dev/tools/browser/browser_wait.md): Wait until text appears/disappears, the URL contains a string, or a ref reaches a state.
- [browser_dialog](https://docs.browspark.krishm.dev/tools/browser/browser_dialog.md): Accept or dismiss an open JavaScript alert/confirm/prompt/beforeunload dialog.
- [browser_batch](https://docs.browspark.krishm.dev/tools/browser/browser_batch.md): Run several tool calls in order in one round trip.
- [devtools_session](https://docs.browspark.krishm.dev/tools/devtools/devtools_session.md): Start or stop an inspection session on a tab.
- [devtools_events](https://docs.browspark.krishm.dev/tools/devtools/devtools_events.md): Read or wait for events collected in the inspection session: console messages, exceptions, request start/finish/fail, breakpoint pauses, navigations, issues, se
- [devtools_capabilities](https://docs.browspark.krishm.dev/tools/devtools/devtools_capabilities.md): Report the browser version, connection mode, and which CDP domains work for a tab (probed live, cached per browser).
- [devtools_cdp](https://docs.browspark.krishm.dev/tools/devtools/devtools_cdp.md): Developer mode only: run any Chrome DevTools Protocol command on a tab (or on the browser target with target:"browser").
- [devtools_console](https://docs.browspark.krishm.dev/tools/devtools/devtools_console.md): Search collected console output: logs, warnings, errors, uncaught exceptions, and browser log entries with stack traces.
- [devtools_evaluate](https://docs.browspark.krishm.dev/tools/devtools/devtools_evaluate.md): Evaluate JavaScript in the page (or a specific frame/context, or the paused call frame) and return the value or the exception.
- [devtools_network](https://docs.browspark.krishm.dev/tools/devtools/devtools_network.md): Inspect network activity collected in the session (preserved across reloads).
- [devtools_sources](https://docs.browspark.krishm.dev/tools/devtools/devtools_sources.md): Sources panel: list loaded scripts, stylesheets, documents, frames and execution contexts; get file contents (optionally the original source via source map); se
- [devtools_debugger](https://docs.browspark.krishm.dev/tools/devtools/devtools_debugger.md): JavaScript debugger.
- [devtools_elements](https://docs.browspark.krishm.dev/tools/devtools/devtools_elements.md): Elements panel.
- [devtools_performance](https://docs.browspark.krishm.dev/tools/devtools/devtools_performance.md): Performance panel.
- [devtools_profile](https://docs.browspark.krishm.dev/tools/devtools/devtools_profile.md): CPU profiler.
- [devtools_memory](https://docs.browspark.krishm.dev/tools/devtools/devtools_memory.md): Memory panel.
- [devtools_coverage](https://docs.browspark.krishm.dev/tools/devtools/devtools_coverage.md): Coverage panel.
- [devtools_storage](https://docs.browspark.krishm.dev/tools/devtools/devtools_storage.md): Application storage.
- [devtools_workers](https://docs.browspark.krishm.dev/tools/devtools/devtools_workers.md): Service workers and PWA.
- [devtools_emulation](https://docs.browspark.krishm.dev/tools/devtools/devtools_emulation.md): Device and rendering emulation.
- [devtools_accessibility](https://docs.browspark.krishm.dev/tools/devtools/devtools_accessibility.md): Accessibility tree and browser-reported issues.
- [devtools_security](https://docs.browspark.krishm.dev/tools/devtools/devtools_security.md): Security panel.
- [devtools_lighthouse](https://docs.browspark.krishm.dev/tools/devtools/devtools_lighthouse.md): Run Lighthouse (official CLI) against the developer-mode browser and return category scores, key metrics, failing audits, plus HTML and JSON report artifacts.
- [devtools_recorder](https://docs.browspark.krishm.dev/tools/devtools/devtools_recorder.md): Record and replay browser actions.