AI agents / Browz for Cursor
A browser for Cursor’s agent, kept apart from yours.
You decide exactly what each agent may do: its own key, its own profiles, only the sites you allow, sign-ins it can use on your computer but never read, and a person for the login. Let Cursor’s agent open pages, read them and click through them in Browz. Each task runs in its own isolated profile, so the agent can sign in to a staging site as a test user, check how a page looks from another country, or collect what it needs, without ever touching your own browser and its sessions. Underneath, every profile’s fingerprint is set in the browser engine itself, not by a script on top, and you can test it yourself (engine-level vs injected scripts).
{
"mcpServers": {
"browz": {
"command": "/Applications/Browz.app/Contents/Resources/browz-mcp",
"args": []
}
}
}Browz for Cursor
What your agent gets.
Your browser stays yours
Give the agent a Browz key limited to the profiles and sites it needs, and a test user’s sign-in it can use but never read. The agent never sees your everyday browser, its passwords or its sessions. Lock any profile it should not open.
Security 02Test as other users
Give each test account its own profile, signed in once and kept, so the agent checks a flow as a new customer, an admin or a visitor from another region.
QA and web testing 03Snapshots the agent can act on
The page comes back as a compact outline with refs, and the agent clicks and types by ref, with fewer tokens than raw HTML or screenshots alone.
The MCP tools 04One config, every project
Add Browz to ~/.cursor/mcp.json for all projects, or to .cursor/mcp.json for one. It starts the server inside the app. Remotely, in beta, Cursor signs you in.
Cursor setupSetup
Working in minutes.
These are the same snippets as the setup docs and the Connect an AI agent screen in the app.
Install Browz and open it
Download Browz. Cursor drives the profiles of that app.
Add Browz to Cursor
Click Add to Cursor, or paste the entry into mcp.json, then check that Browz shows as connected in Cursor’s MCP settings.
Ask the agent
“Using Browz: create a new profile called agent-check, start it, open https://example.com, tell me the page title, take a screenshot, then stop the session and delete the profile.”
Install Browz, open it, and your agent can start: no account needed for local use. Keep the app open while your agent works; it can stay on its sign-in screen.
One click Opens Cursor and adds the server inside Browz.
Cursor mcp.json Add it to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project) (all projects: ~/.cursor/mcp.json)
{
"mcpServers": {
"browz": {
"command": "/Applications/Browz.app/Contents/Resources/browz-mcp",
"args": []
}
}
}Cursor mcp.json, remote (beta) Add it to ~/.cursor/mcp.json; Cursor signs you in with your Browz account (all projects: ~/.cursor/mcp.json)
{
"mcpServers": {
"browz": {
"url": "https://mcp.gobrowz.com/mcp"
}
}
}The snippets use the macOS path to the server inside Browz, /Applications/Browz.app/Contents/Resources/browz-mcp; on Windows and Linux the paths are in the setup docs. Give each agent its own key, limited to the profiles and sites it needs, and let it sign in without seeing the password. The remote MCP server for hosted agents is in Beta: free for every account, Free included, within the beta allowance, and it needs the Browz app open with Remote control on, on a computer with a hardware security chip. See what it needs and its allowance. Use agents only where each site’s terms allow it: our acceptable use policy applies to agents the same as to people.
FAQ
About Browz for Cursor.
Does it work in Cursor on Windows and Linux?
Yes. The snippet uses the macOS path; on Windows use %LOCALAPPDATA%\Programs\Browz\browz-mcp.exe and on Linux /usr/lib/browz/browz-mcp. Or use npx -y @browz/mcp, which finds it.
Can the agent use my signed-in sessions?
Only the ones in Browz profiles you give it. Sign a profile in once and the agent comes back to it signed in; your own browser is never part of it.
Do I need a paid plan?
No. The MCP server on your computer works on every plan, Free included, and Free has 5 profiles. The hosted remote MCP server is in free beta for every account too.
More for agent builders
Other guides.
Browz for AI agents
Everything an agent gets in Browz.
OverviewAnti-detect browser for AI agents
One consistent device, its own proxy and cookies for every agent task.
Read moreMCP browser
What the Browz MCP server gives any MCP client, local or remote.
Read moreBrowz for Claude
Claude Desktop, Claude Code and Claude.ai, set up in a minute.
Read more