PuppeteerMCP Server

{ "properties": { "actions": { "description": "Array of page interactions to perform before taking screenshots", "items": { "properties": { "duration": { "default": 1000, "description": "Duration in milliseconds (for wait action)", "type": "number" }, "selector": { "description": "CSS selector for element-based actions", "type": "string" }, "text": { "description": "Text to type (for type action)", "type": "string" }, "timeout": { "default": 5000, "description": "Timeout in milliseconds (for waitForElement action)", "type": "number" }, "type": { "description": "Type of action to perform", "enum": [ "click", "type", "scroll", "wait", "hover", "select", "clear", "navigate", "waitForElement" ], "type": "string" }, "url": { "description": "URL to navigate to (for navigate action)", "type": "string" }, "value": { "description": "Value to select (for select action)", "type": "string" }, "x": { "description": "X coordinate (for scroll action)", "type": "number" }, "y": { "description": "Y coordinate (for scroll action)", "type": "number" } }, "required": [ "type" ], "type": "object" }, "type": "array" }, "breakpoints": { "description": "Viewport breakpoints (optional, defaults to mobile: 375px, tablet: 768px, desktop: 1280px)", "items": { "properties": { "width": { "description": "Viewport width in pixels", "type": "number" } }, "required": [ "width" ], "type": "object" }, "type": "array" }, "cookies": { "description": "Cookies to inject into the browser session before navigation", "items": { "properties": { "domain": { "description": "Cookie domain (optional, defaults to URL domain)", "type": "string" }, "expires": { "description": "Cookie expiration timestamp (optional)", "type": "number" }, "httpOnly": { "description": "HttpOnly flag (optional)", "type": "boolean" }, "name": { "description": "Cookie name", "type": "string" }, "path": { "description": "Cookie path (optional, defaults to '/')", "type": "string" }, "sameSite": { "description": "SameSite policy (optional)", "enum": [ "Strict", "Lax", "None" ], "type": "string" }, "secure": { "description": "Secure flag (optional)", "type": "boolean" }, "value": { "description": "Cookie value", "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "headless": { "default": true, "description": "Run browser in headless mode", "type": "boolean" }, "imageFormat": { "default": "jpeg", "description": "Image format (JPEG recommended for smaller file sizes)", "enum": [ "png", "jpeg" ], "type": "string" }, "maxWidth": { "default": 1280, "description": "Maximum width for image optimization (images wider than this will be clipped)", "type": "number" }, "quality": { "default": 80, "description": "JPEG quality (1-100, only applies when imageFormat is 'jpeg')", "maximum": 100, "minimum": 1, "type": "number" }, "sessionId": { "description": "Session identifier for persistent browser state (maintains cookies, login data, localStorage, etc.)", "type": "string" }, "timeout": { "default": 30000, "description": "Navigation timeout in milliseconds", "type": "number" }, "url": { "description": "URL to capture screenshots from", "type": "string" }, "userDataDir": { "description": "Custom user data directory path for browser session storage", "type": "string" }, "waitFor": { "default": "networkidle0", "description": "Wait condition before capturing screenshot", "enum": [ "load", "domcontentloaded", "networkidle0", "networkidle2" ], "type": "string" } }, "required": [ "url" ], "type": "object" }