English Français العربية

Veilus

Official registry Search and web

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

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package veilus-mcp
Claude Code 
claude mcp add veilus -e 'VEILUS_API_TOKEN=<your veilus_api_token>' -e 'VEILUS_BINARY=<VEILUS_BINARY>' -- npx -y veilus-mcp@0.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "veilus": {
            "command": "npx",
            "args": [
                "-y",
                "veilus-mcp@0.1.0"
            ],
            "env": {
                "VEILUS_API_TOKEN": "<your veilus_api_token>",
                "VEILUS_BINARY": "<VEILUS_BINARY>"
            }
        }
    }
}

Environment variables

  • VEILUS_API_TOKEN required secret API token from the API & MCP page of the Veilus app
  • VEILUS_BINARY Path to the Veilus app binary, if not in the default macOS location

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Veilus SDK

Launch Veilus browser profiles from your own code and drive them with Playwright.

Works with

Tested with a real Veilus profile — see examples/TESTED.md for versions and date: Playwright · Puppeteer · browser-use · Stagehand · Crawl4AI · LangChain · Scrapling · Crawlee · playwright-mcp · agent-browser

Ready-made solutions: solutions/ — price monitor, geo landing check, AI agent over MCP.

LanguagePackageInstall
Node.jsveilusnpm install veilus playwright-core
Pythonveiluspip install "veilus[playwright]"
MCPveilus-mcpnpx -y veilus-mcp (launcher for the app's MCP server)

Both are thin clients of the Veilus desktop app's local REST API: they launch a profile, then attach Playwright to that profile's own browser over its CDP address, so your script runs with the profile's fingerprint, proxy and cookies. They need the app (0.2.9 or newer) running with the local API on, and a token in VEILUS_API_TOKEN.

For other tools (Puppeteer, playwright-mcp, browser-use, Crawl4AI…), see Use a Profile from Other Tools. The full REST API is documented at docs.veilus.io.

Also in the docs: Web scraping recipe · Common issues · FAQ.

License

MIT or Apache-2.0, at your option.

Frequently asked questions

What is Veilus?

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

How do I install Veilus?

It runs on your machine. In Claude Code: claude mcp add veilus -e 'VEILUS_API_TOKEN=<your veilus_api_token>' -e 'VEILUS_BINARY=<VEILUS_BINARY>' -- npx -y veilus-mcp@0.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Veilus need an API key?

Yes. It expects VEILUS_API_TOKEN, which you set in its configuration.

Is Veilus open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains Veilus?

It is published by veilus. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.