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
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Tools
Related MCP Servers
- Alicense-qualityCmaintenanceEnables 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.61MIT
- Alicense-qualityDmaintenanceEnables AI agents to see, analyze, and visually verify web page changes through pixel-perfect diffing, theme extraction, layout analysis, and interactive element detection.2MIT
- Alicense-qualityDmaintenanceEnables AI coding agents to visually interact with frontend apps by taking screenshots, clicking elements, reading console logs, and performing visual diffs.3MIT
- Alicense-qualityDmaintenanceEnables 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.21MIT
Related MCP Connectors
AI-powered browser automation ā navigate, click, fill forms, and extract data from any website.
Reliable web access for AI agents: smart HTTP, rotating proxies, and full-browser rendering.
E2LLM gives your AI eyes and hands in a real browser: structured perception (SiFR) plus action.
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