FoxProfile MCP
Anti-detect browser profile manager with a fingerprint, cookies and proxy per profile. A built-in MCP server connects agents.
- 197 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- The agent works in sessions with real logins: MCP opens pages, clicks, types and runs JavaScript, and cookie export hands out account logins.
- Several accounts on one platform may breach its terms and lead to a ban. The user is responsible for how the tool is used.
- A server on a VPS without an HTTPS proxy sends the token in clear text.
Install
- Works in
Manual install
git clone https://github.com/chienbm98/foxprofile.gitThe first Quick start command clones the repository. Then create a venv, run `pip install -r requirements.txt` and `python -m camoufox fetch`, and start `python -m src.main`.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The agent works in sessions with real logins: MCP opens pages, clicks, types and runs JavaScript, and cookie export hands out account logins.
- Several accounts on one platform may breach its terms and lead to a ban. The user is responsible for how the tool is used.
- A server on a VPS without an HTTPS proxy sends the token in clear text.
This is third-party code. Review the repository files before installing.
What it does
FoxProfile is a free anti-detect browser profile manager for Windows, macOS and Linux. Each profile gets its own device fingerprint (screen, GPU, cores, fonts, canvas and audio noise), cookies, proxy, timezone and locale. There are two engines: Camoufox on Firefox by default and Chrome on a fingerprint-chromium build. The app serves a REST API and an MCP server at `/mcp` on the same port. Through MCP, Claude Code, Cursor and other clients start and stop profiles, open pages, click, type, read page text, take screenshots and run JavaScript. There is deliberately no profile deletion in MCP, so an agent cannot wipe an account's cookies.
Who it is for. Agencies and testers who keep client accounts in separate profiles and want an agent to handle routine work inside them.
Good fit when
- An agency runs client accounts and keeps each in a profile with its own proxy and timezone.
- A web app is checked in a browser with different device fingerprints and in different countries.
- Profiles move to a VPS and are managed through the web panel with a token.
- Cookies from a profile are needed in `yt-dlp` or `curl`: export goes to Netscape `cookies.txt`.
- Claude Code opens a profile on request, visits a site and sends a screenshot.
Not a fit when
- The goal is to dodge platform rules: multiple accounts can breach the terms of Facebook, TikTok, Google, Shopee and others.
- A plain Playwright MCP is enough: your own fingerprint and separate profiles are not needed.
- Pages need DRM video: the Chrome build has no Widevine.
Example request
Open the shop-eu-01 profile, visit the store site and send a screenshot of the home page.MCP
- Transport
- http
- Authentication
- key is optional
Environment variables
FOXPROFILE_API_TOKENsecret- Token for the API, web panel and MCP. Required when the server listens beyond 127.0.0.1.
Limitations
Requires Python 3.10 or newer, Windows, macOS or Linux, and a few hundred megabytes of disk for Camoufox and the GeoIP database, while the Chrome engine adds 140–190 MB. A profile engine cannot change after creation. The Chrome build trails current Chrome by several versions and a visible window reports the real monitor size. Datacenter IPs get captchas in any browser. The `camoufox_data/` directory holds the cookies of every account and must not be committed or shared. Claude Desktop launches only local MCP servers, so it needs `foxprofile_mcp.py` or the `npx mcp-remote` bridge.
How to disable. Remove the server with `claude mcp remove foxprofile` and stop the app. Profile data lives in `camoufox_data/`; delete that directory by hand.
FAQ
How do I connect FoxProfile to Claude Code?
Start the app with `python -m src.main` and run `claude mcp add --transport http foxprofile http://127.0.0.1:8000/mcp`. For a server add an Authorization header with the token. The Connect AI (MCP) button in the app produces ready configs for each client.
Which tools does the agent see?
Profiles (create, launch, stop), cookies and fingerprints, proxy and IP checks, page actions (navigate, click, type, screenshot, JavaScript) and tabs. There is no profile deletion tool.
Which engines can a profile use?
Camoufox on Firefox by default and Chrome on a fingerprint-chromium build. The engine is chosen at profile creation and cannot change afterwards.
Is a token required?
Not on 127.0.0.1. If the server listens on another address it refuses to start without a `FOXPROFILE_API_TOKEN` of 24 or more characters. One token protects the panel, REST API and MCP.
Which proxies does FoxProfile support?
HTTP, HTTPS, SOCKS4 and SOCKS5 with or without authentication, including the provider format `host:port:user:pass`. The app has a proxy checker and compares the exit IP with the timezone.
Discussion
No questions or reviews yet.
Related
MCP serversCamoFox Browser: anti-detection browser for AI agents
camofox-browser
A REST server and CLI on Camoufox: an agent opens pages with a spoofed browser fingerprint and reads them as an element tree
Anti-Detect Browser Skills (AntiBrow)
Anti-Detect Browser Skills
Four AntiBrow skills: browser profiles with a device fingerprint, an MCP mode for agents and data collection with ready recipes
Official AdsPower skill, CLI and MCP: an agent opens anti-detect browser profiles and manages proxies, groups and tags
An MCP server and Firefox extension that let Claude Code open pages, click, type and take screenshots without Chrome
An MCP server that drives your already open Chrome and stops to ask you about a 2FA code, a CAPTCHA, or a choice only you can make
Browserless.io MCP server: a cloud browser for the agent with page reads, site crawls, Lighthouse audits and click-driven sessions
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| FoxProfile (this card) | no | key is optional | 197 | |
| Anti-Detect Browser Skills (AntiBrow) | yes | 21 | a skill set about anti-detect topics; FoxProfile is a ready app with profiles, a REST API and an MCP server | |
| Playwright MCP | yes | not required | 39,570 | drives a regular browser with no masking; FoxProfile manages profiles with separate fingerprints, proxies and cookies |
README in short
The author presents the project as a self-hosted alternative to paid anti-detect browsers such as GoLogin, GPM and MoreLogin and asks for donations. The README covers a server mode with a web panel for VPS, ZIP profile import and export, filters and bulk actions, and ends with a responsible-use section.