FlowScope UX Flow Analyser

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/davidngugi-flowscope

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 26, 2026.

Tools

6 read · 1 write · 1 delete · 2 not yet classified

Secrets

1 (API keys, tokens or passwords)

Install scripts

None found

Runs as

Python package

Tools (10)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• flowscope_analyze_videoAnalyse a YouTube product demo

  Submit one or more YouTube URLs for UX analysis. FlowScope downloads each video, transcribes it, extracts and deduplicates screenshots of distinct screens, describes each screen with a vision model, and synthesises the flow. This is slow (minutes per video) and the vision steps cost money, so check flowscope_list_videos first -- an already-analysed video is reused for free and immediately. By default this waits for completion and returns the reports; if the analysis needs longer than wait_seconds it returns status 'running' with video ids to poll.

• flowscope_compare_videosCompare the UX of several videos

  Compare two or more already-analysed videos and return their common patterns, their divergences, and a per-stage matrix. Requires at least two videos that have finished analysing. The comparison is an LLM call, so it takes a while and costs money; results are cached until one of the videos is re-analysed.

• flowscope_delete_videoDelete a video and its analysis

  Permanently remove a video's analysis from FlowScope. With delete_media true it also deletes the downloaded video and extracted frames from disk, which cannot be undone. Ask the user before using delete_media.

• flowscope_frame_imageView a screen screenshot

  Return the actual screenshot for one screen of a video, as an image the caller can look at. Use this when the written report is not enough and the visual layout matters, for example to judge spacing, hierarchy or visual style. Takes the video id and the frame_id from flowscope_get_report.

• flowscope_get_reportRead a video's UX report

  Return the finished UX analysis of one video: the ordered user flow, synthesised UX insights, and per-screen findings with the visible UI elements and the narration that accompanies each screen. This is the primary tool for answering UX questions about a video.

• flowscope_health_checkCheck FlowScope readiness

  Check that the FlowScope backend is running and that its dependencies (ffmpeg, yt-dlp, an LLM provider key) are ready. Call this before submitting a video so a missing prerequisite is reported as a config problem rather than a failed multi-minute job.

• flowscope_job_statusCheck analysis progress

  Report the progress of a video's latest analysis job. Use this to poll after flowscope_analyze_video returns while still running, or to find out why an analysis failed. Poll every 20-30 seconds; do not resubmit the URL.

• flowscope_list_videosList analysed videos

  List videos FlowScope has been asked to analyse, newest first, with the status of each one's latest job. Call this first: results are cached by YouTube video id, so an existing entry means the analysis is free to re-read and must not be resubmitted.

• flowscope_reanalyze_videoRedo the derived analysis for a video

  Discard a video's frames, per-screen analyses and synthesised flow, then redo extraction and analysis from the downloaded video. Use this after changing the LLM model or prompt. It deletes stored results and spends money again. Any comparison that included this video is dropped too.

• flowscope_retry_videoRetry a failed analysis

  Re-queue the last analysis job for a video after a failure, or start a fresh job when the previous one finished. Stages that already completed are reused, so a retry does not re-download or re-bill them.

Signals

Stars

2

Forks

1

Open issues

0

Weekly downloads

39

Last commit (this folder)

Oct 7, 2026 (1 month ago)

Last release

Oct 7, 2026 (1 month ago)

Last package publish

Oct 7, 2026 (1 month ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.DavidNgugi/flowscope

Version

0.1.1

Auth

API key

Packages

pypi flowscope-mcp

License

MIT

Repository

github.com/DavidNgugi/flowscope

Website

github.com/DavidNgugi/flowscope

First seen

Oct 24, 2026

Last checked

Nov 1, 2026

Source

Official MCP Registrygithub-graphql