Skip to main content
Glama
aethynio

aethyn-browser-mcp

Official

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PROXY_HOSTNoCustom proxy host (overrides Aethyn default).
PROXY_PORTNoCustom proxy port.
PROXY_PASSWORDNoCustom proxy password.
PROXY_USERNAMENoCustom proxy username.
AETHYN_HEADLESSNoSet to 'false' to watch the browser.true
AETHYN_PASSWORDNoYour Aethyn proxy password (default provider).
AETHYN_USERNAMENoYour Aethyn proxy username (default provider).
AETHYN_IPINFO_URLNoEndpoint used by check_exit_ip tool.https://ipinfo.io/json
AETHYN_DEFAULT_TIERNoDefault tier: 'premium' (port 2099) or 'elite' (port 5499).premium
AETHYN_MAX_SESSIONSNoMaximum number of concurrent sessions; oldest evicted.8
AETHYN_IDLE_TIMEOUT_MINNoIdle sessions auto-close after this many minutes.10
PROXY_USERNAME_TEMPLATENoTemplate for proxy username with placeholders like {country}, {session}, etc.

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
aethyn_launch_browserA

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_navigateA

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_get_contentB

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

aethyn_snapshotB

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_clickA

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

aethyn_typeA

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

aethyn_check_exit_ipA

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_new_identityA

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_closeA

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

aethyn_list_countriesA

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

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/aethynio/aethyn-browser-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server