Rod Browser Automation

v1.0.0Browser Automationstable

Rod-MCP provides browser automation capabilities for your applications by using Rod. The server provides many useful mcp tools enable LLMs to interact with the web pages, like click, take screenshot, save page as pdf etc.

browser-automationgo-rodgolangllmllvm
Share:
32
Stars
0
Downloads
0
Weekly
0/5

What is Rod Browser Automation?

Rod Browser Automation is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to rod-mcp provides browser automation capabilities for your applications by using rod. the server provides many useful mcp tools enable llms to interact with the web pages, like click, take screenshot, ...

Rod-MCP provides browser automation capabilities for your applications by using Rod. The server provides many useful mcp tools enable LLMs to interact with the web pages, like click, take screenshot, save page as pdf etc.

This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Rod-MCP provides browser automation capabilities for your ap

Use Cases

Automate web interactions
Take screenshots
Save pages as PDF
go-rod

Maintainer

LicenseMIT
Languagejavascript
Versionv1.0.0
UpdatedApr 26, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx rod

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Rod Browser Automation

Rod-MCP is a browser automation MCP server powered by the Go Rod library, giving AI assistants the ability to control a real Chromium browser — clicking elements, taking screenshots, saving pages as PDF, navigating URLs, and interacting with web page content. Written in Go and using Chrome DevTools Protocol under the hood, it supports both headless and headed (visible) browser modes, proxy configuration, and a customizable YAML config file. Developers and testers use it to automate web tasks, capture visual snapshots, and drive browser-based workflows from natural language.

Prerequisites

  • Go 1.23 or later installed (for building from source)
  • Google Chrome or Chromium browser installed on the system
  • An MCP-compatible client such as Claude Desktop, Cursor, or VS Code with MCP support
  • Basic familiarity with YAML for configuring the rod-mcp.yaml config file
1

Clone and build the rod-mcp binary

Clone the repository, install Go dependencies, and build the rod-mcp binary.

git clone https://github.com/go-rod/rod-mcp.git
cd rod-mcp
go mod tidy
go build -o rod-mcp .
2

Create a configuration file

Create a rod-mcp.yaml file in the same directory to configure the browser path, headless mode, and other options.

# rod-mcp.yaml
serverName: "Rod Server"
browserBinPath: ""       # leave empty to auto-detect Chrome/Chromium
headless: true           # set to false to see the browser UI
browserTempDir: "./rod/browser"
noSandbox: false
proxy: ""                # optional: socks5://user:pass@host:port
3

Move the binary to your PATH

Move or symlink the built rod-mcp binary to a directory on your PATH so your MCP client can execute it.

sudo mv rod-mcp /usr/local/bin/rod-mcp
4

Configure your MCP client

Add rod-mcp to your MCP client configuration. For Claude Desktop on macOS, edit ~/Library/Application Support/Claude/claude_desktop_config.json.

{
  "mcpServers": {
    "rod-mcp": {
      "command": "rod-mcp",
      "args": ["-c", "/path/to/rod-mcp.yaml"]
    }
  }
}
5

Restart your MCP client and test

Restart Claude Desktop or your chosen client. Ask the assistant to navigate to a URL or take a screenshot to confirm the browser automation server is working.

Rod Browser Automation Examples

Client configuration

Claude Desktop configuration for the Rod MCP server pointing to a local YAML config.

{
  "mcpServers": {
    "rod-mcp": {
      "command": "rod-mcp",
      "args": ["-c", "/Users/yourname/rod-mcp/rod-mcp.yaml"]
    }
  }
}

Prompts to try

Example prompts for browser automation tasks using the Rod MCP server.

- "Navigate to https://example.com and take a screenshot"
- "Go to https://news.ycombinator.com, click the first story link, and return the page title"
- "Save https://golang.org/doc as a PDF file"
- "Navigate to a login page, fill in the username and password fields, and click the Sign In button"
- "Take a screenshot of https://github.com/go-rod/rod and describe what you see"

Troubleshooting Rod Browser Automation

rod-mcp fails to launch with 'Chrome not found'

Set the browserBinPath in rod-mcp.yaml to the full path of your Chrome or Chromium binary (e.g., /usr/bin/google-chrome on Linux or /Applications/Google Chrome.app/Contents/MacOS/Google Chrome on macOS).

Browser crashes immediately in headless mode on Linux

Set noSandbox: true in rod-mcp.yaml when running in Docker containers or environments without kernel sandbox support. On bare-metal Linux, ensure Chrome's sandbox dependencies are installed.

Screenshots are blank or pages do not fully load

Switch headless to false temporarily to watch what the browser does. If the page loads slowly, the automation may be acting before content is rendered — check the rod-mcp repository for wait/sleep options or CSS selector readiness checks.

Frequently Asked Questions about Rod Browser Automation

What is Rod Browser Automation?

Rod Browser Automation is a Model Context Protocol (MCP) server that rod-mcp provides browser automation capabilities for your applications by using rod. the server provides many useful mcp tools enable llms to interact with the web pages, like click, take screenshot, save page as pdf etc. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Rod Browser Automation?

Follow the installation instructions on the Rod Browser Automation GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Rod Browser Automation?

Rod Browser Automation works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Rod Browser Automation free to use?

Yes, Rod Browser Automation is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

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.

Quick Config Preview

{ "mcpServers": { "rod": { "command": "npx", "args": ["-y", "rod"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Rod Browser Automation?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides