Back to blog
Guide12 min read
Cursor + Ornold MCP: Full Browser Automation Setup Guide
Connect Cursor to Ornold MCP and automate antidetect browsers with AI. Step-by-step setup for Linken Sphere, Dolphin Anty, and more.
Apr 19, 2026What You'll Build
By the end of this guide, you'll have Cursor controlling real antidetect browser sessions — navigating pages, filling forms, solving CAPTCHAs, and managing multiple profiles — all through natural language in the Cursor chat. No Playwright scripts. No CSS selectors. Just tell the AI what to do.
This guide covers macOS and Windows. Linux steps are the same as macOS (use your package manager instead of Homebrew).
Prerequisites
- A computer running macOS 12+ or Windows 10/11
- Cursor installed (free or Pro plan)
- An antidetect browser installed: Linken Sphere, Dolphin Anty, Wadex, or Vision Browser
- An internet connection for downloading tools and packages
Step 1 — Install Node.js
Ornold MCP runs as a Node.js package. You need Node.js version 20 or higher.
macOS
The easiest way is Homebrew. If you don't have Homebrew, install it first from brew.sh. Then:
brew install node@22
Windows
Download the official installer from nodejs.org. Choose the LTS version (22.x). Run the installer and follow the prompts. Make sure "Add to PATH" is checked.
Verify the installation by opening Terminal (macOS) or PowerShell (Windows):
node --version
# Expected output: v22.x.x or higher
npm --version
# Expected output: 10.x.x or higher
Step 2 — Install Cursor
Cursor is an AI-powered code editor built on VS Code. It supports MCP (Model Context Protocol) natively, which lets it use external tools like browser automation.
- Download Cursor from cursor.com
- Install and open it
- Sign in with your Cursor account (free plan works for MCP)
If you already have Cursor installed, make sure it's updated to the latest version — MCP support was added in recent releases.
Cursor Pro gives you more AI requests per month, but the free plan is enough to test MCP browser automation.
Step 3 — Create an Ornold Account
Ornold is the bridge between AI agents and antidetect browsers. You need an account to get an API token.
- Go to mcp.ornold.com
- Click "Register" and create an account with your email
- Verify your email with the 6-digit code sent to your inbox
- You'll land on the dashboard — you're in!
Step 4 — Create an API Token
After registration, the dashboard will prompt you to create your first API token. This token authenticates your MCP connection.
- Enter a name for your token (e.g., "Cursor")
- Click "Create"
- Copy the token and save it somewhere safe — you'll need it in the next step
Free accounts get 1 seat, 5 captcha solves (after completing the tour), and access to standard browsers. Upgrade your plan for more capacity.
Step 5 — Generate MCP Config with the Dashboard Wizard
The Ornold dashboard has a built-in Connect Wizard that generates the exact MCP config for your setup. No manual JSON crafting needed — just pick your options and copy the result.
Go to the API Tokens tab in the dashboard. Find your token and click the "Connect" button next to it.
Wizard Step 1 — Choose Your AI Agent
The wizard asks which AI agent you're using. Select "Cursor" from the list. The wizard will generate config in JSON format for Cursor's mcp.json. Other supported agents include Claude Code, Codex, VS Code, Windsurf, and Cline.
Wizard Step 2 — Choose Interaction Mode
Pick how the AI should interact with browser pages:
- DOM mode (default) — The AI reads the page HTML structure. Each element gets a [ref=N] marker. Free and fast. Best for forms, structured pages, and standard websites.
- Vision AI mode — The AI takes a screenshot and visually finds elements by how they look. Works on any page, even canvas-based UIs. Each analysis costs 1 vision credit.
- Both modes — All tools available. The AI picks the best approach for each action automatically.
Start with DOM mode. It's free, fast, and handles 90% of use cases. You can always switch to "Both" later if you need visual analysis.
Wizard Step 3 — Enable Antidetect Browsers
Toggle on the browsers you use and fill in their connection details:
- Linken Sphere — Just set the API port (default: 40080). Make sure Sphere is running.
- Dolphin Anty — Set the local port (default: 3001) and paste your Dolphin API token from Settings → API.
- Wadex — Set the API port (default: 8080).
- Vision Browser — Paste your X-Token. Optionally set a local port.
You can enable multiple browsers at once. The MCP config will include all of them, and Cursor will be able to control whichever is running.
Wizard Step 4 — Copy the Config
The wizard generates the final JSON config based on your choices. Click "Copy" to grab it — you'll paste it into Cursor's MCP settings in the next step.
The wizard pre-fills your actual token and port values — just click "Copy" and paste. No manual editing needed.
Step 6 — Add Ornold MCP to Cursor
Cursor manages MCP servers through a JSON config file. You can open it from Cursor Settings → MCP → "Add new MCP server" — this opens the mcp.json file in the editor. Cursor stores MCP settings in two locations:
# Global (all projects)
~/.cursor/mcp.json
# Per-project (this project only)
.cursor/mcp.json
Paste the config from the wizard. Here's what it looks like for Linken Sphere:
{
"mcpServers": {
"ornold-browser": {
"command": "npx",
"args": ["ornold-mcp", "--token", "YOUR_TOKEN", "--linken-port", "40080"]
}
}
}
For Dolphin Anty:
{
"mcpServers": {
"ornold-browser": {
"command": "npx",
"args": ["ornold-mcp", "--token", "YOUR_TOKEN", "--dolphin-port", "3001", "--dolphin-token", "YOUR_DOLPHIN_TOKEN"]
}
}
}
For multiple browsers at once:
{
"mcpServers": {
"ornold-browser": {
"command": "npx",
"args": [
"ornold-mcp",
"--token", "YOUR_TOKEN",
"--linken-port", "40080",
"--dolphin-port", "3001",
"--dolphin-token", "DOLPHIN_KEY",
"--wadex-port", "8080"
]
}
}
}
Use ~/.cursor/mcp.json for global setup (available in all projects). Use .cursor/mcp.json in a project root to share the config with your team via version control.
Step 7 — Start Your Browser and Test
Make sure your antidetect browser is running before using Cursor's AI chat. Quick checklist:
- Linken Sphere — Open the app. Create at least one session if you don't have any.
- Dolphin Anty — Open the app. Make sure the local API is enabled in Settings.
- Wadex — Open the app and verify the API port matches your config.
Open any project in Cursor and start a chat with the AI (Cmd+L or Ctrl+L). Make sure you're using Agent mode — that's where MCP tools are available.
Step 8 — Your First AI Browser Command
Everything is connected. Open the Cursor chat and talk to it in natural language. Here are some commands to try:
# Start a Linken Sphere session and navigate
> Start a new Linken Sphere session and open google.com
# Fill a form
> Go to example.com/signup, fill in email "test@mail.com" and password "SecurePass123", then click Sign Up
# Solve a CAPTCHA
> There's a CAPTCHA on this page, solve it
# Take a screenshot for visual analysis
> Take a screenshot of the current page and describe what you see
# Work with multiple sessions
> Start 3 Linken Sphere sessions and open google.com in all of them
Available MCP Tools
Once connected, Cursor has access to 40+ browser automation tools. Here are the most commonly used:
- linken_start_instances / dolphin_start_profiles — Start browser sessions
- browser_parallel_navigate — Open URLs in all active browsers
- browser_parallel_snapshot — Get page DOM with clickable [ref=N] markers
- browser_parallel_click — Click elements by ref or selector
- browser_parallel_fill — Type text into input fields
- browser_parallel_screenshot — Capture screenshots of all sessions
- browser_parallel_vision_analyze_grouped — AI-powered visual page analysis
- browser_solve_captcha — Auto-solve reCAPTCHA, hCaptcha, Turnstile, and more
- browser_parallel_evaluate — Run JavaScript in page context
- linken_stop_instances / dolphin_stop_profiles — Close sessions
You don't need to remember tool names. Just describe what you want in plain English and Cursor will pick the right tools automatically.
Interaction Modes
Ornold MCP supports two interaction modes. You can choose when setting up:
DOM Mode (default, free)
The AI reads the page structure via DOM snapshots. Each element gets a [ref=N] marker. Fast and doesn't cost any vision credits. Best for structured pages with clear HTML.
Vision AI Mode (paid per analysis)
The AI takes a screenshot and uses visual analysis to find elements by how they look. Works on any page, even complex SPAs or canvas-based UIs. Each analysis costs 1 vision credit.
To enable both modes, add the --mode flag to your MCP config args:
{
"mcpServers": {
"ornold-browser": {
"command": "npx",
"args": ["ornold-mcp", "--token", "YOUR_TOKEN", "--mode", "both", "--linken-port", "40080"]
}
}
}
Cursor Agent Mode vs Ask Mode
Cursor has two chat modes. MCP tools only work in Agent mode:
- Agent mode — The AI can use MCP tools, run terminal commands, and edit files. This is what you need for browser automation.
- Ask mode — The AI only answers questions based on your codebase. No tool access. MCP tools won't appear here.
Make sure you're in Agent mode (check the dropdown at the top of the chat panel) before trying browser commands. If you don't see MCP tools, switch to Agent mode.
You can also use Cursor's Composer (Cmd+I / Ctrl+I) for multi-step browser automation tasks. Composer supports MCP tools in Agent mode too.
Troubleshooting
- "MCP server not showing" — Make sure mcp.json is valid JSON. Even a trailing comma will break it. Use a JSON validator if unsure.
- "npx: command not found" — Node.js not in PATH. Restart Cursor after installing Node.js. On macOS with nvm, you may need to set the full path to npx in the command field.
- "Cannot connect to Linken Sphere" — Make sure Sphere is running and the API port is correct (default 40080). Check that no firewall blocks the port.
- "Token invalid" — Copy the token again from mcp.ornold.com dashboard. Tokens are long strings — make sure you copied the entire value.
- "Tools not appearing in chat" — Make sure you're in Agent mode, not Ask mode. Check Cursor Settings → MCP to verify the server shows a green "connected" status.
- "CAPTCHA solve failed" — Check your captcha credit balance on the Ornold dashboard. Free plan includes limited solves.
- "Server disconnected" — Cursor may disconnect MCP servers after idle time. Restart the chat or toggle the server off/on in Settings → MCP.
What's Next?
- Read the Claude Code + Ornold MCP guide if you also use Claude Code
- Read the Codex + Ornold MCP guide if you also use OpenAI Codex
- Learn about parallel browser automation for running 10+ sessions at once
- Check the CAPTCHA solving guide for handling reCAPTCHA, hCaptcha, and Turnstile
- Explore Vision AI mode for interacting with complex visual interfaces