Skip to main content
Glama

Server Details

Let AI agents observe and control Chrome tabs you explicitly share via Browse Bridge.

Ownership verified
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-03-26
URL
Repository
BryanHamilton/browsebridge-cursor-plugin
GitHub Stars
0
ChatGPT
–
Claude
–

TDQS

A3.7/5.0

Scored across 20 tools

Disambiguation4/5

Each tool maps to a distinct browser action (click, type, select, hover, scroll, press_key, navigate, back/forward, reload) with no true duplicates. The only mild overlap is among the read-only state tools (browser_get_status, browser_list_sessions, browser_get_profile, browser_get_approval), where an agent must reason about which one carries the info it needs, but the descriptions clearly draw the boundaries.

Naming Consistency5/5

Every tool uses the same browser_ prefix with snake_case verb or verb_noun forms (browser_click, browser_get_status, browser_handle_dialog, browser_cancel_approval). The few verb-only names (browser_back, browser_forward, browser_reload) still fit the pattern predictably.

Tool Count4/5

20 tools is on the heavy side but each one covers a genuinely separate capability (navigation, semantic interaction, dialogs, approvals, sessions, quota/status, screenshots). Nothing looks redundant enough to cut, though a few status-related tools could plausibly be consolidated.

Completeness4/5

The surface covers the full delegated-tab lifecycle well: observe, act, navigate, history, dialogs, approval workflow, control release, and session/status introspection. Gaps are minor: no tab creation/close, no file upload or drag, and no raw JS/DOM evaluation, all of which the agent can work around or are intentionally human-only.

Publisher details

Operator
Browse Bridge · Publisher source
Vendor relationship
Not applicable
Privacy policy
Not provided
Trust center
Not applicable
Restrictions
Free + paid plans are available · Publisher source

Available Tools

20 tools
browser_backGo backAInspect

Go back one history entry in the delegated tab. back and forward move exactly one browser history entry. After a cancelled sign-in, the sign-in page can remain in history, so one extra back may be needed to pass it. While a browser sign-in prompt is up, back cancels that prompt and returns the page the tab is actually on. It does not also step history. A history entry that is a form submission returns FORM_RESUBMISSION_REQUIRED and is not reloaded or resubmitted. Use navigate instead. NO_HISTORY_ENTRY means nothing in that direction. ORIGIN_NOT_ALLOWED means an entry exists but is outside the allowed origins or is not a web page; the tab is not moved (recoverable).

Inputs: sessionId (required), idempotencyKey.

browser_cancel_approvalCancel approvalAInspect

Withdraw a pending approval the agent requested. Required: sessionId, approvalId from APPROVAL_REQUIRED or APPROVAL_PENDING. The waiting command fails; this is not a human Deny. An expired approval returns APPROVAL_EXPIRED (recoverable) and is not cancelled. pendingApprovals on browser_get_status does not count that row.

Inputs: sessionId (required), approvalId (required).

browser_clickClick elementA
Destructive
Inspect

Click a semantic element from the latest observation. Required: sessionId, observationId, elementId (the element's id from browser_observe). Optional button: left (default), middle, or right (contextmenu). Uses the DOM click() path; events are not isTrusted. File pickers and similar APIs return ELEMENT_NOT_INTERACTABLE — the human must click. If the click opens a JavaScript alert, confirm, or prompt, it returns promptly with dialog: { type, message, pending: true } and the dialog stays open until browser_handle_dialog or the 30s timeout. Another click, type, or navigation while it is open returns DIALOG_PENDING. A successful click, type, select, press_key, scroll, or navigate invalidates that observationId; reuse returns STALE_OBSERVATION — observe again. A second action on the same session waits up to 5s for the first to finish, then runs. That wait is a per-session FIFO stored with the session, so it still holds when calls land on different server instances. If that wait times out, the call returns BUSY with retryAfterMs. STALE_OBSERVATION means the page changed — observe again. Do not omit observationId. Clicks are paced; RATE_LIMITED means wait retryAfterMs. On a sensitive site the click waits for human Approve in the extension (APPROVAL_REQUIRED, recoverable). Approve runs that click once. The completed success includes that same approvalId and approved: true. A click that did not need approval does not include approvalId. Deny is APPROVAL_DENIED (not recoverable), once per denied grant, not a block until a later Approve. The next click returns that approvalId even when the observation id and element id changed. A different tool is not that denial. A later click may ask again. Turning Sensitive site off cancels pending sensitive-site approvals, and the next call is not APPROVAL_EXPIRED from one of those rows. While that action is waiting, observe/screenshot/wait/get_status/release_control and other same-origin actions on allowed origins still work; retrying the same pending action returns APPROVAL_PENDING. Cancel with browser_cancel_approval. A pending approval expires after ~2 minutes. The next call for that same action or idempotency key returns APPROVAL_EXPIRED (recoverable) with the old approvalId and hint "retry to request a new approval". The retry after that creates a new APPROVAL_REQUIRED. Read one row with browser_get_approval. That wait is not CHALLENGE_DETECTED. Do not retry through CHALLENGE_DETECTED.

Inputs: elementId (required), sessionId (required), observationId (required), button, +1 more.

browser_forwardGo forwardAInspect

Go forward one history entry in the delegated tab. back and forward move exactly one browser history entry. After a cancelled sign-in, the sign-in page can remain in history, so one extra back may be needed to pass it. While a browser sign-in prompt is up, forward does not move the tab and returns HTTP_AUTH_REQUIRED. Call back (cancels the prompt) or navigate elsewhere. NO_HISTORY_ENTRY means nothing in that direction. ORIGIN_NOT_ALLOWED means an entry exists but is outside the allowed origins or is not a web page; the tab is not moved (recoverable).

Inputs: sessionId (required), idempotencyKey.

browser_get_approvalGet approvalA
Read-onlyIdempotent
Inspect

Read one approval. Required: sessionId, approvalId. Returns status pending, approved, denied, expired, cancelled, or consumed, plus commandType, createdAt, resolvedAt, and executionResult or executionError when present. Does not return the action payload. An observationId or any other id that is not an approval in this session is an error, not status expired. Read-only.

Inputs: sessionId (required), approvalId (required).

browser_get_profileGet profileA
Read-onlyIdempotent
Inspect

Return the stable Browse Bridge user id for the signed-in account. If this connector is signed into a different Browse Bridge account than the extension on the same browser, the result is ACCOUNT_MISMATCH with both user ids. Read-only. Does not return email, tokens, cookies, or page content.

Inputs: no named parameters.

browser_get_statusGet session statusB
Read-onlyIdempotent
Inspect

Get control mode and tab status for a session. If this connector is signed into a different Browse Bridge account than the extension on the same browser, the result is ACCOUNT_MISMATCH. Includes the current url, offOrigin when that url is outside allowedOrigins, sensitiveMode, and deviceOnline. sensitiveMode is true when Sensitive site is on: click, type, key, select, and navigation wait for Approve (APPROVAL_REQUIRED), which is not CHALLENGE_DETECTED. The switch stays on for this browser until the user turns it off, including the next tab they Enable, and sensitiveMode matches that switch. When the device heartbeat is stale, controlMode is disconnected and statusUx is SESSION_OFFLINE, not HUMAN_HAS_CONTROL. Includes remaining monthly quota (actionsRemaining, screenshotsRemaining), quotaExceeded, and quotaResetAt (ISO). dialogHook is { installed, error?, rawError? }. error and rawError are the Chrome scripting error, not a rewritten content-script message. statusUx and blocked keep a stable code; rawError is the Chrome string when it differs from the friendly message. statusUx names CHALLENGE_DETECTED, ORIGIN_NOT_ALLOWED, SESSION_OFFLINE, or HUMAN_HAS_CONTROL when the human must take over. CONTENT_SCRIPT_UNAVAILABLE is returned from tools if the agent is not on the tab. EXTENSION_RECONNECT_NEEDED means click Reconnect in the side panel, then retry. While a JavaScript dialog is open, dialog is { type, message, pending: true } and blocked.code stays JS_DIALOG_OPEN. A native HTTP sign-in prompt is HTTP_AUTH_REQUIRED in blocked and statusUx, with dialog null. The user answers or cancels it. Browse Bridge does not enter the username or password. Navigate, back, forward, and reload can leave that prompt. A timeout while that dialog is open is DIALOG_PENDING, not CONTENT_SCRIPT_UNAVAILABLE. In Agent mode, alert/confirm/prompt stay pending until browser_handle_dialog. They are not dismissed when they open. QUOTA_EXCEEDED names which quota (actions or screenshots) and resetAt. extensionVersion is the connected extension, sent on the WebSocket handshake and the first auth frame. meetsExtensionMinimum and meetsLatestExtension compare it with extensionMinVersion and latestExtensionVersion.

Inputs: sessionId (required).

browser_handle_dialogHandle JavaScript dialogA
Destructive
Inspect

Accept or dismiss the JavaScript dialog that is pending on the shared tab. action is accept or dismiss. promptText (max 2000 characters) is sent only when accepting a prompt; on alert or confirm it is ignored and the result includes a warning. With no pending dialog the call returns NO_DIALOG. Two calls at once: the first resolves the dialog and the other returns NO_DIALOG. If nothing resolves the dialog within 30s it is dismissed and History records Dismissed a dialog (timeout). Uses Page.javascriptDialogOpening and Page.handleJavaScriptDialog. Does not click, type, or capture the page.

Inputs: sessionId (required), action, promptText.

browser_hoverHover elementAInspect

Hover a semantic element from the latest observation (mouseover/mouseenter). Required: sessionId, observationId, elementId. Re-reads visible text and returns textSummary including newly visible caption/tooltip text (for example name: user1 on /hovers). That revealed text is only on this result. The next browser_observe does not include it, because the synthetic hover is not kept on the page. Hidden captions are omitted before hover. Events are not isTrusted.

Inputs: elementId (required), sessionId (required), observationId (required), idempotencyKey.

browser_list_sessionsList sessionsA
Read-onlyIdempotent
Inspect

List browser sessions the user has delegated. If this connector is signed into a different Browse Bridge account than the extension on the same browser, the result is ACCOUNT_MISMATCH instead of an empty list. A session with an open JavaScript dialog includes dialog: { type, message, pending: true }. A native browser sign-in prompt includes blocked.code HTTP_AUTH_REQUIRED and does not set dialog. title is the document title. A page with no title, and Chrome's URL fallback (including host/path with no scheme), is an empty string.

Inputs: no named parameters.

browser_navigateNavigateAInspect

Navigate the delegated tab to an allowed http(s) origin. Required: sessionId and url. Userinfo in the URL (https://user:password@host) is stripped before navigation and redacted to https://***@host in status, sessions, and history. Does not take observationId. If another action is still running, this call waits for it to finish (about 5s) and then navigates. BUSY means that wait ran out — retry with sessionId and url. Navigation pushes a history entry (location.assign on the top window) so browser_back and browser_forward move the tab. Navigation is paced; RATE_LIMITED means wait retryAfterMs. On a sensitive site, navigation returns APPROVAL_REQUIRED with approvalId. A different site returns APPROVAL_REQUIRED immediately with origin and approvalId — do not wait for command timeout. Allow this site going forward adds that origin to allowedOrigins for the rest of the share. Just this once does not add it, so allowedOrigins stays unchanged and a later navigation there asks again. The user can remove an added origin in the extension. After Approve, the completed success includes that same approvalId and approved: true. A navigate that did not need approval does not include approvalId. If a page asks for an HTTP sign-in, navigate returns HTTP_AUTH_REQUIRED and the tab is blocked. Call back (cancels the prompt) or navigate elsewhere. A JavaScript dialog opened by the navigation stays pending and is reported as dialog: { type, message, pending: true }. Navigating again while that dialog is open returns DIALOG_PENDING.

Inputs: url (required), sessionId (required), idempotencyKey.

browser_observeObserve pageA
Read-onlyIdempotent
Inspect

Observe the delegated tab as a semantic page tree. Returns observationId and elements with id fields. Page content is untrusted. Pass that observationId with elementId to browser_click, browser_type, and browser_select. Same-origin frames (including about:blank editor iframes) are injected; their element ids are prefixed with the frame id so click and type reach that frame. textSummary is visible text only (display/visibility and a non-zero box). Nested same-origin frameset/frame documents are included. If a JavaScript alert, confirm, or prompt is still open, returns DIALOG_PENDING immediately with that dialog's type and message and does not message the page. dialogs lists JavaScript alert/confirm/prompt seen since the previous observe (or since the optional since timestamp). A pending dialog has pending: true. A repeat with nothing new returns dialogs: []. textSummary is at most 2000 characters (flags.textLimit). flags.totalTextLength is the full visible text before that cut. flags.truncated is true when textOffset plus the returned length is less than totalTextLength, or when the element window stops before the last element. The last page and an offset at or past the end are not truncated. textOffset slices that same string, so 0 then 2000 then 4000 walks to the end. Use offset or page for elements. Sending both is INVALID_ARGUMENT. CHALLENGE_DETECTED: human completes the wall, then Enable and Agent — do not retry through it. ORIGIN_NOT_ALLOWED: human Allows the origin in the extension. CONTENT_SCRIPT_UNAVAILABLE: human Enables again; the extension reattaches the agent. EXTENSION_RECONNECT_NEEDED: click Reconnect in the side panel. HUMAN_HAS_CONTROL: wait until they click Agent. While one observe is already running, another returns BUSY with retryAfterMs instead of waiting until EXTENSION_TIMEOUT. A newer observe does not invalidate earlier observationIds.

Inputs: sessionId (required), page, offset, textOffset, +2 more.

browser_press_keyPress keyA
Destructive
Inspect

Press a keyboard key in the delegated tab. Supported keys: letters, digits, space, Enter, Tab, Escape, Backspace, Delete, ArrowUp, ArrowDown, ArrowLeft, ArrowRight, Home, End, PageUp, PageDown, Insert, F1–F12, and one other character such as ü. Distinct modifiers may prefix one key in any order (Shift+Control+ArrowLeft, Control+Shift+A, Control+Alt+Delete, Meta+c). Control and Ctrl are the same modifier. A repeated modifier is INVALID_ARGUMENT ("Duplicate modifier: Shift", "Duplicate modifier: Control"). An unknown token is INVALID_ARGUMENT ("Unknown key: Nope"). An empty part ("Shift+", "+A") or a modifier with no key (Shift, Shift+Control) is INVALID_ARGUMENT ("Chord is missing a key"). Those checks run before the tab is touched. Modifier chords do not insert text. elementId requires observationId (INVALID_ARGUMENT otherwise). Without elementId, the key goes to the focused element and the result includes target: { tag, id? }. A successful browser_type leaves focus on that field, so the next key without elementId reaches it. Tab and Shift+Tab move focus when the page does not cancel the key. A password, current-password, new-password, one-time-code, or cc-number field returns HUMAN_INPUT_REQUIRED for printable characters, Backspace, Delete, and Insert, and does not change the field. Tab, Enter, and Escape are still sent. ArrowUp and ArrowDown change input[type=number]. Text a number, date, time, or color input cannot hold returns INVALID_INPUT_VALUE and does not set the value. A non-ASCII character is inserted as text only on a field the agent may edit. Events are not isTrusted. Key presses are paced; RATE_LIMITED means wait retryAfterMs. On a sensitive site, press_key returns APPROVAL_REQUIRED with approvalId. After Deny, the next press_key returns APPROVAL_DENIED with that approvalId once, even with a new element id. A later key may ask again. After Approve, the completed success includes that same approvalId and approved: true. A key that did not need approval does not include approvalId.

Inputs: key (required), sessionId (required), elementId, observationId, +1 more.

browser_release_controlRelease controlB
Idempotent
Inspect

Return control of the tab to the human. Succeeds with { controlMode: "human" }. Works while an approval is pending. This is not HUMAN_HAS_CONTROL.

Inputs: sessionId (required).

browser_reloadReload pageCInspect

Reload the delegated tab.

Inputs: sessionId (required), idempotencyKey.

browser_screenshotScreenshot tabA
Read-onlyIdempotent
Inspect

Returns a JPEG image of the visible shared tab as MCP image content (type image, mimeType image/jpeg, data as base64). The text part is a small JSON object with observationId, width, and height — not the image bytes. Capture runs only when the tab origin is in allowedOrigins; a different origin is ORIGIN_NOT_ALLOWED and no image is taken. Site access for that origin is enough: if captureVisibleTab still requires the literal <all_urls> pattern, the tab is captured in the background and the debugger is detached. CAPTURE_PERMISSION_MISSING means Enable or Reconnect and allow the Chrome permission prompt. A failed screenshot does not reduce screenshotsRemaining. Rapid screenshots return RATE_LIMITED with retryAfterMs — wait, do not burst.

Inputs: sessionId (required), reason.

browser_scrollScroll pageAInspect

Scroll the page or a semantic element into view. Pass direction (up, down, left, right), deltaX, deltaY, x, y, or elementId. elementId requires observationId (INVALID_ARGUMENT "observationId (Required)" otherwise). A call with none of those is INVALID_ARGUMENT. deltaX, deltaY, x, and y must be between -100000 and 100000.

Inputs: sessionId (required), x, y, amount, +6 more.

browser_selectSelect optionA
Destructive
Inspect

Select a value on a . Required: sessionId, observationId, elementId, value. value must match an or a unique option label. A non-select element returns WRONG_ELEMENT_TYPE with the actual tag and role. Unknown values return INVALID_SELECT_VALUE and do not change the select. A disabled option, including a placeholder such as Please select an option, returns OPTION_DISABLED and does not change the select. A failure before the page changes keeps the observation valid. STALE_OBSERVATION means observe again and retry. On a sensitive site, select returns APPROVAL_REQUIRED with approvalId and does not change the control until Approve. Approve runs that select once. The completed success includes that same approvalId and approved: true. A select that did not need approval does not include approvalId. After Deny, the next select of that value returns APPROVAL_DENIED with that approvalId once, even when the observation id and element id changed. A different value asks for a new approval. A later select of the same value may ask again. While it is still pending, the same element and value returns APPROVAL_PENDING.

Inputs: value (required), elementId (required), sessionId (required), observationId (required), +1 more.

browser_typeType into elementA
Destructive
Inspect

Type into a text field, textarea, or contenteditable from the latest observation. A non-editable element (editable: false, such as a submit button) returns ELEMENT_NOT_INTERACTABLE and does not change the page. length is the number of Unicode code points. A number, date, time, week, month, or color input that cannot hold the text returns INVALID_INPUT_VALUE and does not set the value. The typed value is not stored in the audit log. Events are not isTrusted; Browse Bridge does not spoof that flag. On a sensitive site, type returns APPROVAL_REQUIRED with approvalId. After Deny, the next type returns APPROVAL_DENIED with that approvalId once, even when the new observation has a new element id. Typed text is not part of that match. A later type may ask again. After Approve, the completed success includes that same approvalId and approved: true. A type that did not need approval does not include approvalId. Password fields return HUMAN_INPUT_REQUIRED — the human types that value; there is no Approve that types a password.

Inputs: text (required), elementId (required), sessionId (required), observationId (required), +2 more.

browser_waitWaitA
Read-onlyIdempotent
Inspect

Wait briefly for page activity. ms (or durationMs) must be 0–30000; negative values are INVALID_ARGUMENT. Values above 30000 are INVALID_ARGUMENT. Sending both ms and durationMs is INVALID_ARGUMENT. The result reports waitedMs and clamped. clamped is true only when the requested ms was reduced, and then the result includes requestedMs and reason (for example the command timeout budget). A value inside 0–30000 that finishes is not clamped. The call is allowed 35 seconds so a 30000 ms wait does not return EXTENSION_TIMEOUT. If urlIncludes is set and the tab URL does not contain it before the wait ends, the call returns TIMEOUT. After release_control, wait returns HUMAN_HAS_CONTROL even if a JavaScript dialog is still open. While the agent has control and a JavaScript dialog is open, wait returns DIALOG_PENDING. A second release returns ALREADY_RELEASED.

Inputs: sessionId (required), ms, durationMs, urlIncludes.

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 MCP-compatible AI agents to securely control Chrome tabs via a local bridge, with explicit per-tab sharing and human approval for consequential actions.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to request and receive user-granted, short-lived access to a single tab in the user's existing Chromium-based browser, then read, highlight, scroll, and navigate within that granted page without exposing other tabs or copying the browser profile.
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to control and automate your Chrome browser directly, leveraging existing login states and configurations for tasks like content analysis, semantic search across tabs, screenshots, network monitoring, and interactive operations.
      13
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.