An MCP server that lets an AI agent drive a real browser through residential proxies, choosing the exit country / city, tier, and a sticky per-task session — at call time. The browser (Playwright…
Aethyn Browser is an MCP project maintained in the aethynio/aethyn-browser-mcp repository. The maintainer describes its purpose as “An MCP server that lets an AI agent drive a real browser through residential proxies, choosing the exit country / city, tier, and a sticky…”. Read the project documentation for the complete scope.
The documented npm package is aethyn-browser-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.
The example declares AETHYN_USERNAME, AETHYN_PASSWORD, AETHYN_DEFAULT_TIER. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.
Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| aethyn_launch_browser | Launch local Chromium through a residential exit in a chosen country (+ city/state on Elite), tier, and sticky session. Returns a session_id. |
| aethyn_navigate | Go to a URL; waits for load and returns the HTTP status, final URL, and title. |
| aethyn_get_content | Return the page cleaned for reading (markdown / text / html). |
| aethyn_snapshot | Accessibility snapshot (roles, names, [ref=..] handles) — how the agent decides what to click. |
| aethyn_click | Click by ref (from the snapshot) or a CSS/role/text selector. |
| aethyn_type | Type into an input (optionally submit with Enter). |
| aethyn_check_exit_ip | Fetch IP info through the session's proxy to verify the geo actually landed. |
| aethyn_new_identity | Rotate to a fresh exit IP (same country) and clear cookies. |
| aethyn_close | Close the session's context and free memory. |
| aethyn_list_countries | Discover available countries (and Elite cities) at runtime. |
{
"mcpServers": {
"aethyn-browser": {
"command": "npx",
"args": [
"-y",
"aethyn-browser-mcp"
],
"env": {
"AETHYN_USERNAME": "aethyn-XXXXX",
"AETHYN_PASSWORD": "YOUR_AETHYN_PASSWORD",
"AETHYN_DEFAULT_TIER": "premium"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| AETHYN_USERNAME | Declared in the maintainer’s client configuration. | Check documentation |
| AETHYN_PASSWORD | Declared in the maintainer’s client configuration. | Check documentation |
| AETHYN_DEFAULT_TIER | Declared in the maintainer’s client configuration. | Check documentation |
Use Microsoft’s Playwright MCP server to navigate pages, inspect accessibility snapshots, fill forms and capture browser screenshots.
The original Chromium automation reference server — simple, screenshot-driven browser control.
MCP server for web scraping and converting web pages to Markdown with Playwright support
Playwright & Appium test automation for Claude. Generate tests, diagnose failures, open fix PRs.
For AI-assisted forensic analysis, include [`CLAUDE.md`](CLAUDE.md) in your case directory. It provides:
Hand browser work off to a server-side agent: read the page as a table, act, then verify.