FlowScope UX Flow Analyser MCP server

by DavidNgugi·io.github.DavidNgugi/flowscope·v0.1.1·2 stars

No reviews yet

Turn YouTube product demos into structured UX flow reports, and compare demos side by side.

B83/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B83/100

full report

Adoption

Growing

2 stars353 downloads/wk

Reviews

Write one

Nobody has reviewed FlowScope UX Flow Analyser yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

FlowScope UX Flow Analyser tools (10, 1 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

flowscope_analyze_video
Args: urls: YouTube video URLs to analyse. wait: Block until the analysis finishes (or the wait budget expires). wait_seconds: Override the wait budget in seconds. 0 uses the server default (FLOWSCOPE_MAX_WAIT, 900s). Ignored when wait is false. force: Re-analyse even if this video id is already stored. Costs money; only use it to deliberately replace an existing analysis. force_local_transcriptio
flowscope_compare_videos
Args: video_ids: Two or more FlowScope video ids that have finished analysing. force_refresh: Recompute even though a stored comparison exists.
flowscope_delete_videowrite action
Args: video_id: The FlowScope video id to delete. delete_media: Also delete the downloaded video and frame files from disk.
flowscope_frame_image
Args: video_id: The video the frame belongs to, from flowscope_get_report. frame_id: The frame_id field on any entry of that report's frames.
flowscope_get_report
Args: video_id: The FlowScope video id. max_frames: Maximum screens to include, evenly sampled across the flow. Use 0 for every screen. Defaults to 24 to keep the response small. include_transcript: Include the full transcript text. Off by default because it is long and the per-screen excerpts already carry the relevant narration.
flowscope_health_check
flowscope_job_status
Args: video_id: The FlowScope video id returned by flowscope_analyze_video.
flowscope_list_videos
flowscope_reanalyze_video
Args: video_id: The FlowScope video id to re-analyse.
flowscope_retry_video
Args: video_id: The FlowScope video id to retry.

Public scan report

scanner v0.1.10 · 2026-10-14 · same rubric, same numbers if you re-run it

no findings

Code scan10 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitystatic API keys via environment variables6/15
Maintenancelast push 2 days ago15/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Overall 83/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How FlowScope UX Flow Analyser compares

Against every graded E-commerce MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 83/100; higher than 75% of 2,014 E-commerce servers
Tools: 10; the typical E-commerce server has 7
Tools that change things: 10%; typical: 3%. Fewer write tools means less an agent can break
GitHub stars: 2; more than 80% of 989 E-commerce servers
Downloads a week: 353; more than 87% of 378 E-commerce servers with a package

What its tools let an agent do: 9 read · 1 change

Install FlowScope UX Flow Analyser in Claude Code, Cursor or VS Code

claude mcp add flowscope -- uvx flowscope-mcp

Add to Cursor

What the publisher says

From the FlowScope UX Flow Analyser repository's README, as published. We do not edit it. Read it on GitHub

FlowScope

Given one or more YouTube product-demo URLs, FlowScope downloads the video, transcribes it (captions or local Whisper), extracts and deduplicates representative screenshots of distinct screens, aligns them to the narration, and uses an LLM to produce a structured breakdown of the product's flow, screens, and UX patterns — plus cross-video comparison.

For personal competitive UX research use. Downloaded videos and derived analysis stay local.

Use it from an LLM (MCP)

mcp/ is an MCP server that exposes this pipeline as tools, plus two installable skills, so any MCP-capable client can run the analyses for you:

Compare the onboarding flows in these two videos: and

Start the backend, then install into your client:

cd backend && uvicorn app.main:app --port 8000     # terminal 1

# Claude Code: one step, brings the skills and the server registration
/plugin marketplace add DavidNgugi/flowscope
/plugin install flowscope@flowscope

For any other harness, generate the client config — the shapes genuinely differ (VS Code's own file uses servers where everyone else uses mcpServers, and Codex is TOML):

uvx --from flowscope-mcp flowscope-mcp-install --help   # every client and its path
uvx --from flowscope-mcp flowscope-mcp-install cursor   # or vscode, codex, gemini

(flowscope-mcp-install is a console script inside the flowscope-mcp distribution, hence --from. If you installed the package locally, the bare flowscope-mcp-install works too.)

The two bundled skills install separately, into any Agent Skills-compatible client. .agents/skills/ is the cross-client convention, so one copy serves most harnesses:

mkdir -p .agents/skills && cp -r mcp/skills/* .agents/skills/
npx skills add DavidNgugi/flowscope        # or via the skills CLI

Ask the agent to run flowscopehealthcheck — it reports whether the backend, ffmpeg, yt-dlp, and an LLM provider key are all in place, so a missing prerequisite is a clear message rather than a failed ten-minute job.

Then just describe what you want:

Tear down the onboarding UX in this demo:

Compare the onboarding flows in these two demos. Where do they diverge, and what's the trade-off each one makes?

In this demo, how many steps does signup take, and what does each one ask for?

Analysing a video takes 2–10 minutes and makes one vision call per distinct screen, so it costs real money. Results are cached by YouTube video id — asking "what has FlowScope already analysed?" is free, and re-reading a report costs nothing. The bundled skills teach the agent to check the cache before spending.

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

FlowScope UX Flow Analyser: common questions

Is FlowScope UX Flow Analyser MCP server safe?: Mostly: it is graded B (83/100). Read the FlowScope UX Flow Analyser safety report
How do I install FlowScope UX Flow Analyser?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does FlowScope UX Flow Analyser need an API key?: Yes. The registry entry asks for FLOWSCOPE_API_TOKEN.
Is FlowScope UX Flow Analyser maintained?: The last commit was 13 days ago (2026-10-12). The latest release is v0.1.1.
What can I use instead of FlowScope UX Flow Analyser?: Servers from other publishers that do the same job: HasData Amazon MCP server, Shopware MCP server and Scavio MCP server. Compare all FlowScope UX Flow Analyser alternatives.
How does FlowScope UX Flow Analyser compare with other E-commerce MCP servers?: safety score 83/100 (higher than 75% of 2,014 E-commerce servers); tools 10 (the typical E-commerce server has 7); tools that change things 10% (typical: 3%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to FlowScope UX Flow Analyser

Same job from other publishers: the closest match first, then the best rated.

All FlowScope UX Flow Analyser alternatives →

HasData Amazon
Amazon keyword search, product details, seller profiles and seller catalogues, as structured JSON.
More from hasdata.com →
not reviewed
Growing
A
Shopware
Query and safely manage a Shopware 6 shop: products, orders, customers, stock, audits, reports.
not reviewed
Growing
B
Scavio
Structured web data from 38 platforms: Google, ChatGPT, Gemini, YouTube, Amazon, Reddit, TikTok
not reviewed
Growing
A
Savvly
Savvly MCP: query fund data, model projections, and compare against alternative retirement products.
not reviewed
Growing
A
Fair Value MCP Server
Valuation MCP: DCF/NAV/CCA, WACC, derivatives, credit risk, fixed income, structured products.
not reviewed
Growing
A

Run it through the gateway

Local package. It runs on your machine, not through the gateway.

Rating: —
Safety grade: B · 83/100
Stars: 2
Downloads/wk: 353
Price: Free
Licence: MIT
Transport: Local · pypi
Version: 0.1.1
Category: E-commerce
Last release: 2026-10-12

Credentials it needs

FLOWSCOPE_API_URLBase URL of the running FlowScope backend. '/api' is appended if absent.
FLOWSCOPE_API_TOKENsecretBearer token, only needed when the backend sits behind an authenticating proxy.
FLOWSCOPE_MAX_WAITDefault seconds that flowscope_analyze_video waits for a job before returning a job id.

Own this server?

Claim it to keep the listing current and reply to reviews. Claiming never changes the grade or hides a review.

Claim listing

Badge for your README

Shows the safety grade and links back to this page. It updates itself after every scan and review.

[![mcp.market](https://mcp.market/badge/davidngugi-flowscope.svg)](https://mcp.market/server/davidngugi-flowscope)

How the badge works