Aethyn Browser MCP

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 Chromium) runs locally on your machine; you bring your own proxy credentials. Defaults to Aethyn residential proxies, and works with any HTTP proxy you configure. Its README documents 10 tools, including aethyn_launch_browser, aethyn_navigate, aethyn_get_content.

People who work with browser automation, playwright and proxy and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-07-11 · ★ 3 · #176 OF 255 MAINTAINED BROWSER AUTOMATION · VERIFIED 2026-09-18

MIT · TypeScript servers · how we verify → /methodology

01 · Install Aethyn Browser MCP

before you install - you'll need

Set PROXY_HOST, PROXY_PORT before connecting. AETHYN_USERNAME, AETHYN_PASSWORD, AETHYN_DEFAULT_TIER, PROXY_USERNAME, PROXY_PASSWORD, PROXY_USERNAME_TEMPLATE are optional or environment-specific per the README.

Claude Code

claude mcp add aethynio-aethyn-browser-mcp -- npx -y aethyn-browser-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "aethynio-aethyn-browser-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "aethyn-browser-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package aethyn-browser-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.aethynio is GitHub-verified and matches the repo owner

03 · What Aethyn Browser MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can read the page cleaned for reading (markdown / text / html), click by ref (from the snapshot) or a CSS/role/text selector, close the session's context and free memory, and discover available countries (and Elite cities) at runtime.

The 10 tools it gives your agent

Extracted from the project's README - what aethyn-browser-mcp lets an agent do.

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.

04 · Who maintains Aethyn Browser MCP

aethyn-browser-mcp is maintained by aethynio. It's the only MCP server we track from this author; the repo dates to Jul 2026.

05 · Facts

repository: github.com/aethynio/aethyn-browser-mcp
website: https://www.aethyn.io/
category: browser automation - ranked #176 of 255 actively-maintained browser automation servers as of 2026-09-18.
registry: io.github.aethynio/aethyn-browser-mcp (active, first published 2026-07-11)
packages: npm:aethyn-browser-mcp

06 · Aethyn Browser MCP FAQ

Is Aethyn Browser MCP still maintained?

Yes - as of 2026-09-18, its last commit was 2026-07-11. We re-verify nightly.

What can Aethyn Browser MCP do?

How do I install Aethyn Browser MCP?

Run `npx -y aethyn-browser-mcp`. The README documents 8 environment variables (AETHYN_USERNAME, AETHYN_PASSWORD, AETHYN_DEFAULT_TIER…) to set first. Set PROXY_HOST, PROXY_PORT before connecting. AETHYN_USERNAME, AETHYN_PASSWORD, AETHYN_DEFAULT_TIER, PROXY_USERNAME, PROXY_PASSWORD, PROXY_USERNAME_TEMPLATE are optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Aethyn Browser MCP run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Aethyn Browser MCP

Alternatives to Aethyn Browser MCP

Maintained browser automation servers if Aethyn Browser MCP isn't the fit.

Pairs well with

Servers that cover what Aethyn Browser MCP doesn't - only shown when the pairing reason fits the companion.

More browser automation MCP servers · Agent360 Browser MCP · Google Play Console MCP · Vibe Test - Browser Testing Agent · Android Security Analyzer · Clickcast

More TypeScript MCP servers · Openaffiliate MCP · Aganium MCP Server · Aiseo Audit · Fathom MCP Server · Agent Blueprint · see all