Mmcp.market

Aethyn Browser MCP server

by aethynio·io.github.aethynio/aethyn-browser-mcp·v0.1.1
No reviews yet

Local Playwright browser through residential proxies — agent picks country + sticky identity

C60/100grade C
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
C60/100

full report

Adoption
Growing

3 stars46 downloads/wk

Reviews

Write one

Nobody has reviewed Aethyn Browser yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Aethyn Browser tools (10)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • aethyn_check_exit_ip

    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.

  • aethyn_click

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

  • aethyn_close

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

  • aethyn_get_content

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

  • aethyn_launch_browser

    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.

  • aethyn_list_countries

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

  • aethyn_navigate

    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.

  • aethyn_new_identity

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

  • aethyn_snapshot

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

  • aethyn_type

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

Public scan report

scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it

2 medium
  • Code scan9 source files scanned15/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 76 days ago12/15
  • Maintainer identityregistry namespace matches repository owner6/10

Findings (2)

  • mediumnpm install lifecycle script presentinstall.script
  • mediumnpm install lifecycle script presentinstall.script
    package.json: … "start": "node dist/index.js", "postinstall": "node scripts/install-browser.mjs", …
Overall 60/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

What the publisher says

From the Aethyn Browser repository's README, as published. We do not edit it. Read it on GitHub

Aethyn Browser MCP — residential-proxy browser control for AI agents (pick the country, one identity per task)

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.

The only browser MCP where the agent picks the country and holds one identity per task.

Why this exists

  • Playwright MCP drives a browser well, but its proxy is set once at server startup — one static exit for the whole session. The agent can't ask for a Japanese exit for one task and a German exit for the next.
  • Hosted "web scraping" MCPs hide the proxy and hand back JSON — no runtime control over geo or session identity, and it's their pool at their price.

This server gives the agent runtime, per-task, steerable geo + sticky identity as tools — exactly what browser agents need to pull country-specific data (pricing, SERPs, catalogs, availability) and feed it into a chart or pipeline.

Quickstart

Add the server to your MCP client — Claude Desktop (claudedesktopconfig.json) or Cursor (~/.cursor/mcp.json):

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

Chromium is downloaded automatically on first install (~170 MB, one-time). If your environment blocks post-install scripts, run it yourself: npx playwright install chromium.

⚠️ Set the tier to match your plan. AETHYNDEFAULTTIER defaults to premium (port 2099). If your account is Elite, set it to elite (port 5499) — otherwise traffic hits the Premium port and the proxy returns 407 (auth rejected), even though the browser launched fine. The agent can also override per task with tier: "elite".

That's it. Ask your agent something like "Launch a browser in Japan, open example.co.jp, verify the exit IP is Japanese, and give me the page as markdown."

Tools

How it's different

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Install directly

Runs npx -y aethyn-browser-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add aethyn-browser-mcp -- npx -y aethyn-browser-mcp
Add to Cursor

Aethyn Browser: common questions

Is Aethyn Browser MCP server safe?
With care: it is graded C, so read the findings first (60/100). Read the Aethyn Browser safety report
How do I install Aethyn Browser?
It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
Does Aethyn Browser need an API key?
Yes. The registry entry asks for AETHYN_PASSWORD.
Is Aethyn Browser maintained?
The last commit was 77 days ago (2026-07-11). The latest release is v0.1.1.
What can I use instead of Aethyn Browser?
Servers from other publishers that do the same job: invisible_playwright_mcp MCP server, CloakBrowser MCP server and MCP server. Compare all Aethyn Browser alternatives.

Alternatives to Aethyn Browser

Same job from other publishers: the closest match first, then the best rated.

All Aethyn Browser alternatives →
  • invisible_playwright_mcp
    AI browser agent: browses, clicks, types, and reads real web pages from plain-English instructions.
    More from feder-cr →
    A
  • CloakBrowser MCP
    Playwright MCP-compatible browser automation bridge for CloakBrowser Chromium.
    B
  • MCP
    Reliable web access for AI agents: smart HTTP, rotating proxies, and full-browser rendering.
    B
  • SMS
    Real SIM numbers for AI agents: SMS verification, rentals, proxies, cloud browser, x402 deposits.
    A
  • Vibe Test — Browser Testing Agent
    Code-aware browser testing agent — 14 Playwright tools for AI code editors via MCP
    B
Aethyn Browser vs invisible_playwright_mcpAethyn Browser vs CloakBrowser MCPAethyn Browser vs MCP

More from aethynio →