{"id":"eddiesanjuan-markupr","name":"markupr","homepage":"https://markupr.com/","repo_url":"https://github.com/eddiesanjuan/markupr","category":"ai-ml","subcategories":[],"tags":["ai-agents","mcp","desktop-app","cli","screen-recording","screenshot","transcription","markdown","developer-tools","local-first","electron","whisper","ffmpeg"],"what_it_does":"markupR is a local-first desktop capture tool that records screen + optionally voice/narration, aligns the transcript with captured timestamps, extracts relevant frames, enriches the report with context (cursor/app/window/focus hints when available), and outputs structured Markdown (including inline screenshots) for AI coding agents. It also provides a CLI for processing existing recordings and an MCP server for agent-driven capture/analysis workflows.","use_cases":["Capturing bug reports with visual evidence plus narration/context for AI coding agents","Generating structured, agent-executable Markdown from existing screen recordings (CLI/CI)","Interactive agent workflows via MCP tools (capture_screenshot, capture_with_voice, analyze_video, etc.)","Automated processing of new recordings in a watched directory","Turning generated feedback reports into GitHub/Linear issue formats"],"not_for":["High-assurance, audited medical/financial capture pipelines (no evidence of formal compliance controls)","Teams requiring guaranteed remote storage or centralized logging (claims emphasize local-first/no telemetry)","Services that need a stable, documented HTTP API contract (MCP/CLI are primary interfaces; no OpenAPI shown)"],"best_when":"You want local screen/voice capture and then want structured Markdown with screenshots/timestamp alignment for an AI coding agent to act on quickly.","avoid_when":"You need a pure web SaaS API with documented REST/GraphQL contracts, or you cannot install/run local binaries (Electron app/Node CLI/ffmpeg/whisper-node).","alternatives":["macOS Screenshot/Screen recording + manual issue writing","OCR/screenshot automation tools with separate annotation","Other local screen-to-text tools (varies by OS) combined with LLM transcription and custom report formatting"],"af_score":57.5,"security_score":32.8,"reliability_score":41.2,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T15:40:47.466317+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["No explicit authentication described for MCP/CLI (runs locally via npx/CLI)"],"oauth":false,"scopes":false,"notes":"No API keys, OAuth, or scope model is described for the MCP/CLI flows in the provided README. If GitHub push is used, it requires a `github-token` in the GitHub Action example, but the token handling is external to this README."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"README indicates local-first processing with Whisper running on-device. No paid tier/pricing information is provided in the supplied content."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":["Local-first; recordings/transcripts/screenshots processed on the user machine (claims in README)"],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":57.5,"security_score":32.8,"reliability_score":41.2,"mcp_server_quality":70.0,"documentation_accuracy":75.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":95.0,"rate_limit_clarity":0.0,"tls_enforcement":50.0,"auth_strength":20.0,"scope_granularity":0.0,"dependency_hygiene":45.0,"secret_handling":55.0,"security_notes":"The tool is described as local-first with no account requirement and (per README) no telemetry/tracking. No explicit guidance is provided for secret handling in MCP/CLI beyond a GitHub Action example using `github-token`. As an Electron/desktop app using native capabilities (screen/mic capture), user-granted OS permissions are a primary security boundary; detailed permission/scoping behavior is not described. TLS/auth for any remote calls are not evidenced in the provided content.","uptime_documented":0.0,"version_stability":55.0,"breaking_changes_history":40.0,"error_recovery":70.0,"idempotency_support":"false","idempotency_notes":null,"pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["MCP tools may depend on OS permissions for screen/mic capture and may fail if permissions are denied (not explicitly documented in provided content).","Quality depends on availability of ffmpeg and Whisper model; pipeline degrades gracefully but results may be reduced (transcript-only / timer-based screenshots).","Interactive recording sessions (start_recording/stop_recording) are stateful; agents should avoid interrupting sessions unexpectedly."]}}