mcpField
S

Shiplight

Local
shiplight.aiBrowser Automation
Visit website

About Shiplight

MCP server that provides browser automation

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "ai-shiplight-shiplight": {
      "command": "npx",
      "args": [
        "-y",
        "@shiplightai/mcp"
      ],
      "env": {
        "PWDEBUG": "<PWDEBUG>"
      }
    }
  }
}
Run commandnpx -y @shiplightai/mcp
Environment variables to set
PWDEBUGMust be set to "console". Enables Playwright semantic locator generation (getByRole, getByTestId) for action entities. Without it, only XPath locators are available.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@shiplightai/mcp0.2.3

Tools

12

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
starting_urlstringNoStarting URL (defaults to about:blank)
browser_optionsobjectNoBrowser launch and emulation options.
browser_options.proxyobjectNoProxy configuration
browser_options.proxy.serverstringYes
browser_options.proxy.passwordstringNo
browser_options.proxy.usernamestringNo
browser_options.localestringNoBrowser locale (e.g., 'en-US', 'ja-JP')
browser_options.headlessbooleanNoRun browser in headless mode
browser_options.viewportobjectNoViewport size. Default: 1280x720. Common: mobile (390x844), tablet (768x1024), desktop (1920x1080).
browser_options.viewport.widthnumberYesViewport width in pixels
browser_options.viewport.heightnumberYesViewport height in pixels
browser_options.has_touchbooleanNoEnable touch events. Default: false
browser_options.is_mobilebooleanNoEmulate mobile device behavior (mobile CSS media queries, meta viewport tag). Default: false
browser_options.user_agentstringNoCustom user agent string
browser_options.geolocationobjectNoEmulated geolocation
browser_options.geolocation.accuracynumberNo
browser_options.geolocation.latitudenumberYes
browser_options.geolocation.longitudenumberYes
browser_options.timezone_idstringNoTimezone ID (e.g., 'America/New_York', 'Europe/London')
browser_options.color_schemeenumNoEmulated color scheme. Default: lightlight | dark | no-preference
browser_options.user_data_dirstringNoChrome user data directory for persistent profile. Caches extension state, Google OAuth sessions, chrome.storage.local data between sessions. If omitted, a fresh temp profile is created and cleaned up on close.
browser_options.record_evidencebooleanNoEnable video and trace recording. Set to true when verifying features or bug fixes so the user can watch the recording and review the trace.
browser_options.disable_securitybooleanNoDisable web security (CORS, CSP). Default: false
browser_options.path_to_extensionstringNoPath to unpacked Chrome extension directory. Launches a persistent Chromium context with --load-extension (headed mode forced, as headless Chrome cannot load extensions). See: https://playwright.dev/docs/chrome-extensions
storage_state_pathstringNoPath to a storage state file to restore cookies, localStorage, and IndexedDB into the session.

Details

The maintainer has not added details yet. Check the README in the repository.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.