atlas-browser-mcp
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@atlas-browser-mcpGo to news.ycombinator.com and tell me the top 3 headlines"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
š atlas-browser-mcp
Visual web browsing for AI agents via Model Context Protocol (MCP).
⨠Features
šø Visual-First: Navigate the web through screenshots, not DOM parsing
š·ļø Set-of-Mark: Interactive elements labeled with clickable
[0],[1],[2]... markersš Humanized: Bezier curve mouse movements, natural typing rhythms
š§© CAPTCHA-Ready: Multi-click support for image selection challenges
š”ļø Anti-Detection: Built-in measures to avoid bot detection
Related MCP server: websight
š Quick Start
Installation
pip install atlas-browser-mcp
playwright install chromiumUse with Claude Desktop
Add to your Claude Desktop config (claude_desktop_config.json):
{
"mcpServers": {
"browser": {
"command": "atlas-browser-mcp"
}
}
}Then ask Claude:
"Navigate to https://news.ycombinator.com and tell me the top 3 stories"
š ļø Available Tools
Tool | Description |
| Go to URL, returns labeled screenshot |
| Capture current page with labels |
| Click element by label ID |
| Click multiple elements (for CAPTCHA) |
| Type text, optionally press Enter |
| Scroll page up or down |
š Usage Examples
Basic Navigation
User: Go to google.com
AI: [calls navigate(url="https://google.com")]
AI: I see the Google homepage. The search box is labeled [3].
User: Search for "MCP protocol"
AI: [calls click(label_id=3)]
AI: [calls type(text="MCP protocol", submit=true)]
AI: Here are the search results...CAPTCHA Handling
User: Select all images with traffic lights
AI: [Looking at the CAPTCHA grid]
AI: I can see traffic lights in images [2], [5], and [8].
AI: [calls multi_click(label_ids=[2, 5, 8])]š§ Configuration
Headless Mode
For servers without display:
from atlas_browser_mcp.browser import VisualBrowser
browser = VisualBrowser(
headless=True, # No visible browser window
humanize=False # Faster, less human-like
)Custom Viewport
browser = VisualBrowser()
browser.VIEWPORT = {"width": 1920, "height": 1080}šļø How It Works
Navigate: Browser loads the page
Inject SoM: JavaScript labels all interactive elements
Screenshot: Capture the labeled page
AI Sees: The screenshot shows
[0],[1],[2]... on buttons, links, inputsAI Acts: "Click
[5]" ā Browser clicks the element at that positionRepeat: New screenshot with updated labels
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
ā [0] Logo [1] Search [2] Menu ā
ā ā
ā [3] Article Title ā
ā [4] Read More ā
ā ā
ā [5] Subscribe [6] Share ā
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāš¤ Integration
With Cline (VS Code)
{
"mcpServers": {
"browser": {
"command": "atlas-browser-mcp"
}
}
}Programmatic Use
from atlas_browser_mcp.browser import VisualBrowser
browser = VisualBrowser()
# Navigate
result = browser.execute("navigate", url="https://example.com")
print(f"Page title: {result.data['title']}")
print(f"Found {result.data['element_count']} interactive elements")
# Click element [0]
result = browser.execute("click", label_id=0)
# Type in focused field
result = browser.execute("type", text="Hello world", submit=True)
# Cleanup
browser.execute("close")š Requirements
Python 3.10+
Playwright with Chromium
š Troubleshooting
"Playwright not installed"
pip install playwright
playwright install chromium"Browser closed unexpectedly"
Try running with headless=False to see what's happening:
browser = VisualBrowser(headless=False)Elements not being detected
Some dynamic pages need more wait time. The browser waits 1.5s after navigation, but complex SPAs may need longer.
š License
MIT License - see LICENSE
š Credits
Built for Atlas, an autonomous AI agent.
Inspired by:
anthropic/mcp - Model Context Protocol
AskUI - Visual testing approach
Set-of-Mark prompting - Visual grounding technique
Available Tools
6 toolsclickC
Click on an element by its label ID (shown as [N] on the screenshot)
| Name | Required | Description | Default |
|---|---|---|---|
| label_id | Yes | The numeric label shown on the element (e.g., 5 for [5]) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It mentions the label ID format but doesn't disclose behavioral traits such as what happens if the element isn't found, whether it waits for the element to be clickable, or any side effects like page navigation. This leaves significant gaps for a mutation tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence that front-loads the core action and context. Every word earns its place, with no wasted information, making it highly concise and well-structured.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool that performs a click action (implied mutation) with no annotations and no output schema, the description is incomplete. It lacks details on error handling, success conditions, or what the tool returns, which are critical for an AI agent to use it effectively.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% description coverage, with the parameter 'label_id' well-documented in the schema. The description adds minimal value by referencing the screenshot context, but doesn't provide additional semantics beyond what the schema already states. Baseline 3 is appropriate given high schema coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('click on an element') and the target resource ('by its label ID'), with specific reference to how the label appears in screenshots. It doesn't explicitly differentiate from sibling tools like 'multi_click' or 'navigate', but the specificity of using label IDs makes the purpose clear.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives like 'multi_click' for multiple clicks or 'navigate' for navigation actions. The description implies usage with labeled elements from screenshots but doesn't specify exclusions or prerequisites.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
multi_clickB
Click multiple elements at once (useful for CAPTCHA, checkboxes, etc.)
| Name | Required | Description | Default |
|---|---|---|---|
| label_ids | Yes | List of label IDs to click (e.g., [1, 5, 8]) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It mentions the action ('click') and context ('CAPTCHA, checkboxes'), but doesn't disclose behavioral traits like whether it requires specific permissions, how it handles errors, if it's synchronous/asynchronous, or what the visual/state impact is. This leaves significant gaps for a mutation tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence that front-loads the core functionality ('Click multiple elements at once') and adds a brief, useful example context. There is no wasted verbiage, making it highly concise and well-structured.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given no annotations, no output schema, and a mutation tool with one parameter, the description is incomplete. It lacks details on behavioral aspects (e.g., side effects, error handling), return values, and explicit differentiation from siblings. For a tool that performs actions like clicking, this leaves too many unknowns for effective agent use.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema description coverage is 100%, with the parameter 'label_ids' fully documented in the schema. The description adds no additional parameter information beyond what the schema provides, such as format details or constraints. Baseline 3 is appropriate as the schema does the heavy lifting.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('click multiple elements at once') and the resource ('elements'), with a specific example use case ('CAPTCHA, checkboxes, etc.'). However, it doesn't explicitly differentiate from the sibling 'click' tool, which presumably clicks single elements.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for batch operations like CAPTCHA or checkboxes, suggesting when it might be preferred over single clicks. But it doesn't explicitly state when to use this versus the 'click' sibling or other alternatives, nor does it provide exclusions or prerequisites.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
screenshotB
Take a screenshot of the current page with labeled elements
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It states the tool takes a screenshot and labels elements, but doesn't explain what 'labeled elements' means, whether this requires specific permissions, how the output is formatted, or if there are any side effects like pausing the page. This leaves significant gaps for a tool that interacts with a page.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence that front-loads the core action ('Take a screenshot') and adds a key detail ('with labeled elements') without any wasted words. Every part of the sentence contributes directly to understanding the tool's purpose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity of interacting with a page (implied by sibling tools like 'click'), no annotations, and no output schema, the description is incomplete. It doesn't cover behavioral aspects like how labeling works, output format, or error conditions, which are crucial for a screenshot tool in this context.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 0 parameters with 100% coverage, so no parameters need documentation. The description adds value by specifying 'with labeled elements', which provides context beyond the empty schema, though it's minimal. Baseline for 0 parameters is 4, as the description compensates adequately.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('Take a screenshot') and the target ('current page'), with the additional detail 'with labeled elements' specifying what distinguishes this screenshot. However, it doesn't explicitly differentiate from potential sibling tools like 'click' or 'navigate' that might also involve page interaction, so it's not a perfect 5.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives like 'click' or 'navigate', nor does it mention prerequisites such as needing a page to be loaded first. It implies usage by describing the action but lacks explicit context or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
scrollC
Scroll the page up or down
| Name | Required | Description | Default |
|---|---|---|---|
| direction | No | Scroll direction (default: down) | down |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It mentions scrolling 'up or down' but doesn't describe how much scrolling occurs (e.g., by pixels, viewport height), whether it's smooth or instant, or any side effects (e.g., page reloads, element visibility changes). For a tool with zero annotation coverage, this leaves significant gaps in understanding its behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence with zero waste. It is appropriately sized for a simple tool and front-loaded with the core action. Every word earns its place, making it easy to parse quickly.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's simplicity (1 parameter, no output schema, no annotations), the description is incomplete. It lacks details on scrolling behavior (e.g., amount, smoothness), usage context, and how it integrates with sibling tools like 'navigate'. Without annotations or output schema, the description should provide more context to compensate, but it does not.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% coverage with a clear description and enum for the 'direction' parameter. The description adds no additional meaning beyond what the schema provides, as it only restates 'up or down' without explaining parameter implications (e.g., default behavior, effect on page position). With high schema coverage, the baseline score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states the action ('scroll') and target ('the page') but is vague about scope and mechanism. It doesn't specify whether this scrolls by a fixed amount, to a specific position, or continuously, nor does it distinguish from potential sibling actions like navigating to different pages. The purpose is understandable but lacks specificity.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives like 'navigate' or 'click'. The description implies usage for scrolling but doesn't specify contexts (e.g., after loading a page, to view content) or exclusions (e.g., not for horizontal scrolling). Without such details, the agent must infer usage from the tool name alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
typeA
Type text at the current focus position
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | Text to type | |
| submit | No | Press Enter after typing (default: false) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden for behavioral disclosure. While it mentions the typing action, it doesn't disclose important behavioral traits like whether this simulates keyboard events, what happens if no focus position exists, potential rate limits, or error conditions. The description provides only basic functional information without deeper behavioral context.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, perfectly front-loaded sentence that communicates the core functionality without any wasted words. Every word earns its place, making it maximally efficient while still being complete for its length.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a 2-parameter tool with no annotations and no output schema, the description provides adequate basic functionality but lacks completeness. It doesn't explain what happens after typing, potential side effects, error scenarios, or return values. While concise, it leaves important contextual gaps for a tool that interacts with UI focus states.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already fully documents both parameters. The description doesn't add any parameter semantics beyond what's in the schema - it mentions typing text but doesn't elaborate on the 'text' parameter or 'submit' behavior. Baseline 3 is appropriate when the schema does all the parameter documentation work.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the specific action ('Type text') and target ('at the current focus position'), distinguishing it from sibling tools like click or navigate. It uses a precise verb+resource construction that leaves no ambiguity about what the tool does.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage context ('at the current focus position') suggesting this tool should be used when there's already an active text input field, but it doesn't explicitly state when to use it versus alternatives or provide any exclusion criteria. No sibling tool comparisons or explicit guidance are provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.
6 tool updates
v0.1.0- First observed
click - First observed
multi_click - First observed
navigate - First observed
screenshot - First observed
scroll - First observed
type
TDQS
Each tool has a clearly distinct purpose with no overlap: click targets single elements, multi_click handles multiple elements, navigate loads pages, screenshot captures the current state, scroll moves the viewport, and type inputs text. The descriptions make it easy for an agent to choose the right tool for each interaction.
All tool names follow a consistent snake_case pattern with clear, imperative verbs (click, navigate, screenshot, scroll, type) and a descriptive multi_click variant. There are no deviations in style or convention, making the set predictable and readable.
With 6 tools, the server is well-scoped for browser automation, covering core interactions like navigation, clicking, typing, scrolling, and screenshot capture. Each tool earns its place without redundancy, fitting a typical range for this domain.
The toolset covers essential browser actions (navigation, interaction, viewing) effectively, with no obvious dead ends. A minor gap exists in more advanced interactions like hovering, drag-and-drop, or form submission, but agents can work around this using the provided tools for most common tasks.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
AI-powered web automation. Navigate websites using AI agents for one page or a thousand
AI-powered web automation. Navigate websites using AI agents for one page or a thousand
Stealth web automation for AI agents. Login, signup, navigate, screenshot.
Stealth web automation for AI agents. Login, signup, navigate, screenshot.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to interact with web browsers using natural language, featuring automated browsing, form filling, vision-based element detection, and structured JSON responses for systematic browser control.62MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to see, analyze, and visually verify web page changes through pixel-perfect diffing, theme extraction, layout analysis, and interactive element detection.5MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to fully control a browser for web automation, including navigation, clicking, typing, scrolling, screenshots, and DOM inspection, with session persistence and anti-bot bypass.14MIT
- AlicenseBqualityDmaintenanceEnables visual browser automation through natural language descriptions, allowing AI to click, type, and navigate web pages by seeing the page.18MIT
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/LingTravel/Atlas-Browser'
If you have feedback or need assistance with the MCP directory API, please join our Discord server