Provides stealthy browser automation capabilities using a custom Firefox build (Camoufox), enabling tools for website navigation, element interaction, session management, and capturing page snapshots or screenshots.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Camoufox Browser MCP Navigate to news.ycombinator.com and take a screenshot"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A Model Context Protocol (MCP) server designed to provide stealthy web browsing capabilities (anti-detection) to AI agents using the Camoufox engine.
Enable AI agents (such as Claude, GPT, etc.) to interact with the modern web without being blocked, maintaining persistent sessions and allowing detailed visual and structural inspection of content.
Related MCP server: camoufox-mcp
🕵️ Advanced Stealth: Engine based on Camoufox (custom Firefox) with C++ level fingerprint spoofing.
🔗 Session Management: Hash-based system to maintain multiple independent and persistent navigation contexts.
📸 Dual Screenshots: Returns screenshots in Base64 directly to the agent and optionally saves them to local files.
🛠️ Interaction Tools: Navigation, clicks, text typing, scrolling, and link extraction.
🐳 Docker Native: Optimized container with all necessary system dependencies to run browsers in headless mode.
Tool | Description |
| Navigates to a URL and creates/reuses a persistent session. |
| Performs actions like |
| Converts current page to Markdown for AI token efficiency. |
| Extracts all links and their descriptive text from the current page. |
| Captures the current view (Base64 + optional file). |
| Retrieves the raw HTML content of the session. |
| Lists the hashes of all active sessions. |
Docker and Docker Compose.
Python 3.11+ (to run test scripts).
# Clone and start
git clone https://github.com/danielmiranda/camoufox-browser-mcp.git
cd camoufox-browser-mcp
docker-compose up --build -dAdd the following to your configuration file:
{
"mcpServers": {
"camoufox-browser": {
"command": "docker",
"args": ["exec", "-i", "camofox-mcp", "python", "src/mcp_server.py"]
}
}
}We have included example scripts to verify integration:
General Test: python examples/test_mcp_docker.py (Simulates full agent flow).
ScrapingBee Test: python examples/scrapingbee_test.py (Navigates, lists links, and performs clicks).
Resource Consumption: Since it manages persistent sessions, memory usage can scale with many open tabs.
Headless Mode: Some websites specifically detect headless rendering despite advanced spoofing (though Camoufox minimizes this).
Network: Loading speed depends entirely on the Docker host's connectivity.
AI-Optimized Markdown: Tool to extract web content directly as Markdown (token saving).
Accessibility Tree tools: Tools to interact based on accessibility roles instead of CSS selectors.
Proxy Rotation: Integrated proxy management for each hashed session.
Captcha Solving: Integration with captcha solving services for fully autonomous flows.
Built with ❤️ for the AI Agent community.
This server cannot be deployed
Stealth web automation for AI agents. Login, signup, navigate, screenshot.
Stealth web automation for AI agents. Login, signup, navigate, screenshot.
Undetectable cloud browser sessions for AI agents and scrapers. Navigate, extract, click, captcha.
Stealth web browser for agents: search, fetch, click, download and type in persistent MCP sessions.