browser-mcp (via mcp2cli)
Automate browser interactions via CLI.
Shortcuts
mcp2cli browser <cmd>(alias formcp2cli browser-mcp)
Commands
Navigate
| Command | Description | Example | Ref |
|---|---|---|---|
mcp2cli browser navigate go |
Navigate to a URL | mcp2cli browser navigate go --url https://example.com |
ref |
mcp2cli browser navigate back |
Go back to the previous page | mcp2cli browser navigate back |
ref |
mcp2cli browser navigate forward |
Go forward to the next page | mcp2cli browser navigate forward |
ref |
Interact
| Command | Description | Example | Ref |
|---|---|---|---|
mcp2cli browser interact click |
Click on a web page element | mcp2cli browser interact click --element "Submit button" --ref e123 |
ref |
mcp2cli browser interact type |
Type text into an editable element | mcp2cli browser interact type --element "Search box" --ref e456 --text "hello" --submit true |
ref |
mcp2cli browser interact select-option |
Select an option in a dropdown | mcp2cli browser interact select-option --element "Country" --ref e789 --values '["US"]' |
ref |
mcp2cli browser interact hover |
Hover over a page element | mcp2cli browser interact hover --element "Menu" --ref e101 |
ref |
mcp2cli browser interact press-key |
Press a key on the keyboard | mcp2cli browser interact press-key --key "Enter" |
ref |
Page
| Command | Description | Example | Ref |
|---|---|---|---|
mcp2cli browser page snapshot |
Capture accessibility snapshot of the current page | mcp2cli browser page snapshot |
ref |
mcp2cli browser page screenshot |
Take a screenshot of the current page | mcp2cli browser page screenshot |
ref |
mcp2cli browser page console-logs |
Get console logs from the browser | mcp2cli browser page console-logs |
ref |
mcp2cli browser page wait |
Wait for a specified time in seconds | mcp2cli browser page wait --time 2 |
ref |
Discover Parameters
Append --help to any command for full parameter list:
mcp2cli browser interact click --help
Note: Use Ref links in the Commands table above to view detailed parameter reference and more examples.
User Notes
MUST READ users/skill.md for custom workflows and tips. Config: MCP server settings live in
~/.agents/mcp2cli/servers.yaml- edit there to take effect.