Chrome DevTools MCP: Debug the Browser From Your Agent
ChromeDevTools/chrome-devtools-mcpChrome DevTools MCP is an MCP server that gives a coding agent access to a live Chrome browser through the full Chrome DevTools toolset. Your agent — Claude, Cursor, Copilot, or Antigravity — can record performance traces, read network requests and console messages, take screenshots, and automate actions with Puppeteer.
Reach for Chrome DevTools MCP if you want your coding agent to actually see what a page is doing — real performance traces, network calls, console errors — instead of guessing from the code. Skip it if your work never touches the browser, or you only need scripted automation, where plain Puppeteer or Playwright is lighter than wiring up an MCP server.
The problem it solves
A coding agent debugging a web app is usually working blind: it reads your source but can't see the rendered page, the failing network request, or the console error that only shows up at runtime. You end up copy-pasting DevTools output back into the chat by hand, which is slow and loses the source-mapped stack traces that make an error legible.
What is it?
Chrome DevTools MCP is an open-source (Apache-2.0) Model Context Protocol server, written in TypeScript, that connects a coding agent to a real Chrome browser. It exposes Chrome DevTools capabilities — performance tracing, network and console inspection, screenshots, and Puppeteer-driven automation — as MCP tools, so the agent can inspect and debug a live page. A CLI is also provided for use without MCP.
Why it's getting attention
MCP has become the common way to give AI coding tools real capabilities, and a browser is one of the most useful things to hand an agent. This one comes from the Chrome DevTools team itself, targets the runtime blind spot directly, and works with Claude, Cursor, Copilot, and Antigravity, which is why it's landed with people building agent-driven web workflows.
Key features
- ✓Performance insights: records Chrome DevTools traces and extracts actionable findings
- ✓Browser debugging: inspects network requests, console messages, and takes screenshots
- ✓Source-mapped stack traces, so runtime errors stay readable
- ✓Puppeteer-based automation that waits for action results automatically
- ✓Works with MCP clients like Claude, Cursor, Copilot, and Antigravity
- ✓A standalone CLI for use without an MCP client
Best use cases
- •Letting an agent record and read a performance trace to find what's slowing a page down
- •Debugging a runtime error from console output with source-mapped stack traces
- •Inspecting failing network requests during an agent-driven fix
- •Automating browser actions in a coding workflow via Puppeteer
How to install / try
Chrome DevTools MCP is published on npm as `chrome-devtools-mcp`. You add it to your MCP client's config as a server — for example the args `["-y", "chrome-devtools-mcp@latest"]` — and it runs via npx. It officially supports Google Chrome and Chrome for Testing. See the repo's tool reference and troubleshooting docs for client-specific setup.
How to use
Once the MCP server is registered with your client, your agent calls its tools to drive Chrome: record a trace, read the network panel, check the console, take a screenshot, or automate a click. Flags let you tune data collection — `--no-usage-statistics` opts out of Google's usage stats and `--no-performance-crux` disables CrUX field-data lookups.
Strengths
- ✓Comes from the Chrome DevTools team, so it tracks real DevTools capabilities
- ✓Gives an agent runtime visibility — performance, network, console — not just source
- ✓Keeps source-mapped stack traces, which makes runtime errors actually debuggable
- ✓Doubles as a CLI, so you can use it without committing to an MCP client
Limitations & risks
- △It exposes browser content to the MCP client, so avoid pointing it at sessions with sensitive or personal data (the README says so directly)
- △Officially supports Google Chrome and Chrome for Testing only; other Chromium browsers may misbehave
- △Usage statistics collection is enabled by default — you opt out with a flag
- △It's a browser-debugging tool; for pure scripted automation, plain Puppeteer or Playwright is a lighter dependency
Alternatives
Who should try it — and who should skip
Developers who drive a coding agent (Claude, Cursor, Copilot, Antigravity) and want it to debug and profile real pages instead of reasoning from source alone. If your agent work is browser-heavy, the runtime visibility pays off. If you never touch the browser or only need scripted automation, it's more setup than you need.
Frequently asked questions
Chrome DevTools MCP is an MCP server from the Chrome DevTools team that lets a coding agent control and inspect a live Chrome browser — recording performance traces, reading network and console data, and automating actions with Puppeteer.
The README lists MCP clients such as Claude, Cursor, Copilot, and Antigravity. A CLI is also provided for use without an MCP client.
It officially supports Google Chrome and Chrome for Testing. Other Chromium-based browsers may work but aren't guaranteed, per the README.
Usage statistics are enabled by default and can be disabled with `--no-usage-statistics`. Performance tools may query the Google CrUX API, which you can turn off with `--no-performance-crux`.