Skip to content
Back to search

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.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/magentic--flowlens-mcp-server/badge.svg)](/listings/magentic--flowlens-mcp-server)

HTML

<a href="/listings/magentic--flowlens-mcp-server"><img src="/api/listings/magentic--flowlens-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 127 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # FlowLens MCP
  2. [![PyPI version](https://img.shields.io/pypi/v/flowlens-mcp-server.svg)](https://pypi.org/project/flowlens-mcp-server/)
  3. `flowlens-mcp-server` gives your coding agent (Claude Code, Cursor, Copilot, Codex) full browser context for in-depth debugging and regression testing.
  4. ## How it works
  5. - Record your browser flow using the <a href="https://chromewebstore.google.com/detail/jecmhbndeedjenagcngpdmjgomhjgobf?utm_source=github-repo" target="_blank" rel="noopener noreferrer">FlowLens Chrome extension</a> (user actions, network, console, storage, DOM events/screen recording).
  6. - Share it with your coding agent via the FlowLens MCP server, giving the agent full access to the recording.
  7. - Your agent inspects and analyzes the flow for debugging and insights — without spending time/tokens on reproducing the issue.
  8. ## Demo
  9. <video src="https://github.com/user-attachments/assets/fd73f2e6-6a7d-4518-b0db-62b8c6e6c99a" autoplay loop muted playsinline></video>
  10. ## Requirements
  11. - <a href="https://chromewebstore.google.com/detail/jecmhbndeedjenagcngpdmjgomhjgobf?utm_source=github-repo" target="_blank" rel="noopener noreferrer">FlowLens browser extension</a> add to chrome and pin for ease of use
  12. - [pipx](https://pipx.pypa.io/stable/installation/)
  13. ## Getting Started
  14. To install:
  15. ```bash
  16. pipx install flowlens-mcp-server
  17. ```
  18. To upgrade to the latest version:
  19. ```bash
  20. pipx upgrade flowlens-mcp-server
  21. ```
  22. To check that the installation was successfully:
  23. ```bash
  24. flowlens-mcp-server
  25. ```
  26. ## Add FlowLens MCP server
  27. Add the following config to your MCP client (ex: `~/.claude.json`) under `mcpServers`:
  28. ```json
  29. "flowlens": {
  30. "command": "flowlens-mcp-server",
  31. "type": "stdio"
  32. }
  33. ```
  34. ### MCP Client configuration
  35. <details>
  36. <summary>Claude Code</summary>
  37. Use the Claude Code CLI to add the FlowLens MCP server (<a href="https://docs.anthropic.com/en/docs/claude-code/mcp" target="_blank" rel="noopener noreferrer">guide</a>):
  38. ```bash
  39. claude mcp add flowlens --transport stdio -- flowlens-mcp-server
  40. ```
  41. </details>
  42. <details>
  43. <summary>Cursor</summary>
  44. **Click the button to install:**
  45. [<img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Install in Cursor">](https://cursor.com/en/install-mcp?name=flowlens&config=eyJjb21tYW5kIjoiZmxvd2xlbnMtbWNwLXNlcnZlciJ9)
  46. **Or install manually:**
  47. Go to `Cursor Settings` -> `MCP` -> `New MCP Server`. Use the config provided above.
  48. </details>
  49. <details>
  50. <summary>Copilot / VS Code</summary>
  51. Follow the MCP install <a href="https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_add-an-mcp-server" target="_blank" rel="noopener noreferrer">guide</a>,
  52. with the standard config from above. You can also install the FlowLens MCP server using the VS Code CLI:
  53. ```bash
  54. code --add-mcp '{"name":"flowlens","command":"flowlens-mcp-server"}'
  55. ```
  56. </details>
  57. <details>
  58. <summary>Codex</summary>
  59. Use the Codex CLI to add the FlowLens MCP server <a href="https://github.com/openai/codex/blob/main/docs/advanced.md#model-context-protocol-mcp" target="_blank" rel="noopener noreferrer">configure MCP guide</a>:
  60. ```bash
  61. codex mcp add flowlens -- flowlens-mcp-server
  62. ```
  63. </details>
  64. <details>
  65. <summary>Antigravity</summary>
  66. Follow the <a href="https://antigravity.google/docs/mcp" target="_blank" rel="noopener noreferrer">Connecting Custom MCP Servers guide</a>. Add the following config to the MCP servers config:
  67. ```json
  68. "flowlens": {
  69. "command": "flowlens-mcp-server"
  70. }
  71. ```
  72. </details>
  73. ### Note:
  74. The above setup only works with local flows. If you want to also connect to shareable flows, get your `FLOWLENS_MCP_TOKEN` from the <a href="https://flowlens.magentic.ai/flowlens/setup-wizard?tool=vscode" target="_blank" rel="noopener noreferrer">FlowLens platform</a> and add it to your relevant MCP config file:
  75. ```json
  76. "flowlens": {
  77. "command": "flowlens-mcp-server",
  78. "type": "stdio",
  79. "env": {
  80. "FLOWLENS_MCP_TOKEN": "YOUR_FLOWLENS_MCP_TOKEN"
  81. }
  82. }
  83. ```
  84. ## Usecases:
  85. ### Bug reporting
  86. - 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.
  87. ### Regression testing
  88. - Use FlowLens to record your crticial user flows and ask your coding agent to auto test these flows or generate corresponding playwright test scripts
  89. ### Shareable flows
  90. - Share captured flows with your teammates on the [FlowLens platform](https://flowlens.magentic.ai) and debug with your coding agent by adding a generated access token in the MCP config. More on this [here](https://flowlens.magentic.ai/flowlens/setup-wizard)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.