Arc Control (macOS) MCP Server

by db-25io.github.DB-25/arc-control-mcpv0.4.0

Arc browser MCP for macOS: agent window, snapshots, DevTools input, guardrails

1Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active4d ago

Install Arc Control (macOS) MCP server

claude mcp add arc-control -- npx -y arc-control-mcp

{
  "mcpServers": {
    "arc-control": {
      "command": "npx",
      "args": [
        "-y",
        "arc-control-mcp"
      ]
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "arc-control": {
      "command": "npx",
      "args": [
        "-y",
        "arc-control-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "arc-control": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "arc-control-mcp"
      ]
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "arc-control": {
      "command": "npx",
      "args": [
        "-y",
        "arc-control-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
ARC_MCP_LABEL	—	—	Names this agent's tab ownership. Two agents with different labels never see each other's owned tabs. Defaults to "default".
ARC_MCP_SPACE	—	—	With ARC_MCP_WINDOW=space, the Arc space new tabs open into, when a space with that name exists. Arc will not let a script create a space, so make it by hand. Defaults to "Agent".
ARC_MCP_STATE_DIR	—	—	Directory where per-session tab ownership is recorded, so a restarted agent can clean up the tabs its previous run left behind. Defaults to ~/Library/Application Support/arc-control-mcp.
ARC_MCP_WINDOW	—	—	"dedicated" keeps agent tabs in one separate agent window, never the user's own. "space" puts them in the Agent space of the user's window. Defaults to "dedicated".
ARC_MCP_WINDOW_PLACEMENT	—	—	Where the agent window goes once, at creation: "auto" (largest non-main display, else where Arc puts it), "second-display", "minimized" (experimental) or "none". Needs Accessibility. Defaults to "auto".
ARC_MCP_IDLE_MS	—	—	How many milliseconds the user must have been idle before the server does anything visible. 0 turns the activity gate off. Defaults to 1500.
ARC_MCP_IDLE_WAIT_MS	—	—	How many milliseconds to wait for that pause before failing with userActive true. Defaults to 15000.
ARC_MCP_ARC_DATA_DIR	—	—	Directory the local data tools (sidebar_tree, find_stale_tabs, search_archive, search_history) read Arc's files from. Defaults to ~/Library/Application Support/Arc.
ARC_MCP_ALLOW_HISTORY	—	—	Set to 1 to let search_history run. Off by default, and any other value leaves it off.
ARC_MCP_CDP	—	—	Set to 0 to disable the DevTools engine (trusted input, screenshots, console and network capture). On by default, and inert until Arc is launched with --remote-debugging-port.
ARC_MCP_CDP_PORT	—	—	The DevTools port to probe on 127.0.0.1. The host is fixed. Defaults to 9222.
ARC_MCP_ALLOWED_ORIGINS	—	—	Guardrail. Comma list of origins the agent may touch (host, *.host, scheme://host[:port], file://, about:). Anything not listed is refused. Unset means no allow list.
ARC_MCP_BLOCKED_ORIGINS	—	—	Guardrail. Comma list of origins the agent may not touch. Wins over the allow list. Unset means no block list.
ARC_MCP_BLOCK_READS	—	—	Set to 1 to apply the origin lists to read tools as well as changing ones. Off by default.
ARC_MCP_READ_ONLY	—	—	Set to 1 to expose only the read-only tools. Off by default.
ARC_MCP_AUDIT_LOG	—	—	Path of a file that gets one JSON line per changing call (time, tool, tab, origin, ok, error), never typed values or script code. Unset means no audit log.