Skip to content
MCP server

Veilus

Drive Veilus browser profiles, pages, scripts and schedules from an AI assistant

Runs locallyStatus and history
Pricing
Free trial
Platforms
macOS, CLI
Runs
Locally
Version
0.1.0
Listing updated
2 days ago

About Veilus

Veilus is an MCP server for browser automation. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • VEILUS_API_TOKENAPI token from the API & MCP page of the Veilus appRequired
  • VEILUS_BINARYPath to the Veilus app binary, if not in the default macOS location

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Free trial

Requires Veilus Pro; 7-day Pro trial included in the app

Prices change. Check docs.veilus.io before you buy.

Veilus 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 to Veilus

  1. Browser Use

    MCP server

    Browser agents and cloud browsers for AI, with an MCP server for web tasks

    • 7 tools
    • Remote
    • Freemium
    • 121K GitHub stars
    • Browser automation
  2. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  3. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  4. Mantis

    MCP server

    Browser MCP server that gives agents numbered text pages instead of screenshots

    Runs locally
    • 1 tool
    • Open source
    • 5 Hacker News points
    • Browser automation
  5. Build and continue browser and Mac automation scripts for Super through Claude

    • Remote
    • Paid
    • Browser automation
  6. pour

    MCP server

    Run WCAG 2.2 accessibility audits and vision simulations on any URL from an agent

    Runs locally
    • Open source
    • Developer tools