Skip to main content

FlowLens MCP server for FlowLens created by Magentic AI

Project description

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file iflow_mcp_magentic_flowlens_mcp_server-0.2.16.tar.gz.

File metadata

  • Download URL: iflow_mcp_magentic_flowlens_mcp_server-0.2.16.tar.gz
  • Upload date:
  • Size: 28.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_magentic_flowlens_mcp_server-0.2.16.tar.gz
Algorithm Hash digest
SHA256 53bfb02e341627fcbc59f420223b70ea2d0246df74a5234c2bdf4813e8c4da6f
MD5 34502f76a25707c5f98afd8fdd0095f2
BLAKE2b-256 ad524fc4868197e3fe92953e06f41e053726847f04d24e2b938a11fe972872ba

See more details on using hashes here.

File details

Details for the file iflow_mcp_magentic_flowlens_mcp_server-0.2.16-py3-none-any.whl.

File metadata

  • Download URL: iflow_mcp_magentic_flowlens_mcp_server-0.2.16-py3-none-any.whl
  • Upload date:
  • Size: 38.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_magentic_flowlens_mcp_server-0.2.16-py3-none-any.whl
Algorithm Hash digest
SHA256 0c2511bb45b421ccc07a548f01ee344cc8c9db39f6d3d3f441b9efc14b68770c
MD5 21b29ecd8401ca776f883076576e58c8
BLAKE2b-256 5059a75a52423cb886d66d97edbb0e52c3b7cf2e3124b3a921e52c491194e841

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page