Browser Agent
A Model Context Protocol (MCP) integration that provides Claude Desktop with autonomous browser automation capabilities. This agent enables Claude to interact with web content, manipulate DOM elements, execute JavaScript, and perform API requests.
What is Browser Agent?
Browser Agent is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol (mcp) integration that provides claude desktop with autonomous browser automation capabilities. this agent enables claude to interact with web content, manipulate dom elements, ...
A Model Context Protocol (MCP) integration that provides Claude Desktop with autonomous browser automation capabilities. This agent enables Claude to interact with web content, manipulate DOM elements, execute JavaScript, and perform API requests.
This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Model Context Protocol (MCP) integration that provides Cla
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx browser-agent-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Browser Agent
Browser Agent MCP provides Claude Desktop with autonomous browser automation by exposing a set of Playwright-powered tools through the Model Context Protocol. It supports navigating URLs, clicking elements, filling forms, selecting options, hovering, taking screenshots, executing arbitrary JavaScript in the browser context, and making direct API requests (GET, POST, PUT, PATCH, DELETE). This gives Claude the ability to interact with live web applications as if it were a human user, making it suitable for automated testing, data collection, and web-based task automation.
Prerequisites
- Node.js 18+ and npm installed
- Claude Desktop as the MCP client
- A Chromium-compatible browser installed (Chrome is the default; Firefox, WebKit, and Edge are also supported)
- No external API keys required
Clone the repository
Clone the mcp-browser-agent repository to a directory where it will be run from.
git clone https://github.com/imprvhub/mcp-browser-agent
cd mcp-browser-agentInstall dependencies
Install all Node.js dependencies including Playwright and the MCP SDK.
npm installBuild the project
Compile the TypeScript source to JavaScript in the dist/ directory.
npm run buildConfigure Claude Desktop
Add the browser agent to your Claude Desktop configuration. Optionally specify a browser type via the --browser argument. The config file location depends on your OS.
Restart Claude Desktop
Save the configuration file and restart Claude Desktop to load the browser agent MCP server.
Browser Agent Examples
Client configuration
Claude Desktop configuration for the browser agent using Chrome (default). Replace the path with your actual clone location.
{
"mcpServers": {
"browser-agent": {
"command": "node",
"args": ["/absolute/path/to/mcp-browser-agent/dist/index.js", "--browser", "chrome"]
}
}
}Prompts to try
Example prompts that trigger browser automation via the MCP tools.
- "Go to https://news.ycombinator.com and take a screenshot"
- "Navigate to https://jsonplaceholder.typicode.com and perform a GET request to /todos/1"
- "Fill in the username and password fields at https://the-internet.herokuapp.com/login"
- "Go to Google, search for 'MCP protocol', and take a screenshot of the results"
- "Execute JavaScript on https://example.com to count all links on the page"Troubleshooting Browser Agent
Browser fails to launch with executable not found error
Run npx playwright install chromium to install the Playwright browser binaries. If using Firefox or WebKit, run npx playwright install firefox or npx playwright install webkit respectively.
MCP server not found in Claude Desktop
Verify the absolute path to dist/index.js is correct in your claude_desktop_config.json. Run node /path/to/dist/index.js manually to confirm the server starts without errors before adding it to the config.
Browser type not changing despite config update
The browser type can be set via: (1) --browser flag in args, (2) MCP_BROWSER_TYPE environment variable, or (3) a .mcp_browser_agent_config.json file in your home directory with a browserType key. Check all three locations for conflicting values.
Frequently Asked Questions about Browser Agent
What is Browser Agent?
Browser Agent is a Model Context Protocol (MCP) server that model context protocol (mcp) integration that provides claude desktop with autonomous browser automation capabilities. this agent enables claude to interact with web content, manipulate dom elements, execute javascript, and perform api requests. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Browser Agent?
Follow the installation instructions on the Browser Agent GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Browser Agent?
Browser Agent works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Browser Agent free to use?
Yes, Browser Agent is open source and available under the Mozilla Public License 2.0 license. You can use it freely in both personal and commercial projects.
Browser Agent Alternatives — Similar Browser Automation Servers
Looking for alternatives to Browser Agent? Here are other popular browser automation servers you can use with Claude, Cursor, and VS Code.
Chrome DevTools MCP
★ 40.6kAI-powered Chrome automation server with natural language element detection. Control Chrome browser through MCP protocol for testing, debugging, and performance analysis. Features 91% accuracy in element location, works with free AI models, and suppo
UI TARS Desktop
★ 34.9k📇 🏠 - Browser automation capabilities using Puppeteer, both support local and remote browser connection.
Playwright
★ 32.8kA production-ready browser automation server that enables AI assistants to interact with web pages using tools for navigation, element interaction, and data extraction. It features a built-in Inspector UI and robust crash recovery for reliable automa
Page Agent
★ 18.0kJavaScript in-page GUI agent. Control web interfaces with natural language.
Chrome
★ 11.7kAn extension-based MCP server that enables AI assistants to control your browser, leveraging existing sessions and login states for automation and content analysis. It provides over 20 tools for semantic tab search, interactive element manipulation,
LAMDA
★ 7.8kThe most powerful Android RPA agent framework, next generation mobile automation.
Browse More Browser Automation MCP Servers
Explore all browser automation servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Browser Agent in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Browser Agent?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.