Aethyn Browser

@aethynio

About Aethyn Browser

Browser MCP to use custom proxies for scraping by AI Agents

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 a local Chromium routed through a residential proxy exit in a chosen country (and city/state on the Elite tier). Returns a session_id the other aethyn_* tools use. Each session is one sticky identity — a pinned exit IP for the whole task.

Navigate the session's browser to a URL and wait for load. Returns the HTTP status, final URL, and page title — read the page with aethyn_get_content to judge the response yourself. Public data only — respect robots.txt, rate limits, and each site's terms.

Return the current page's content cleaned for reading (markdown by default). Use after navigating to extract data.

Return a structured accessibility snapshot (roles, names, and [ref=..] handles) of the page. Pass those refs to aethyn_click / aethyn_type. No screenshots needed.

Click an element. Prefer a 'ref' from aethyn_snapshot (e.g. 'e12'); or pass a 'selector' (CSS, or Playwright role=/text= engine).

Type text into an input. Prefer a 'ref' from aethyn_snapshot; or a 'selector'. Set submit:true to press Enter after.

Fetch IP info THROUGH the session's proxy so you can verify the exit country/city actually landed before trusting the page. Returns ip, country, city, org/ASN, and a best-effort is_residential flag.

Rotate the session to a fresh residential exit (new IP, same country) and clear cookies. Use between independent tasks or after a soft-block.

Close the session's browser context and free memory. Call this when a task is done.

List available exit countries (and Elite-tier cities where known). Discover geo options at runtime before launching.

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

Use cases of Aethyn Browser

Connect an MCP-compatible client to this repository's service.
Review the README-backed setup before enabling it in production.

FAQ from Aethyn Browser

Where is the source code for Aethyn Browser?

The source code is linked from the repository URL on this page.

Does Aethyn Browser include a standard MCP config?

If the README contains a parseable MCP configuration block, it is shown in the Config tab.

Frequently asked questions

Where is the source code for Aethyn Browser?

The source code is linked from the repository URL on this page.

Does Aethyn Browser include a standard MCP config?

If the README contains a parseable MCP configuration block, it is shown in the Config tab.

Comments

Basic information

More Browser Automation MCP servers

Fetch

modelcontextprotocol

Model Context Protocol Servers

88.1K

Parse

Parse.bot

Parse allows your agent to access thousands of APIs instantly. You can use Parse to build an API for any action on any website and edit any previously existing API in our catalogue.