What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

To let an AI agent inspect a live Cypress test, either attach its Chrome DevTools MCP server to the exact remote-debugging port used by Cypress, or use Cypress’s own cypress tap CLI with an open-mode session. The port method gives the agent browser-level access to the running Chrome instance; cypress tap exposes Cypress-specific test and failure context. Neither is the same as Cypress Cloud MCP, which reads recorded Cloud runs.

Choose the connection that matches the context you need

Method Where the context lives What the agent can inspect Main prerequisite
Chrome DevTools MCP with a matching port The local Chrome instance launched by Cypress open mode Browser and application state, including the page DOM at the time of inspection Configure the MCP client and Cypress to use the same Chrome remote-debugging port
cypress tap A local, running Cypress open-mode session Cypress reporter and Command Log context, test status, and application DOM associated with commands A compatible Cypress version and browser/session for the command being used
Cypress Cloud MCP Recorded Cypress Cloud runs Cloud run status, failures, and Test Replay information A Cypress Cloud account and a supported MCP client connection

For general browser-level inspection of the live session, follow the port-matching setup below. If the agent should run a spec and read Cypress-native failure context, use cypress tap. Cloud MCP is for analyzing recorded runs, not attaching to the local live browser. Cypress describes its AI features for test generation, such as Studio and cy.prompt, separately from agent tooling that supplies Cypress context. Cypress AI overview

Connect Chrome DevTools MCP to Cypress with the same port

The essential configuration is to make the MCP server attach to the Chrome remote-debugging port used by Cypress. If the agent’s MCP configuration points at a different port—or starts a separate Chrome instance—the agent will not see the Cypress-controlled browser session. Cypress’s published example uses port 59210; it is an example, not a required or reserved value. Cypress’s live-session setup

  1. Configure Chrome DevTools MCP in your AI agent’s MCP settings to connect to the chosen Chrome remote-debugging port. Follow the current setup instructions for your particular agent and MCP client; configuration labels and syntax can differ between clients.

    Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  2. In the project directory, launch Cypress open mode in Chrome with that same port. For the example port:

    CYPRESS_REMOTE_DEBUGGING_PORT=59210 cypress open --e2e --browser=chrome

    Replace 59210 with the port configured for the MCP connection, keeping the values identical.

  3. Run the test in the Cypress app. Ask the agent to inspect the already-open browser rather than launch a new browser. It can then examine the runner and application state visible in that Chrome instance.

Cypress’s article illustrates the workflow with a failed to-do deletion test: an agent inspecting the live page can use the current browser and application context to help decide whether the test or the application needs a change. That is an example described by Cypress, not a guarantee that an agent will diagnose a failure correctly.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Use cypress tap for Cypress-native live context

cypress tap is an extension of the Cypress CLI for interacting with an open-mode session from a terminal. It is often a closer fit than browser-level tooling when the agent needs to run a spec and inspect Cypress’s own reporter, Command Log, error, or application DOM context. Cypress tap documentation

Prerequisites and limits

Agent workflow

  1. In one terminal, open Cypress in the project and select the relevant test type and browser.

  2. From another terminal in the project, use cypress tap to run the target spec. Consult the current command reference for exact command syntax and options, since the beta interface can change.

  3. Poll the run status until it reaches a pass or fail result.

    Free tools Windows power users keep installed

    One-click scans. No signup required.

    Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  4. For a failure, ask the agent to inspect the reporter, Command Log, error details, and DOM context associated with the relevant command. JSON output is available for agent and script workflows.

The benefit is that an agent can reason from test-specific evidence alongside the application DOM, rather than relying only on a manually copied error description. Keep changes under review: access to failure context does not itself establish whether the application or test is at fault.

Keep live-session tools separate from Cloud MCP

Cypress Cloud MCP connects an AI client to recorded Cypress Cloud run data, including status, failures, and Test Replay information. Cypress documents Cloud MCP as generally available since May 20, 2026, on every Cypress Cloud plan at no additional cost. It is useful for asking about a completed or recorded run, but it does not replace attaching to a local live browser with the matching-port method or using cypress tap against open mode. Cypress Cloud MCP documentation

Troubleshoot connection and inspection problems

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Or skip the browser setup

ScreenshotNeo is a website screenshot API, not a Cypress-session connector: it can capture a URL, but it does not expose Cypress’s runner, test reporter, Command Log, or live browser session. For a standalone page screenshot, one GET request returns an image or PDF. See the ScreenshotNeo website and API documentation.

curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp

Cookie banners, popups, and chat widgets are removed before capture; bot checks, blank pages, and failed loads are never billed. An MCP server lets AI agents use ScreenshotNeo. The Free plan includes 1,000 screenshots a month with no card, and paid plans start at $5 for 3,000. These screenshot features do not connect to the Cypress session itself.

Sign up for ScreenshotNeo’s free plan to get 1,000 screenshots a month with no card.

Sources

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.