aethyn-browser-mcp
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PROXY_HOST | No | Custom proxy host (overrides Aethyn default). | |
| PROXY_PORT | No | Custom proxy port. | |
| PROXY_PASSWORD | No | Custom proxy password. | |
| PROXY_USERNAME | No | Custom proxy username. | |
| AETHYN_HEADLESS | No | Set to 'false' to watch the browser. | true |
| AETHYN_PASSWORD | No | Your Aethyn proxy password (default provider). | |
| AETHYN_USERNAME | No | Your Aethyn proxy username (default provider). | |
| AETHYN_IPINFO_URL | No | Endpoint used by check_exit_ip tool. | https://ipinfo.io/json |
| AETHYN_DEFAULT_TIER | No | Default tier: 'premium' (port 2099) or 'elite' (port 5499). | premium |
| AETHYN_MAX_SESSIONS | No | Maximum number of concurrent sessions; oldest evicted. | 8 |
| AETHYN_IDLE_TIMEOUT_MIN | No | Idle sessions auto-close after this many minutes. | 10 |
| PROXY_USERNAME_TEMPLATE | No | Template for proxy username with placeholders like {country}, {session}, etc. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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