← Discover MCPs and Agents
f
MCPAI & MLGitHub

flowlens-mcp-server

FlowLens is an open-source MCP server that gives your coding agent (Claude Code, Cursor, Copilot, Codex) full browser context for in-depth debugging and regression testing.

Links

Repository

README

From the repo.

FlowLens MCP

PyPI version

flowlens-mcp-server gives your coding agent (Claude Code, Cursor, Copilot, Codex) full browser context for in-depth debugging and regression testing.

How it works

  • Record your browser flow using the FlowLens Chrome extension (user actions, network, console, storage, DOM events/screen recording).
  • Share it with your coding agent via the FlowLens MCP server, giving the agent full access to the recording.
  • Your agent inspects and analyzes the flow for debugging and insights — without spending time/tokens on reproducing the issue.

Demo

Requirements

Getting Started

To install:

pipx install flowlens-mcp-server

To upgrade to the latest version:

pipx upgrade flowlens-mcp-server

To check that the installation was successfully:

flowlens-mcp-server

Add FlowLens MCP server

Add the following config to your MCP client (ex: ~/.claude.json) under mcpServers:

"flowlens": {
  "command": "flowlens-mcp-server",
  "type": "stdio"
}

MCP Client configuration

Claude Code Use the Claude Code CLI to add the FlowLens MCP server (guide): 
claude mcp add flowlens --transport stdio -- flowlens-mcp-server
Cursor

Click the button to install:

Install in Cursor

Or install manually:

Go to Cursor Settings -> MCP -> New MCP Server. Use the config provided above.

Copilot / VS Code Follow the MCP install guide, with the standard config from above. You can also install the FlowLens MCP server using the VS Code CLI: 
code --add-mcp '{"name":"flowlens","command":"flowlens-mcp-server"}'
Codex Use the Codex CLI to add the FlowLens MCP server configure MCP guide: 
codex mcp add flowlens -- flowlens-mcp-server
Antigravity Follow the Connecting Custom MCP Servers guide. Add the following config to the MCP servers config: 
"flowlens": {
  "command": "flowlens-mcp-server"
}

Note:

The above setup only works with local flows. If you want to also connect to shareable flows, get your FLOWLENS_MCP_TOKEN from the FlowLens platform and add it to your relevant MCP config file:

"flowlens": {
  "command": "flowlens-mcp-server",
  "type": "stdio",
  "env": {
    "FLOWLENS_MCP_TOKEN": "YOUR_FLOWLENS_MCP_TOKEN"
  }
}

Usecases:

Bug reporting

  • Use FlowLens to quickly report bugs with full context to your coding agent. You no longer need to copy-paste console logs, take multiple screenshots, or have the agent spend tokens on reproducing the issue.

Regression testing

  • Use FlowLens to record your crticial user flows and ask your coding agent to auto test these flows or generate corresponding playwright test scripts

Shareable flows

  • Share captured flows with your teammates on the FlowLens platform and debug with your coding agent by adding a generated access token in the MCP config. More on this here

Collected info

  • ★ 109 stars
  • ⎇ 7 forks
  • Language: Python
  • Source updated: 8/1/2026

Config for your environment

Replace {MCP_ENDPOINT_URL} with this MCP’s endpoint URL (from its repo or docs above). No API key — you connect directly.

Tool

OS

Config file: ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server": {
      "url": "{MCP_ENDPOINT_URL}"
    }
  }
}

Paste into mcpServers in the config file. Restart Cursor after saving.

If this MCP is also published on mcpchannel.ai, you can subscribe from Browse and use the gateway config there instead.