Aethyn Browser

Name: Aethyn Browser
Author: aethynio

@aethynio

Repository Homepage

About Aethyn Browser

Browser MCP to use custom proxies for scraping by AI Agents

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "aethyn-browser": {
      "command": "npx",
      "args": [
        "-y",
        "aethyn-browser-mcp"
      ],
      "env": {
        "AETHYN_USERNAME": "aethyn-XXXXX",
        "AETHYN_PASSWORD": "your-proxy-password",
        "AETHYN_DEFAULT_TIER": "premium"
      }
    }
  }
}

Tools

Launch local Chromium through a residential exit in a chosen `country` (+ `city`/`state` on Elite), `tier`, and sticky `session`. Returns a `session_id`.

Go to a URL; waits for load and returns the HTTP status, final URL, and title.

Return the page cleaned for reading (`markdown` / `text` / `html`).

Accessibility snapshot (roles, names, `[ref=..]` handles) — how the agent decides what to click.

Click by `ref` (from the snapshot) or a CSS/role/text `selector`.

Type into an input (optionally submit with Enter).

Fetch IP info **through the session's proxy** to verify the geo actually landed.

Rotate to a fresh exit IP (same country) and clear cookies.

Close the session's context and free memory.

Discover available countries (and Elite cities) at runtime.

Overview

What is Aethyn Browser?

Browser MCP to use custom proxies for scraping by AI Agents

How to use Aethyn Browser?

The README includes setup instructions such as "command": "npx",.

Key features of Aethyn Browser

Respect robots.txt, rate limits, and each site's terms and the law. Can reach ≠ should.
Pace yourself. A residential IP firing dozens of requests per second is still obviously a bot
Your credentials stay in your MCP config on your machine; the proxy password is never logged