MCP Servers

camofox-browser-mcp

MCP server for controlling a local camofox-browser instance, enabling LLM agents to perform web automation tasks such as navigation, interaction, snapshotting, and content extraction.

README

<h1 align="center">camofox-browser-mcp</h1>

<p align="center"> MCP server for controlling a local camofox-browser instance. </p>

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

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

Navigation and interaction tools

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

Recommended Servers

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official

Featured

TypeScript

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official

Featured

Local

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official

Featured

TypeScript

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official

Featured

Python

E2B

Using MCP to run code via e2b.

Official

Featured

Neon Database

MCP server for interacting with Neon Management API and databases

Official

Featured

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official

Featured

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official

Featured