# Oculr MCP — an antidetect browser for AI agents

[Oculr](https://oculr.ai) is an antidetect browser that AI agents can drive. It exposes
a [Model Context Protocol](https://oculr.ai/glossary/model-context-protocol) server so an
agent like Claude can create real, isolated browser profiles, browse and act inside them,
and run whole fleets — each profile a real Chromium browser with engine-level
fingerprinting and its own proxy, driven over raw
[Chrome DevTools Protocol](https://oculr.ai/glossary/chrome-devtools-protocol) with no
injected Playwright or Puppeteer globals.

This repository is the connect guide + Claude skill for pointing an MCP client at Oculr.
Full docs: **https://oculr.ai/developers/mcp**

## Why an antidetect browser for AI agents

Generic automation stacks announce themselves to every site they touch. Oculr gives an
agent the same thing a person has: a real browser with a consistent, engine-level identity
that re-applies on every tab, so the agent sees the same site a person would in a stable
environment you control. See [oculr.ai/ai-agents](https://oculr.ai/ai-agents).

- **Real Chromium, native fingerprinting** — fingerprinting is compiled into the engine in
  native C++, not patched on with JavaScript.
- **40+ MCP tools** across browsing, profile lifecycle, fleet control and workflow recording.
- **Raw CDP underneath** — none of the globals automation frameworks add ever touch the page.
- **Per-profile proxies** with timezone, language and geolocation aligned to each exit.
- **Fleet control** — one agent call fans out across many region-pinned profiles at once.
- **Local-first** — profiles and data stay on your machine.

## Install

1. Download the Oculr desktop app for macOS, Windows or Linux: **https://oculr.ai/download**
2. Open Oculr and use the one-click **Add to Claude** connect flow, or add the MCP server
   manually with the command it shows you.

```bash
# The desktop app prints the exact command; it looks like:
claude mcp add oculr
```

Oculr's MCP server speaks local stdio for zero setup, or HTTP with a mandatory bearer token.

## Use it

Once connected, just ask your agent:

> "Launch the three storefront profiles and check today's listings on each."

The agent calls Oculr's tools — `profile_launch`, `browser_navigate`, `browser_snapshot`,
`fleet_run` and the rest — to drive real browser profiles. Page structure is compressed
5 to 10x before it reaches the model, so tokens go to decisions instead of raw DOM.

## Programmatic clients

- TypeScript / JavaScript: [`oculr-sdk`](https://www.npmjs.com/package/oculr-sdk)
- Python: [`oculr`](https://pypi.org/project/oculr/)
- Any Playwright, Puppeteer or Selenium script can attach over the standard CDP endpoint.

## Links

- Product: https://oculr.ai
- For AI agents: https://oculr.ai/ai-agents
- MCP docs: https://oculr.ai/developers/mcp
- Glossary: https://oculr.ai/glossary

## License

MIT — see [LICENSE](./LICENSE). Use Oculr in compliance with the terms of the sites you automate.