MCP server that records scripted Playwright demos as MP4/WebM/GIF
Two tools with reasonable descriptions but critical schema gaps. record_demo and capture_auth_state have clear, action-oriented names and descriptions (120-180 chars, within baseline 34-392 range). However, input schemas are not visible in the provided source code, only schema references (recordDemoInputSchema, captureAuthStateInputSchema) are imported but their actual definitions are not shown. Without seeing parameter types, descriptions, constraints, and output schemas, schema quality cannot be verified. Tool composition is sound (separate concerns), but lack of visible schema documentation is a hard blocker for production use.
Launch a headed browser at login_url so the user can manually sign in (including OAuth / SSO / 2FA). When the user closes the window, the Playwright storageState is saved to storage_state_path for later use by record_demo.
Record a scripted browser demo to an MP4/WebM (and optionally GIF) file. Takes a URL and a declarative step list; drives Playwright with an injected visible cursor, highlights, and captions. Supports authenticated apps via the optional `auth` field (storage_state_path from capture_auth_state, or inline cookies).
Input schemas not visible in source code. recordDemoInputSchema and captureAuthStateInputSchema are imported but definitions not provided. Cannot verify parameter types, descriptions, constraints, or output structure.
No parameter descriptions visible. LLMs cannot infer what 'url', 'steps', 'auth', 'login_url', or 'storage_state_path' mean without explicit descriptions. Baseline: 100% of A+ tools have param descriptions.
No output schema documented. Tool descriptions do not specify what fields are returned (e.g., does record_demo return file_path, duration, success_status?). Baseline: 100% of A+ tools have documented return types.
Error handling not documented. Tool descriptions do not explain what errors can occur, how to recover, or what the LLM should do if recording fails or auth times out.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 36 | 2026-07-28+ | v2 |
No idempotency or confirmation pattern for destructive operations. record_demo writes files; capture_auth_state opens a browser and saves state. No dry-run, confirmation, or rollback guidance.