# Puppeteer MCP

> Official Puppeteer Model Context Protocol Server for browser automation.

- Skill: `dokhacgiakhoa/puppeteer-mcp-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add dokhacgiakhoa/puppeteer-mcp-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dokhacgiakhoa/puppeteer-mcp-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: Dokhacgiakhoa (https://skillmd.com/u/dokhacgiakhoa)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/dokhacgiakhoa/puppeteer-mcp-2

---


# Puppeteer MCP Skill

## 🎯 Goal
Enable the AI Agent to control a headless browser for testing, scraping, and UI verification using the official Model Context Protocol standard.

## 🛠️ Tools

### `navigate`
Navigate the browser to a specific URL.
- **url**: The URL to visit (string)

### `screenshot`
Take a screenshot of the current page or a specific element.
- **path**: Path to save the screenshot (string)
- **selector**: CSS selector to capture (optional, default: full page)

### `click`
Click an element on the page.
- **selector**: CSS selector of the element to click (string)

### `fill`
Fill an input field.
- **selector**: CSS selector of the input (string)
- **value**: Value to type (string)

### `evaluate`
Execute JavaScript in the page context.
- **script**: JavaScript code to run (string)

### `get_content`
Get the HTML content of the page.
- **selector**: CSS selector to get content from (optional, default: body)

## 🚀 Usage Rules
1.  **Headless**: Creating a session spawns a headless browser by default.
2.  **Selectors**: Use stable CSS selectors (id, data-testid) where possible.
3.  **Wait**: Ensure standard Puppeteer `waitFor` logic is considered if the page is dynamic (handled by the tool implicitly or explicitly).