Riddle MCP Server

MCP server that wraps the Riddle API for Claude Code integration. Take screenshots, run browser automation, and capture console logs + network HAR data.

Installation

1. Clone this repo

2. Install dependencies: npm install

3. Add to your Claude Code MCP settings (~/.claude.json or project .claude/settings.json):

4. Restart Claude Code

Available Tools

riddle_screenshot

Take a screenshot of any URL. Returns base64-encoded PNG.

Options:

• url (required): URL to screenshot

• device: "desktop" | "ipad" | "iphone"

• width, height: Custom viewport (if not using device preset)

riddle_batch_screenshot

Screenshot multiple URLs at once.

riddle_automate

Run a Playwright script, wait for completion, and get all artifacts including console logs and network HAR.

Returns:

• Screenshots saved to /tmp/

• Console logs (errors, warnings, last 20 log entries)

• Network HAR summary (total requests, failed requests, last 10 requests)

riddle_run_script

Run a Playwright script asynchronously. Returns job_id to check later.

riddle_get_job

Check status and get artifacts of an async job.

riddle_click_and_screenshot

Simple automation: load URL, click a selector, take screenshot.

Device Presets

Benefits

• No permission prompts - tools are pre-approved in Claude Code

• Direct image return - Claude can see screenshots immediately

• Console + Network capture - Debug issues without manual browser inspection

• Cleaner workflow - no bash/curl needed

License

MIT