Veilus
Drive Veilus browser profiles, pages, scripts and schedules from an AI assistant
- 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-mcpAdd 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 appRequiredVEILUS_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

Browser Use
MCP serverBrowser agents and cloud browsers for AI, with an MCP server for web tasks
- 7 tools
- Remote
- Freemium
- 121K GitHub stars
- Browser automation

Scrapling MCP Server
MCP serverMCP 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

Oya Browser
MCP serverHIPAA-oriented agentic browser with replayable playbooks, reachable over MCP
- 32 tools
- Remote
- Freemium
- 349 GitHub stars
- Browser automation
Mantis
MCP serverBrowser MCP server that gives agents numbered text pages instead of screenshots
Runs locally- 1 tool
- Open source
- 5 Hacker News points
- Browser automation

Auto-building agents
MCP serverBuild and continue browser and Mac automation scripts for Super through Claude
- Remote
- Paid
- Browser automation

pour
MCP serverRun WCAG 2.2 accessibility audits and vision simulations on any URL from an agent
Runs locally- Open source
- Developer tools