Hosting

local (stdio by default); optional local HTTP/SSE modes

Transport

stdio; Streamable HTTP; SSE

Endpoint

Local process; no hosted endpoint documented

Authentication

No authentication is required for the default local stdio process. The repository documents local HTTP/SSE modes but no hosted service endpoint or authentication.

Requirements

• Node.js >=18
• npm/npx
• Playwright browser binaries; README recommends npx playwright install
• System dependencies for browsers may be needed; README documents npx playwright install-deps

Setup steps

1. Install/use the package with Node.js 18+: npx -y -p mcp-macaco-playwright macacoai-playwright-mcp. Package metadata maps the macacoai-playwright-mcp executable to cli.js; with no --port the source starts stdio transport.
2. Install browser binaries as needed with npx playwright install. Linux environments may need npx playwright install-deps.
3. Add the command and arguments to the MCP client's local stdio configuration.
4. Default browser launch is headed except on Linux without DISPLAY, where it is headless; use documented CLI flags such as --headless, --browser, --cdp-endpoint, or --caps only when needed.
5. For remote/HTTP mode, the repository supports selecting a port, which starts HTTP transports. This runs a server locally; do not use an endpoint from unrelated examples as a hosted production service.
6. Verify with a harmless browser navigation to a public page. Browser interaction and arbitrary page JavaScript should be treated as privileged actions.

33 exact function names were captured from the public README reference. README claims 50+ functions and does not establish that the listed reference is a complete, current runtime tool catalog; count is a documented partial list, not total tools.

• browser_navigate

  Documented in the repository function reference; see README for the exact parameters and limitations.

  01
• browser_navigate_back

  Documented in the repository function reference; see README for the exact parameters and limitations.

  02
• browser_navigate_forward

  Documented in the repository function reference; see README for the exact parameters and limitations.

  03
• browser_snapshot

  Documented in the repository function reference; see README for the exact parameters and limitations.

  04
• browser_take_screenshot

  Documented in the repository function reference; see README for the exact parameters and limitations.

  05
• browser_click

  Documented in the repository function reference; see README for the exact parameters and limitations.

  06
• browser_double_click

  Documented in the repository function reference; see README for the exact parameters and limitations.

  07
• browser_right_click

  Documented in the repository function reference; see README for the exact parameters and limitations.

  08
• browser_type

  Documented in the repository function reference; see README for the exact parameters and limitations.

  09
• browser_press_key

  Documented in the repository function reference; see README for the exact parameters and limitations.

  10
• browser_select_option

  Documented in the repository function reference; see README for the exact parameters and limitations.

  11
• browser_check_checkbox

  Documented in the repository function reference; see README for the exact parameters and limitations.

  12
• browser_select_radio

  Documented in the repository function reference; see README for the exact parameters and limitations.

  13
• browser_clear_input

  Documented in the repository function reference; see README for the exact parameters and limitations.

  14
• browser_get_text

  Documented in the repository function reference; see README for the exact parameters and limitations.

  15
• browser_get_elements

  Documented in the repository function reference; see README for the exact parameters and limitations.

  16
• browser_scroll_to

  Documented in the repository function reference; see README for the exact parameters and limitations.

  17
• browser_focus_element

  Documented in the repository function reference; see README for the exact parameters and limitations.

  18
• browser_blur_element

  Documented in the repository function reference; see README for the exact parameters and limitations.

  19
• browser_wait_for

  Documented in the repository function reference; see README for the exact parameters and limitations.

  20
• browser_tab_list

  Documented in the repository function reference; see README for the exact parameters and limitations.

  21
• browser_tab_new

  Documented in the repository function reference; see README for the exact parameters and limitations.

  22
• browser_tab_close

  Documented in the repository function reference; see README for the exact parameters and limitations.

  23
• browser_tab_select

  Documented in the repository function reference; see README for the exact parameters and limitations.

  24
• browser_network_requests

  Documented in the repository function reference; see README for the exact parameters and limitations.

  25
• browser_console_messages

  Documented in the repository function reference; see README for the exact parameters and limitations.

  26
• browser_connect_cdp

  Documented in the repository function reference; see README for the exact parameters and limitations.

  27
• browser_get_cdp_endpoints

  Documented in the repository function reference; see README for the exact parameters and limitations.

  28
• browser_disconnect_cdp

  Documented in the repository function reference; see README for the exact parameters and limitations.

  29
• browser_evaluate

  Documented in the repository function reference; see README for the exact parameters and limitations.

  30
• browser_handle_dialog

  Documented in the repository function reference; see README for the exact parameters and limitations.

  31
• browser_upload_file

  Documented in the repository function reference; see README for the exact parameters and limitations.

  32
• browser_save_pdf

  Documented in the repository function reference; see README for the exact parameters and limitations.

  33

This server’s available tools can vary by account, permissions, or configuration. The list shown is not its full runtime catalog.

• README claims 50+ functions but exact full active tool catalog was not established; 33 documented names are stored as a partial list.
• Browser automation can perform consequential actions on logged-in sites; restrict access and supervise writes/uploads/submissions.
• Default local browser may use a visible Chrome window; browser binaries/system dependencies may need installation.
• No official Microsoft affiliation established despite Microsoft copyright headers in some source files.
• No hosted remote endpoint was verified; HTTP/SSE require locally starting with --port.
• No runtime connection test performed.

• README describes installation with npm install and embedding createConnection but does not give a standalone client command; package manifest defines CLI binary, and source defines stdio as default. Configuration recipe is derived from those first-party files and marked not tested.
• README claims 50+ tools, but its enumerated reference only yielded 33 exact documented names; stored list is partial.

• primary source

  Project identity, installation as npm dependency, function reference, browser requirements, usage and troubleshooting.

• primary source

  Package name/version, Node requirement, owner/author, license and CLI binary name.

• primary source

  CLI entrypoint.

• primary source

  CLI flags and supported launch options.

• primary source

  stdio default when no port; local Streamable HTTP and SSE when port is set.

• primary source

  Default browser settings and PLAYWRIGHT_MCP_* environment variables.

Documentation checked 2026-10-28T13:31:11.000Z. Connection has not been runtime tested.