Which integrations are available for this server?

Allows searching Amazon via the web_search tool. Allows searching Google via the web_search tool. Allows searching Instagram via the web_search tool. Allows searching Netflix via the web_search tool. Allows searching Reddit via the web_search tool. Allows searching Spotify via the web_search tool. Allows searching TikTok via the web_search tool. Allows searching Twitch via the web_search tool. Allows searching Wikipedia via the web_search tool. Allows searching Yelp via the web_search tool. Allows searching YouTube via the web_search tool and extracting video transcripts via the camofox_youtube_transcript tool.

How do I use camofox-browser-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@camofox-browser-mcp search for MCP protocol overview" 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.

camofox-browser-mcp

by Microck

Overview Schema Source Related Servers Discussions Admin

TypeScript

Local

quick installation

paste this into your llm agent session:

Install and configure camofox-browser-mcp by following the instructions here:
https://raw.githubusercontent.com/Microck/camofox-browser-mcp/refs/heads/main/INSTALL.md

npm (recommended)

npm install -g camofox-browser-mcp

MCP server for controlling a local jo-inc/camofox-browser instance.

This server exposes the full practical camofox-browser workflow to LLM agents: tab lifecycle, navigation, interaction, snapshots, screenshots, links, stats, cookie import, session cleanup, YouTube transcript extraction, and high-level composite helpers (navigate_and_snapshot, scroll_and_snapshot, fill_form, type_and_submit, batch_click, web_search).

Prerequisites

Node.js 22+ (required for the npm package)
Optional: Bun (recommended for local development): https://bun.sh/docs/installation
A running camofox-browser server (default http://127.0.0.1:9377)
Optional, depending on tools used:
- CAMOFOX_API_KEY for cookie import
- CAMOFOX_ADMIN_KEY for browser stop endpoint

Related MCP server: Browser Jet Pilot

Installation

Local development checkout

git clone https://github.com/Microck/camofox-browser-mcp.git
cd camofox-browser-mcp
bun install
bun run typecheck
bun run build

npm package

npm install -g camofox-browser-mcp

# optional smoke-run (most users just configure their MCP client)
camofox-browser-mcp

Configuration

Set these environment variables in your MCP client config.

Variable	Required	Default	Purpose
`CAMOFOX_BASE_URL`	yes	`http://127.0.0.1:9377`	Base URL of running camofox-browser server
`CAMOFOX_URL`	alias	unset	Compatibility alias for `CAMOFOX_BASE_URL`
`CAMOFOX_TIMEOUT_MS`	no	`30000`	HTTP timeout for camofox calls
`CAMOFOX_TIMEOUT`	alias	unset	Compatibility alias for `CAMOFOX_TIMEOUT_MS`
`CAMOFOX_DEFAULT_USER_ID`	no	`default-user`	Default `userId` when omitted
`CAMOFOX_DEFAULT_SESSION_KEY`	no	`default-session`	Default `sessionKey` when omitted
`CAMOFOX_API_KEY`	for `camofox_import_cookies`	unset	Bearer key for `/sessions/:userId/cookies`
`CAMOFOX_ADMIN_KEY`	for `camofox_stop_browser`	unset	Admin key sent as `x-admin-key` for `/stop`
`CAMOFOX_AUTOSTART_SERVER`	no	`true`	When baseUrl is localhost and server is unreachable, try to spawn `camofox-browser` automatically
`CAMOFOX_AUTOSTART_COMMAND`	no	`camofox-browser`	Command used to spawn the camofox-browser HTTP server
`CAMOFOX_AUTOSTART_TIMEOUT_MS`	no	`15000`	Max time to wait for the spawned server to answer `/health`

Example MCP config (local build)

{
  "mcpServers": {
    "camofox-browser-mcp": {
      "command": "bun",
      "args": ["/absolute/path/to/camofox-browser-mcp/dist/index.js"],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio",
        "MCP_LOG_LEVEL": "info",
        "CAMOFOX_BASE_URL": "http://127.0.0.1:9377",
        "CAMOFOX_DEFAULT_USER_ID": "default-user",
        "CAMOFOX_DEFAULT_SESSION_KEY": "default-session",
        "CAMOFOX_API_KEY": "",
        "CAMOFOX_ADMIN_KEY": ""
      }
    }
  }
}

Tool coverage

The MCP toolset maps to camofox-browser endpoints and includes compatibility aliases for common camofox-mcp prompts.

Server and session tools

MCP tool	Endpoint	Notes
`camofox_health`	`GET /health`	Runtime and browser status
`server_status`	alias of `camofox_health`	Compatibility alias
`camofox_start_browser`	`POST /start`	Starts browser engine
`camofox_stop_browser`	`POST /stop`	Requires admin key
`camofox_close_session`	`DELETE /sessions/:userId`	Closes all tabs/context for user
`camofox_import_cookies`	`POST /sessions/:userId/cookies`	Requires API key

Tab lifecycle tools

MCP tool	Endpoint	Notes
`camofox_list_tabs`	`GET /tabs`	Lists open tabs by user
`list_tabs`	alias of `camofox_list_tabs`	Compatibility alias
`camofox_create_tab`	`POST /tabs`	Creates tab with optional URL
`create_tab`	alias of `camofox_create_tab`	Compatibility alias
`camofox_close_tab`	`DELETE /tabs/:tabId`	Closes one tab
`close_tab`	alias of `camofox_close_tab`	Compatibility alias
`camofox_close_tab_group`	`DELETE /tabs/group/:listItemId`	Closes all tabs in group
`camofox_get_stats`	`GET /tabs/:tabId/stats`	Usage stats and visited URLs

MCP tool	Endpoint	Notes
`camofox_navigate_tab`	`POST /tabs/:tabId/navigate`	URL or macro navigation
`navigate`	alias of `camofox_navigate_tab`	Compatibility alias
`navigate_and_snapshot`	composite	Navigate, wait, then snapshot
`camofox_wait`	`POST /tabs/:tabId/wait`	Wait for page readiness
`camofox_wait_for_text`	`POST /act` (`kind=wait`)	Wait for text appearance
`camofox_get_snapshot`	`GET /tabs/:tabId/snapshot`	Ref-based accessibility snapshot
`snapshot`	alias of `camofox_get_snapshot`	Compatibility alias
`scroll_and_snapshot`	composite	Scroll, then snapshot
`camofox_click`	`POST /tabs/:tabId/click`	Click by ref or selector
`batch_click`	composite	Execute multiple clicks sequentially
`camofox_type`	`POST /tabs/:tabId/type`	Type text by ref/selector
`type_text`	alias of `camofox_type`	Compatibility alias
`type_and_submit`	composite	Type then press submit key
`fill_form`	composite	Fill multiple fields + optional submit click
`camofox_hover`	`POST /act` (`kind=hover`)	Hover by ref or selector
`camofox_press`	`POST /tabs/:tabId/press`	Keyboard press
`camofox_scroll`	`POST /tabs/:tabId/scroll`	Vertical scroll
`camofox_scroll_element`	`POST /act` (`kind=scrollIntoView`)	Scroll referenced element into view
`camofox_back`	`POST /tabs/:tabId/back`	History back
`go_back`	alias of `camofox_back`	Compatibility alias
`camofox_forward`	`POST /tabs/:tabId/forward`	History forward
`go_forward`	alias of `camofox_forward`	Compatibility alias
`camofox_refresh`	`POST /tabs/:tabId/refresh`	Page reload
`refresh`	alias of `camofox_refresh`	Compatibility alias
`camofox_get_links`	`GET /tabs/:tabId/links`	Extract page links
`camofox_screenshot`	`GET /tabs/:tabId/screenshot`	Returns base64 PNG
`web_search`	macro wrapper around `navigate`	Multi-engine search helper

Content extraction tools

MCP tool	Endpoint	Notes
`camofox_youtube_transcript`	`POST /youtube/transcript`	Extracts YouTube captions

Supported web_search engines

web_search maps engine values to backend macros:

google, youtube, amazon, reddit, wikipedia, twitter, yelp
spotify, netflix, linkedin, instagram, tiktok, twitch

Compatibility notes

list_profiles, save_profile, load_profile, and delete_profile are not exposed yet because current jo-inc/camofox-browser APIs do not provide cookie export/profile endpoints.

Typical workflow

camofox_start_browser
camofox_create_tab (or camofox_list_tabs + reuse)
camofox_navigate_tab
camofox_get_snapshot
Interact with refs: camofox_click, camofox_type, camofox_press, camofox_scroll
Re-run camofox_get_snapshot after major page changes
Cleanup with camofox_close_tab or camofox_close_session

Macro support

camofox_navigate_tab passes macro and query through to camofox-browser. Upstream macros include:

@google_search
@youtube_search
@amazon_search
@reddit_search
@reddit_subreddit
@wikipedia_search
@twitter_search
@yelp_search
@spotify_search
@netflix_search
@linkedin_search
@instagram_search
@tiktok_search
@twitch_search

Troubleshooting

camofox_health fails: check CAMOFOX_BASE_URL and confirm backend is running.
camofox_import_cookies 403: set CAMOFOX_API_KEY in both backend and MCP env.
camofox_stop_browser 403: set CAMOFOX_ADMIN_KEY in both backend and MCP env.
Missing refs after navigation: call camofox_get_snapshot again.

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessUnresponsive

Resources

Need Help?

Related Servers

Related MCP Connectors

JxBrowser MCP Server A
io.github.TeamDev-IP
MCP server to assist with JxBrowser development.
Developer Tools Browser Automation
22
Hyperbrowser
io.github.pipeworx-io
Hyperbrowser MCP — wraps the Hyperbrowser AI-agent browsing API
1
Aginx Browser A
net.aginx
Stealth web browser for agents: search, fetch, click, download and type in persistent MCP sessions.
Browser Automation Agent Orchestration
37119
MESSORA A
dev.messora
Scrape, crawl and search the web for AI agents via MCP.
Web Scraping Browser Automation Search
51

Related MCP Servers

scout-mcp-server
Browser Automation Web Scraping
stemado
A
license
A
quality
B
maintenance
MCP server for browser automation with anti-detection. Scout pages, find elements, interact with websites, and monitor network traffic from any AI client that supports the Model Context Protocol.
Updated 4 months ago (2026-05-20 13:17 UTC)
21
1
MIT
Browser Jet Pilot
Browser Automation Web Scraping Autonomous Agents
0xABADBABE-ops
A
license
A
quality
D
maintenance
Self-hosted MCP server for AI browser automation. Connects to your own Chromium instance via CDP, providing tools for browser control, navigation, interaction, and content extraction.
Updated 2 months ago (2026-07-10 09:40 UTC)
19
1
MIT
camofox-mcp
tonjun
A
license
B
quality
A
maintenance
A stdio MCP server that bridges the camofox-browser anti-detection browser automation API as MCP tools, with built-in SSRF and prompt injection protections.
Updated a month ago (2026-08-04 06:47 UTC)
33
17 npm
1
MIT
mcp-server-agent-browser
Browser Automation Agent Orchestration
codeChap
F
license
Not graded
quality
C
maintenance
MCP server that wraps agent-browser to let LLMs control a real browser, providing tools for navigation, interaction, reading page content, accessibility snapshots, screenshots, and session management.
Updated 19 days ago (2026-08-26 15:45 UTC)
1
-