# Airbrowser Mcp

> Undetectable Chrome for AI agents, web scraping, and automation. REST API + MCP server + VNC debugging.

- **Type:** MCP server
- **Install:** `agentstack add mcp-ifokeev-airbrowser-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ifokeev](https://agentstack.voostack.com/s/ifokeev)
- **Installs:** 0
- **Category:** [Web & Browser](https://agentstack.voostack.com/c/web-and-browser)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ifokeev](https://github.com/ifokeev)
- **Source:** https://github.com/ifokeev/airbrowser-mcp
- **Website:** https://ifokeev.github.io/airbrowser-mcp/

## Install

```sh
agentstack add mcp-ifokeev-airbrowser-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Airbrowser

[](https://github.com/ifokeev/airbrowser-mcp/actions/workflows/ci.yml)
[](https://pypi.org/project/airbrowser-client/)
[](https://www.npmjs.com/package/airbrowser-client)
[](LICENSE)
[](https://discord.gg/dP9PbTPHcN)

**Open-source browser automation API with anti-detection** — Undetectable Chrome for AI agents, web scraping, and automation. REST API + MCP server + VNC debugging. Selenium/Playwright alternative that bypasses Cloudflare.

## Quick Start

### Docker (one-liner)

```bash
docker run -d -p 18080:18080 --name airbrowser ghcr.io/ifokeev/airbrowser-mcp:latest

# With NVIDIA GPU (recommended for anti-detection)
docker run -d -p 18080:18080 --gpus all --device /dev/dri:/dev/dri --name airbrowser ghcr.io/ifokeev/airbrowser-mcp:latest
```

### Portable Downloads

Download and run - no Docker knowledge required:

| Platform | Download | Requirements |
|----------|----------|--------------|
| Linux | [airbrowser-linux.tar.gz](https://github.com/ifokeev/airbrowser-mcp/releases/latest/download/airbrowser-linux.tar.gz) | `uidmap` package or Docker |
| macOS | [airbrowser-mac.tar.gz](https://github.com/ifokeev/airbrowser-mcp/releases/latest/download/airbrowser-mac.tar.gz) | Colima, Docker Desktop, or Podman |
| Windows | [airbrowser-windows.zip](https://github.com/ifokeev/airbrowser-mcp/releases/latest/download/airbrowser-windows.zip) | Docker Desktop or Podman |

```bash
# Linux/macOS
tar -xzf airbrowser-*.tar.gz && cd airbrowser-* && ./airbrowser

# Windows: Extract zip and double-click airbrowser.bat
```

### From Source

```bash
git clone https://github.com/ifokeev/airbrowser-mcp.git
cd airbrowser-mcp
docker compose up --build

# With NVIDIA GPU
docker compose -f compose.gpu.yml up --build
```

### Local Mode (no Docker) — Linux only

Run natively without a container — zero container fingerprint for maximum anti-detection stealth. Tested on Ubuntu/Debian.

```bash
git clone https://github.com/ifokeev/airbrowser-mcp.git
cd airbrowser-mcp
uv run python run_local.py         # auto-installs deps + system packages
uv run python run_local.py --vnc   # with VNC viewer at http://localhost:6080/vnc.html
```

Requires Chrome installed on the host. See `python run_local.py --help` for options.

| Service | URL | Description |
|---------|-----|-------------|
| Dashboard | `http://localhost:8000/dashboard` | Browser pool management UI |
| Swagger Docs | `http://localhost:8000/docs/` | Interactive API documentation |
| REST API | `http://localhost:8000/api/v1/` | Browser automation endpoints |
| MCP Server | `http://localhost:3099/mcp` | Model Context Protocol for AI agents |
| VNC | `vnc://localhost:5900` | Remote desktop (with `--vnc` flag) |
| noVNC | `http://localhost:6080/vnc.html` | Web-based VNC viewer (with `--vnc` flag) |

---

Open **http://localhost:18080** - all services available:

| Service | Path |
|---------|------|
| Dashboard | `/` |
| API Docs | `/docs/` |
| REST API | `/api/v1/` |
| MCP Server | `/mcp` |
| VNC Viewer | `/vnc/` |

## Features

- Undetected Chrome (SeleniumBase UC)
- 100+ concurrent browsers
- Persistent profiles & cookies
- Tab management
- Proxy per browser ([DataImpulse](https://dataimpulse.com/?aff=250254) recommended)
- MCP for AI agents
- AI vision tools (optional)

## GPU Passthrough (Recommended)

GPU passthrough enables hardware-accelerated WebGL rendering via Vulkan, making the browser fingerprint match a real desktop machine. Without it, Chrome falls back to software rendering (SwiftShader) which is easily detected by anti-bot systems.

**Requirements:** NVIDIA GPU + [NVIDIA Container Toolkit](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html)

```bash
# Docker Compose (recommended)
docker compose -f compose.gpu.yml up

# Docker run
docker run -d -p 18080:18080 \
  --gpus all \
  --device /dev/dri:/dev/dri \
  -e NVIDIA_VISIBLE_DEVICES=all \
  -e NVIDIA_DRIVER_CAPABILITIES=all \
  ghcr.io/ifokeev/airbrowser-mcp:latest

# Portable launcher
./airbrowser --gpu
```

Without a GPU, Chrome uses `--use-gl=swiftshader` automatically. With GPU passthrough, it uses `--use-gl=angle --use-angle=vulkan` for real GPU rendering.

## AI Vision (Optional)

Enable AI-powered vision tools (`what_is_visible`, `detect_coordinates`) with any OpenAI-compatible vision backend. Vision turns on only when `VISION_API_BASE_URL`, `VISION_API_KEY`, and `VISION_MODEL` are all set.

When smart targeting is enabled per request, `detect_coordinates` can validate a raw vision point, optionally snap to a nearby clickable target, and return both the original `click_point` and a `resolved_click_point` with an `outcome_status` that tells you whether the result was confirmed, corrected, or needs inspection before clicking. Pair that with `gui_click` or MCP-compatible `gui_click_xy` to re-check coordinate clicks and request post-click feedback.

```bash
# Docker run
docker run -d -p 18080:18080 \
  -e VISION_API_BASE_URL=https://your-openai-compatible-endpoint/v1 \
  -e VISION_API_KEY=your-api-key \
  -e VISION_MODEL=your-vision-model \
  ghcr.io/ifokeev/airbrowser-mcp:latest

# Docker compose
VISION_API_BASE_URL=https://your-openai-compatible-endpoint/v1 \
VISION_API_KEY=your-api-key \
VISION_MODEL=your-vision-model \
docker compose up
```

## MCP Client Configuration

Add airbrowser to your AI coding assistant:

Claude Code

```bash
claude mcp add airbrowser --transport http http://localhost:18080/mcp
```

Cursor

Go to `Cursor Settings` → `MCP` → `Add new MCP Server`:

```json
{
  "mcpServers": {
    "airbrowser": {
      "url": "http://localhost:18080/mcp",
      "transport": "http"
    }
  }
}
```

VS Code / Copilot

Add to your MCP settings:

```json
{
  "mcpServers": {
    "airbrowser": {
      "url": "http://localhost:18080/mcp",
      "transport": "http"
    }
  }
}
```

Cline

Follow [Cline MCP guide](https://docs.cline.bot/mcp/configuring-mcp-servers) with:

```json
{
  "mcpServers": {
    "airbrowser": {
      "url": "http://localhost:18080/mcp",
      "transport": "http"
    }
  }
}
```

Windsurf

Follow the [Windsurf MCP guide](https://docs.windsurf.com/windsurf/cascade/mcp) with the config above.

### Test your setup

```
Navigate to https://example.com and take a screenshot
```

Your AI assistant should create a browser, navigate to the URL, and return a screenshot.

## Generated Clients

Auto-generated from OpenAPI spec:

```bash
# Python
pip install airbrowser-client

# TypeScript
npm install airbrowser-client
```

## Community

Join our [Discord server](https://discord.gg/dP9PbTPHcN) for support, feature requests, and discussion.

## Docs

- [docs/](docs/) - Full documentation
- [examples/](examples/) - Code samples

## License

[MIT](LICENSE)

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ifokeev](https://github.com/ifokeev)
- **Source:** [ifokeev/airbrowser-mcp](https://github.com/ifokeev/airbrowser-mcp)
- **License:** MIT
- **Homepage:** https://ifokeev.github.io/airbrowser-mcp/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-ifokeev-airbrowser-mcp
- Seller: https://agentstack.voostack.com/s/ifokeev
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.