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. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| 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
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- 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