Skip to main content
Glama

Browsing

Browsing is the repository for the supervised browser/web capability consumer in the canonical MCP workspace. The runtime/service compatibility identifier remains browser-mcp.

It provides browser/form domain semantics while Console MCP remains the ChatGPT-facing connector and generic execution/runtime owner.

Canonical role

Browser MCP owns:

  • target/page/form inspection;

  • semantic form extraction;

  • verified field mutations;

  • guarded artifact upload;

  • review and submit domain policy;

  • human-boundary detection;

  • browser-domain evidence and statuses.

Console MCP owns:

  • browser runtime/process lifecycle;

  • ChatGPT-facing tool gateway;

  • generic task/run identity;

  • async execution, leases, capacity, retry, timeout, and cancellation.

The local mcp-server remains a compatibility/local-validation surface. It is not the canonical ChatGPT-facing connector.

Related MCP server: nomos-browser

Current supervised flow

  1. Console binds or opens the browser target.

  2. Web captures exact target/page/form identity.

  3. Web extracts semantic controls.

  4. Values/actions are proposed.

  5. Approval-gated mutations are applied.

  6. Web verifies each supported postcondition.

  7. Files are uploaded only through guarded artifact references.

  8. A review artifact is captured.

  9. Final submit remains disabled by default and requires explicit approval when enabled.

  10. Web returns verified or explicitly unverified terminal evidence.

Safety defaults

  • Web must not launch a competing browser in Console-owned mode.

  • Credentials remain manual.

  • CAPTCHA, 2FA, login/security challenges pause automation as human boundaries.

  • Form mutations use target/page/form revision guards.

  • Password fields are not writable.

  • Uploads accept only guarded relative artifact references inside the dedicated upload root.

  • Form values and credential material are not logged by default.

  • Unrelated browser tabs/processes must not be closed.

Policy defaults

BROWSER_MCP_MODE=local-assist
BROWSER_MCP_REQUIRE_APPROVAL_FOR_FILL=true
BROWSER_MCP_REQUIRE_APPROVAL_FOR_UPLOAD=true
BROWSER_MCP_REQUIRE_APPROVAL_FOR_SUBMIT=true
BROWSER_MCP_UPLOAD_ROOT=var\artifacts\uploads
BROWSER_MCP_MAX_UPLOAD_BYTES=26214400
BROWSER_MCP_WORKER_PORT=8791
BROWSER_MCP_BROWSER_CHANNEL=msedge
BROWSER_MCP_EXTERNAL_VISIBLE_BROWSER=true

Capability contract

The machine-readable source of truth is:

mcp-server/src/capability-contract.js

It defines Console/Web ownership, risk classes, approvals, binding, replay policy, timeout class, artifact behavior, postconditions, visibility, and compatibility aliases.

Local validation

Windows:

cd D:\PhpstormProjects\www\mcp\Browsing
npm run typecheck
npm run test

Ubuntu/Linux after a normal clone:

npm ci
npm --prefix mcp-server ci
npm --prefix playwright-worker ci
npm --prefix playwright-worker run install:browsers
npm run typecheck
npm run test

For the canonical supervised runtime, point BROWSER_MCP_REMOTE_DEBUGGING_PORT at the Console-owned CDP endpoint (normally 9223) and keep BROWSER_MCP_EXTERNAL_VISIBLE_BROWSER=true. The CDP attach path is supported on Windows and Linux. Windows-only dev:* supervisor scripts remain compatibility/operations helpers rather than a runtime requirement.

Operational lifecycle commands remain available for compatibility/local validation, but normal browser ownership belongs to Console MCP.

Documentation

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables a single user to let ChatGPT read and control a dedicated Chromium browser running on their own server, with tab, navigation, and browser-action tools plus manual approval safeguards.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables an AI agent to interact with the user's current Firefox or Chromium browser under per-site policies, allowing it to list tabs, read pages, take screenshots, fill fields, and click with user confirmation.
      AGPL 3.0