Documentation Index
Fetch the complete documentation index at: https://docs.rustybrowser.com/llms.txt
Use this file to discover all available pages before exploring further.
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.
create_browser
Spawn a new browser instance. Returns the browser ID.
navigate
Navigate a browser to a URL.
| Parameter | Type | Required | Description |
|---|
id | string | Yes | Browser ID |
url | string | Yes | URL to navigate to |
click
Click an element on the current page.
| Parameter | Type | Required | Description |
|---|
id | string | Yes | Browser ID |
selector | string | Yes | CSS selector of element to click |
type
Type text into a field.
| Parameter | Type | Required | Description |
|---|
id | string | Yes | Browser ID |
text | string | Yes | Text to type |
selector | string | No | Target input selector |
screenshot
Capture a screenshot of the current page.
| Parameter | Type | Required | Description |
|---|
id | string | Yes | Browser ID |
fetch_text
Fetch visible text content of the current page.
| Parameter | Type | Required | Description |
|---|
id | string | Yes | Browser ID |
instruct
Issue a natural language instruction to the browser.
| Parameter | Type | Required | Description |
|---|
id | string | Yes | Browser ID |
instruction | string | Yes | Natural language instruction |
delete_browser
Close a browser and stop billing.
| Parameter | Type | Required | Description |
|---|
id | string | Yes | Browser 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
| Variable | Default | Description |
|---|
RUSTY_BROWSER_API_URL | http://localhost:5201 | Rusty Browser API base URL |
RUSTY_BROWSER_SSE_ADDR | :2425 | SSE 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.
