MCP server that exposes Abrasio as an agentic browser for AI models.
Allows Claude, Cursor, and any MCP-compatible AI to control a real web browser with full anti-detection fingerprinting — the same stealth infrastructure used for web scraping, now driven by AI.
MCP server that exposes **Abrasio** as an agentic browser for AI models. Allows Claude, Cursor, and any MCP-compatible AI to control a real web browser with full anti-detection fingerprinting — the same stealth infrastructure used for web scraping, now driven by AI.
Estrelas
4
Ferramentas
—
Disponibilidade
—
How it works
AI Model (Claude, Cursor, etc.)
│ MCP tool calls
▼
abrasio-mcp server
│ Abrasio SDK
▼
Patchright (undetected Playwright fork)
│ CDP WebSocket
▼
Chrome (local stealth) OR Abrasio cloud worker (fingerprinted, residential IP)
The MCP server holds a single persistent browser session. The AI calls tools to navigate, observe, and interact — no configuration needed between steps.
Installation
pip install abrasio-mcp
Or install from source:
cd abrasio-mcp
pip install -e .
Modes
Local mode (free)
No API key required. Launches Chrome on your machine with Patchright stealth patches.
abrasio-mcp
Best for: development, testing, scraping sites that don't require real residential IPs.
Cloud mode (paid)
Requires an Abrasio API key. The browser runs on Abrasio cloud infrastructure with:
Real collected browser fingerprints (not spoofed)
Residential or datacenter IP in the target region
Persistent profiles that accumulate browser history
ABRASIO_API_KEY=sk_live_xxx abrasio-mcp
Best for: production agents, geo-targeted tasks, heavily protected sites.
Configuration
All configuration is done via environment variables. No config files required.
Variable
Default
Description
ABRASIO_API_KEY
(none)
Cloud API key. If set, enables cloud mode. If unset, uses local mode.
ABRASIO_HEADLESS
true
Run browser headless. Set false to see the browser window (local mode only).
ABRASIO_REGION
(none)
Target region for geo-configuration, e.g. BR, US, DE. Configures locale and timezone automatically.
ABRASIO_HUMANIZE
false
Set true to enable human-like interaction timing on all actions (slower but more realistic).
ABRASIO_TRANSPORT
stdio
MCP transport: stdio for local clients, streamable-http for remote/production.
ABRASIO_HOST
127.0.0.1
Bind host when using streamable-http transport.
ABRASIO_PORT
8931
Bind port when using streamable-http transport.
Integrations
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
Visible text, value, placeholder, or aria-label (up to 120 chars)
href
Link URL for anchor elements
selector
CSS selector hint — use this with browser_click and browser_fill
x, y
Center coordinates in the viewport
visible
Whether the element is within the current viewport
Call browser_find_elements before interacting to get the correct selector for browser_click and browser_fill.
browser_wait_for
Wait for an element to appear in the DOM.
Parameter
Type
Default
Description
selector
string
(required)
CSS selector to wait for
timeout
integer
10000
Maximum wait time in milliseconds
Returns: JSON object with found: true, the selector, and the element's text content.
Use this after triggering actions that cause loading states (form submissions, route changes, AJAX updates).
Interaction
All interaction tools use the Abrasio human simulation layer:
Clicks use WindMouse — a physics-based cursor movement algorithm that mimics real hand movement with gravity, wind perturbations, and velocity management.
Typing uses character-level timing with realistic delays, burst typing, and occasional typos followed by backspace correction.
Clears any existing value, clicks the field, then types with human-like timing.
Returns: Confirmation string with character count.
Prefer browser_fill over browser_type when targeting a specific input. Use browser_type only when the input is already focused.
browser_type
Type text at the current cursor position.
Parameter
Type
Description
text
string
Text to type
Types into whichever element currently has focus. Useful for keyboard shortcuts, search boxes that open on click, or multi-step typing flows.
Returns: Confirmation string with character count.
browser_scroll
Scroll the page vertically.
Parameter
Type
Default
Description
pixels
integer
800
Pixels to scroll. Positive = down, negative = up.
Returns: Confirmation string indicating direction and distance.
browser_hover
Move the mouse over an element without clicking.
Parameter
Type
Description
selector
string
CSS selector for the element to hover
Uses WindMouse movement to reach the element. Useful for revealing dropdown menus, tooltips, or hover-triggered UI elements.
Returns: Confirmation string.
browser_press
Press a keyboard key or key combination.
Parameter
Type
Description
key
string
Key name or combination
Common values:
Key string
Action
Enter
Submit form / confirm
Tab
Move focus to next field
Escape
Close modal / cancel
ArrowDown / ArrowUp
Navigate dropdowns
Control+a
Select all
Control+c
Copy
Meta+Return
Submit (macOS)
Returns: Confirmation string.
Evaluation
browser_evaluate
Execute JavaScript in the current page context.
Parameter
Type
Description
script
string
JavaScript expression or function
The script can be a simple expression or a function that returns a value:
// Expression
document.title
// Arrow function
() => document.querySelectorAll('h2').length
// Function with logic
() => {
const el = document.querySelector('#price');
return el ? el.innerText.trim() : null;
}
// Read localStorage
() => ({ token: localStorage.getItem('auth_token') })
Returns: JSON-serialized result of the script execution.
Use this for data extraction that browser_get_text and browser_get_html cannot handle — structured data, counts, computed values, or interacting with the page's JavaScript environment.
Patterns and best practices
Starting a task
Always begin with a screenshot to understand the current state:
1. browser_navigate("https://target.com")
2. browser_screenshot() ← see what loaded
3. browser_find_elements() ← discover available interactions
The browser session is lazy-started: the MCP server process starts immediately, and the browser only opens when the first tool is called. The session persists for the lifetime of the server process — navigation history, cookies, and localStorage are preserved across all tool calls.
On SIGTERM or SIGINT, the server calls Abrasio.close() which signals the worker to stop (in cloud mode) before dropping the CDP connection, ensuring proper billing finalization.
Browser agent (browser.py)
AbrasioBrowserAgent wraps Abrasio (the SDK's unified class) and holds a single Page object. All tools delegate to this agent. The asyncio.Lock on ensure_started prevents concurrent initialization if two tools are called in rapid succession before the browser is ready.
All interaction methods use the human/actions.py primitives from the Abrasio SDK directly — no custom mouse or keyboard simulation is implemented in abrasio-mcp.
MCP server that exposes **Abrasio** as an agentic browser for AI models. Allows Claude, Cursor, and any MCP-compatible AI to control a real web browser with full anti-detection fingerprinting — the s
MCP server that exposes **Abrasio** as an agentic browser for AI models. Allows Claude, Cursor, and any MCP-compatible AI to control a real web browser with full anti-detection fingerprinting — the same stealth infrastructure used for web scraping, now driven by AI.
Ferramentas
Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Perguntas
Como instalo Abrasio?
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
Qual transporte Abrasio usa?
Abrasio roda localmente via stdio.
Quando Abrasio foi verificado pela última vez?
Última verificação: 2026-10-28. MCP server that exposes **Abrasio** as an agentic browser for AI models. Allows Claude, Cursor, and any MCP-compatible AI to control a real web browser with full anti-detection fingerprinting — the same stealth infrastructure used for web scraping, now driven by AI.