Skip to main content

​
Overview

The Rusty Browser MCP Server is an open-source server that exposes browser control capabilities through the Model Context Protocol (MCP), enabling integration with Claude, Cursor, VS Code, and other MCP-compatible AI tools.

​
Tools Provided

​
create_browser

Spawn a new browser instance. Returns the browser ID. Navigate a browser to a URL.
ParameterTypeRequiredDescription
idstringYesBrowser ID
urlstringYesURL to navigate to

​
click

Click an element on the current page.
ParameterTypeRequiredDescription
idstringYesBrowser ID
selectorstringYesCSS selector of element to click

​
type

Type text into a field.
ParameterTypeRequiredDescription
idstringYesBrowser ID
textstringYesText to type
selectorstringNoTarget input selector

​
screenshot

Capture a screenshot of the current page.
ParameterTypeRequiredDescription
idstringYesBrowser ID

​
fetch_text

Fetch visible text content of the current page.
ParameterTypeRequiredDescription
idstringYesBrowser ID

​
instruct

Issue a natural language instruction to the browser.
ParameterTypeRequiredDescription
idstringYesBrowser ID
instructionstringYesNatural language instruction

​
delete_browser

Close a browser and stop billing.
ParameterTypeRequiredDescription
idstringYesBrowser ID to close

​
Setup

​
Docker

docker run -p 2425:2425 \
  -e RUSTY_BROWSER_API_URL=https://api.rustybrowser.com \
  rustybrowser/mcp-server

​
From Source

git clone https://github.com/wraithbytes/mcp-server.git
cd mcp-server
go run main.go

​
Environment Variables

VariableDefaultDescription
RUSTY_BROWSER_API_URLhttp://localhost:5201Rusty Browser API base URL
RUSTY_BROWSER_SSE_ADDR:2425SSE server listen address

​
Authentication

The MCP server authenticates using a Bearer token passed via the Authorization header on the SSE connection.

​
Claude Desktop Configuration

{
  "mcpServers": {
    "rustybrowser": {
      "url": "http://localhost:2425/sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

​
Transport

The server uses SSE (Server-Sent Events) transport on port 2425 by default.