# Veilus

> Veilus is an MCP server for browser automation. Drive Veilus browser profiles, pages, scripts and schedules from an AI assistant. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** macOS, CLI
- **Website:** https://docs.veilus.io/reference/mcp/
- **Repository:** https://github.com/veilus/sdk/tree/HEAD/mcp
- **MCP Registry name:** io.github.veilus/veilus
- **Categories:** browser automation
- **Listing updated:** 2026-11-15

## About

Veilus is a desktop app for running separate browser profiles, and this server is the app's own binary started with an `mcp` subcommand, with the npm package veilus-mcp acting as a launcher that finds it. It speaks stdio and each tool maps to one route of the app's local REST API, which must be turned on from the API and MCP page in the sidebar, where you also create the token.

Through it an assistant can import proxies, create and launch profiles, drive a running profile's page, write and run Veilus Flow scripts and schedule tasks. list_profiles returns each profile's running state and proxy settings. launch_profile waits for the browser to start and returns a pid and a cdpUrl, a Chromium DevTools endpoint that Playwright, Puppeteer or other CDP clients can attach to.

The MCP server and local API require a Pro plan or higher; the Free plan excludes them, and the app includes a 7-day Pro trial. Requests with a non-loopback Host header are refused. The launcher is licensed MIT or Apache-2.0.

## Features

- **Profile management:** List, create and launch browser profiles with proxy settings.
- **CDP endpoint:** launch_profile returns a DevTools URL for Playwright or Puppeteer.
- **Veilus Flow scripts:** Write, save and run scripts.
- **Schedules:** Create scheduled runs.
- **Loopback-only API:** Local API rejects non-loopback Host headers.

## Good for

- Launch a profile and attach Playwright to it
- Import a batch of proxies and assign them to profiles
- Schedule a script to run on a profile
- Ask an assistant which profiles are currently running

## Install

### Claude Code (Terminal)

```sh
claude mcp add veilus --env VEILUS_API_TOKEN='<VEILUS_API_TOKEN>' -- npx -y veilus-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "veilus": {
      "command": "npx",
      "args": [
        "-y",
        "veilus-mcp"
      ],
      "env": {
        "VEILUS_API_TOKEN": "<VEILUS_API_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "veilus": {
      "command": "npx",
      "args": [
        "-y",
        "veilus-mcp"
      ],
      "env": {
        "VEILUS_API_TOKEN": "<VEILUS_API_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "veilus": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "veilus-mcp"
      ],
      "env": {
        "VEILUS_API_TOKEN": "<VEILUS_API_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "veilus": {
      "command": "npx",
      "args": [
        "-y",
        "veilus-mcp"
      ],
      "env": {
        "VEILUS_API_TOKEN": "<VEILUS_API_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "veilus": {
      "command": "npx",
      "args": [
        "-y",
        "veilus-mcp"
      ],
      "env": {
        "VEILUS_API_TOKEN": "<VEILUS_API_TOKEN>"
      }
    }
  }
}
```

## Tools

- `list_profiles`: List Veilus browser profiles with their running state
- `launch_profile`: Launch a profile and return its pid and cdpUrl

## FAQ

### What do I need?

The Veilus desktop app running with its local API enabled, a token from the API and MCP page, and Node.js 18 or newer for the launcher.

### Is it on the Free plan?

No. A Pro plan or higher is required, and there is a 7-day Pro trial.

### How does the launcher find the app?

Via VEILUS_BINARY, or the default macOS application paths.

### What happens if the app is missing?

The server still lists tools, but every call returns an error asking you to install the app.

### Is Veilus free?

Veilus is a paid product with a free trial.

### How do I add Veilus to Claude Code?

Run this command in your terminal: claude mcp add veilus --env VEILUS_API_TOKEN='<VEILUS_API_TOKEN>' -- npx -y veilus-mcp

### What are the best alternatives to Veilus?

The closest alternatives to Veilus are Browser Use, Scrapling MCP Server, Oya Browser, Mantis and Auto-building agents.

## Alternatives

- [Browser Use](https://ai-powered.com/mcp/browser-use): Browser Use is a freemium MCP server for browser automation.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Mantis](https://ai-powered.com/mcp/mantis-2): Mantis is an open-source MCP server for browser automation.
- [Auto-building agents](https://ai-powered.com/mcp/auto-building-agents): Auto-building agents is a paid MCP server for browser automation.
- [pour](https://ai-powered.com/mcp/pour): pour is an open-source MCP server for developer tools.
- [AgentFarm](https://ai-powered.com/mcp/agentfarm): AgentFarm is a freemium MCP server for browser automation.
- [OpenAdapt: your agent decides, OpenAdapt enters it and checks it saved](https://ai-powered.com/mcp/openadapt-your-agent-decides-openadapt-enters-it-and-checks): OpenAdapt: your agent decides, OpenAdapt enters it and checks it saved is an open-source MCP server for browser automation.

---
Source: https://ai-powered.com/mcp/veilus
