Roxybrowser MCP
MCP server for roxybrowser
What is Roxybrowser MCP?
Roxybrowser MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for roxybrowser
MCP server for roxybrowser
This server falls under the Browser Automation and Cloud Services categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP server for roxybrowser
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx roxybrowserConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Roxybrowser MCP
The RoxyBrowser MCP Server exposes a managed cloud browser service to AI assistants via the Model Context Protocol. It lets agents create, open, close, and delete browser instances, retrieve Chrome DevTools Protocol (CDP) WebSocket endpoints for those instances, and run health checks — all without managing local browser infrastructure. Once a CDP endpoint is obtained, it can be handed off to Playwright or Puppeteer for fine-grained automation. It is designed for teams building AI automation pipelines that need reliable, scalable browser access without self-hosting Chromium.
Prerequisites
- A RoxyBrowser account and API key (ROXY_API_KEY)
- RoxyBrowser service running and accessible (default: http://127.0.0.1:50000, or a cloud endpoint)
- Node.js 18 or later and npm/npx (for running the MCP server)
- An MCP client such as Claude Desktop
Obtain a RoxyBrowser API key
Sign up at RoxyBrowser and create an API key from your dashboard. You will also need the API host URL if using a cloud deployment.
Install or run the MCP server via npx
The server is published to npm as @roxybrowser/openapi. You can run it without a global install using npx.
npx @roxybrowser/openapi@latestAdd the server to Claude Desktop
Edit claude_desktop_config.json and add the mcpServers block shown below, filling in your ROXY_API_KEY and ROXY_API_HOST.
Restart Claude Desktop
Quit and reopen Claude Desktop to load the new server configuration.
Verify the server is healthy
Ask Claude to run the health check tool to confirm the MCP server can reach the RoxyBrowser service.
Roxybrowser MCP Examples
Client configuration
Add to claude_desktop_config.json. ROXY_API_KEY is required. ROXY_API_HOST defaults to http://127.0.0.1:50000 if not set.
{
"mcpServers": {
"roxybrowser-openapi": {
"command": "npx",
"args": ["@roxybrowser/openapi@latest"],
"env": {
"ROXY_API_KEY": "YOUR_ROXY_API_KEY",
"ROXY_API_HOST": "http://127.0.0.1:50000",
"ROXY_TIMEOUT": "30000"
}
}
}
}Prompts to try
Commands that exercise browser lifecycle management and CDP integration.
- "Run a RoxyBrowser health check and tell me the status"
- "Create a new browser instance and give me its CDP WebSocket endpoint"
- "List all open browser instances in my workspace"
- "Close all browser instances that have been idle for more than 10 minutes"
- "Create a browser, get its CDP endpoint, and use it to navigate to https://example.com"Troubleshooting Roxybrowser MCP
Connection refused when contacting ROXY_API_HOST
If using the default local endpoint, ensure the RoxyBrowser service is running on port 50000. If using a cloud endpoint, verify the URL and that your network allows the connection. Run the roxy_health_check tool first to diagnose connectivity.
API key rejected (401 Unauthorized)
Confirm ROXY_API_KEY in the env block matches the key shown in your RoxyBrowser dashboard exactly. Keys are case-sensitive and may expire — regenerate if necessary.
Browser instance created but CDP WebSocket endpoint is unreachable
Use roxy_open_browsers to retrieve the current CDP endpoint — it may change between sessions. Ensure the port the browser binds to is not blocked by a local firewall. Set ROXY_TIMEOUT to a higher value (e.g. 60000) for slow-starting instances.
Frequently Asked Questions about Roxybrowser MCP
What is Roxybrowser MCP?
Roxybrowser MCP is a Model Context Protocol (MCP) server that mcp server for roxybrowser It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Roxybrowser MCP?
Follow the installation instructions on the Roxybrowser MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Roxybrowser MCP?
Roxybrowser MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Roxybrowser MCP free to use?
Yes, Roxybrowser MCP is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Roxybrowser MCP Alternatives — Similar Browser Automation Servers
Looking for alternatives to Roxybrowser MCP? 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 Roxybrowser MCP 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 Roxybrowser MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.