jevstrudel.git / tools / mcp-e2e

For agents, on top of README.md, which they read first.

Notes for agents

Not a pnpm workspace package, on purpose. The MCP SDK is this script's only dependency; adding it to the workspace would put it in the site's pnpm closure and its nix hash. npm install here, pinned in package.json.

Never point either script at the user's dev server (4322/4323), the preview (4324) or the public site. It creates accounts and publishes a song where it runs, and plays sound in its own headless tab only.

The loopback callback must be a real server. Playwright's page.route does not intercept the redirect the consent form answers with, so the client listens on 127.0.0.1:<port> as Claude Code does (2026-09-26).