BrowserTools MCP — documentation

Source for the BrowserTools MCP documentation site, built with Mintlify.

Documents version 2.0. If you find something here that contradicts the repository's README.md, MIGRATION.md or SECURITY.md, the repository is correct — please open an issue.

Pages

File	Covers
installation.mdx	Requirements, MCP client config, loading the extension, troubleshooting
quickstart.mdx	What to ask your agent, by task
tools.mdx	All 16 tools, 3 prompts and 5 resource templates
configuration.mdx	Flags, environment variables, --doctor, panel settings
migration.mdx	Upgrading from 1.x
security.mdx	What is captured, what is scrubbed, 1.x vulnerabilities
contributing.mdx	Architecture and contribution guide

Development

Install the Mintlify CLI:

npm i -g mintlify

Then run it from the root of this repo, where docs.json lives:

mintlify dev

Publishing

The Mintlify GitHub App deploys the default branch to production automatically on push.

Troubleshooting

• mintlify dev isn't running — run mintlify install to reinstall dependencies.
• Page loads as a 404 — make sure you are running in the folder containing docs.json.