| name | puppeteer-mcp |
| description | Automate browser interactions via Puppeteer CLI — navigate pages, take screenshots, click/fill/hover elements, and execute JavaScript. Use when user needs to browse URLs, capture screenshots, fill forms, or run JS in a browser. |
| source_version | 0.1.0 |
| source_cli_hash | 3c7e9966 |
| generated_at | 2026-04-06T09:07:19.574380+00:00 |
puppeteer-mcp (via mcp2cli)
Control a Puppeteer-driven browser: navigate, screenshot, interact with elements, and run JavaScript.
Shortcuts
mcp2cli puppeteer <cmd> (alias for mcp2cli puppeteer-mcp)
Commands
page
| Command | Description | Example | Ref |
|---|
mcp2cli puppeteer page navigate | Navigate to a URL | mcp2cli puppeteer page navigate --url https://example.com | ref |
mcp2cli puppeteer page screenshot | Take a screenshot of the page or element | mcp2cli puppeteer page screenshot --name my-shot
mcp2cli puppeteer page screenshot --name elem-shot --selector "#main" | ref |
mcp2cli puppeteer page evaluate | Execute JavaScript in browser console | mcp2cli puppeteer page evaluate --script "document.title" | ref |
element
| Command | Description | Example | Ref |
|---|
mcp2cli puppeteer element click | Click an element | mcp2cli puppeteer element click --selector "#submit-btn" | ref |
mcp2cli puppeteer element fill | Fill an input field | mcp2cli puppeteer element fill --selector "#email" --value "user@example.com" | ref |
mcp2cli puppeteer element select | Select a dropdown option | mcp2cli puppeteer element select --selector "#country" --value "US" | ref |
mcp2cli puppeteer element hover | Hover over an element | mcp2cli puppeteer element hover --selector ".menu-item" | ref |
Discover Parameters
Append --help to any command for full parameter list:
mcp2cli puppeteer page navigate --help
Note: Use Ref links in the Commands table above to view detailed parameter reference and more examples.
User Notes
MUST READ users/skill.md for custom workflows and tips.
Config: MCP server settings live in ~/.agents/mcp2cli/servers.yaml - edit there to take effect.
