Skip to main content
Glama

QuickCast MCP (Screen-to-Action Protocol)

npm version Agensi Skill Glama MCP License: MIT Node.js

Autonomous AI Protocol for Screen Recordings
Turn screen recordings directly into structured GitHub bug reports with clickable video timestamps, executable Playwright E2E tests, and Standard Operating Procedure (SOP) documentation.

Part of the QuickCast Screen-Recorder & Watermark & Resize Studio ecosystem.


⚡ Features

  • 🎥 get_latest_session: Instantly fetches recording metadata, duration, Cloudflare R2 watch URL, and user interaction markers from the latest session.

  • 📋 list_recent_sessions: Inspects recent screen recordings with durations, timestamps, and shareable preview links.

  • 🐛 format_github_bug_report: Formats an engineering-ready GitHub or Jira issue containing timestamped reproduction links (e.g. [00:15](watchUrl#t=15)), environment tables (URL, OS, resolution, browser), and failure descriptions.

  • 🎭 scaffold_playwright_test: Automatically outputs an executable Playwright reproduction test (in TypeScript or JavaScript) mirroring the exact interaction flow.

  • 📖 generate_sop_guide: Synthesizes a clean Markdown Standard Operating Procedure (SOP) for team training and workflow documentation.

  • 📥 ingest_session: Allows AI agents or scripts to register and store new recording telemetry into the local profile database (~/.quickcast/sessions.json).


Related MCP server: ThinkRun

📦 Instant Setup (Claude Desktop & Cursor)

Because quickcast-mcp is published on npm, you can run it instantly with zero local file cloning:

1. Claude Desktop Configuration

Add the following to your claude_desktop_config.json:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "quickcast": {
      "command": "npx",
      "args": ["-y", "quickcast-mcp"]
    }
  }
}

2. Cursor Configuration

Add to your project's .cursor/mcp.json or Cursor MCP Settings:

{
  "mcpServers": {
    "quickcast": {
      "command": "npx",
      "args": ["-y", "quickcast-mcp"]
    }
  }
}

3. Smithery 1-Click Install

npx -y @smithery/cli install quickcast-mcp --client claude

4. AI Agent Skill (SKILL.md)

QuickCast MCP is officially published as a verified skill on Agensi.io and is packaged with an autonomous SKILL.md specification compatible with Claude Code, Cursor, Windsurf, OpenClaw, and GitHub Copilot. It teaches your AI agent how to automatically invoke QuickCast tools to turn recording sessions into tests, bug reports, and SOPs.


🛠️ MCP Tools Reference

Tool

Description

Inputs

get_latest_session

Get latest recording details & R2 watch URL

session_id, watch_url, session_file

list_recent_sessions

List last 10 recordings with durations & links

limit, session_file

format_github_bug_report

Generate markdown bug report with video timestamps

issue_title, expected_behavior, actual_behavior

scaffold_playwright_test

Generate executable Playwright E2E script

language (typescript / javascript), test_name

generate_sop_guide

Generate SOP documentation

workflow_name, title

ingest_session

Store session telemetry to local DB

watchUrl, durationSeconds, markers, environment


🔒 Safety & Privacy

  • 100% Client-Side & Local: Runs as a local stdio server on your machine.

  • Zero Cloud Costs: Uses your existing Cloudflare R2 links or local recording files. No external AI API keys or third-party cloud brokers required.

  • Decoupled Architecture: Strictly isolated from extension recording engines and web apps.


🌐 Managed QA & Automation Services

Need a dedicated, automated Playwright regression testing suite and daily CI monitoring built for your web application? Visit Watermark & Resize Studio QA Automation for turnkey Testing as a Service (TaaS).


📄 License

MIT © Watermark & Resize Studio

Available Tools

6 tools
format_github_bug_reportB

Format an automated, high-fidelity GitHub/Jira bug reproduction issue markdown document with timestamped video links, environment tables, and failure points from a QuickCast session.

Inputs: notes, watch_url, session_id, issue_title, +3 more.

generate_sop_guideB

Generate a clean, structured Standard Operating Procedure (SOP) or training walkthrough document with timestamped video checkpoints from a QuickCast session.

Inputs: title, session_id, session_data, workflow_name.

get_latest_sessionB

Retrieve metadata, duration, markers, and Cloudflare R2 watch URL of the latest or specified QuickCast recording session.

Inputs: watch_url, session_id, session_data, session_file.

ingest_sessionB

Ingest and store a QuickCast recording session into the local session storage (~/.quickcast/sessions.json) so AI assistants can reference it.

Inputs: watchUrl (required), markers, filename, sessionId, +2 more.

list_recent_sessionsB

List recent QuickCast screen recording sessions with IDs, timestamps, durations, and shareable watch URLs.

Inputs: limit, session_file.

scaffold_playwright_testA

Generate an executable Playwright (TypeScript or JavaScript) E2E reproduction test based on the interactions, clicks, and URLs captured during the QuickCast recording.

Inputs: language, test_name, session_id, target_url, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 6 tools

    Disambiguation4/5

    Each tool has a distinct purpose: listing vs. retrieving session metadata, ingesting, and three different output-artifact generators (SOP, bug report, Playwright test). The only mild overlap is between get_latest_session and list_recent_sessions, but their descriptions clarify the distinction well.

    Naming Consistency5/5

    All six tools follow a consistent snake_case verb_noun pattern (generate_sop_guide, list_recent_sessions, get_latest_session, format_github_bug_report, scaffold_playwright_test, ingest_session). The verbs vary appropriately to match each action without breaking the predictable convention.

    Tool Count5/5

    Six tools is a well-scoped set for a session-recording processing server, covering retrieval, ingestion, and three distinct artifact generators without redundancy or padding.

    Completeness4/5

    The surface covers ingestion, listing, retrieval, and several generation workflows, which fits the domain well. Minor gaps remain, such as no delete/update or search-by-content operation, but agents can work around these.

    Related MCP Connectors

    Related MCP Servers