browser_screenshot
Capture screenshots of web pages or specific elements using CSS selectors for detailed analysis during penetration testing on the MCP Server Pentest platform.
Instructions
Take a screenshot of the current page or a specific element
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fullPage | No | Take a full page screenshot (default: false) | |
| name | Yes | Name for the screenshot | |
| selector | No | CSS selector for element to screenshot |
Implementation Reference
- index.ts:220-257 (handler)Handler for browser_screenshot tool: captures screenshot of page or specified element using Playwright, converts to base64, stores it, and returns text confirmation with embedded image.case ToolName.BrowserScreenshot: { const fullPage = (args.fullPage === 'true'); const screenshot = await (args.selector ? page.locator(args.selector).screenshot() : page.screenshot({ fullPage })); const base64Screenshot = screenshot.toString('base64'); if (!base64Screenshot) { return { content: [{ type: "text", text: args.selector ? `Element not found: ${args.selector}` : "Screenshot failed", }], isError: true, }; } screenshots.set(args.name, base64Screenshot); server.notification({ method: "notifications/resources/list_changed", }); return { content: [ { type: "text", text: `Screenshot '${args.name}' taken`, } as TextContent, { type: "image", data: base64Screenshot, mimeType: "image/png", } as ImageContent, ], isError: false, }; }
- index.ts:50-62 (schema)Schema definition for browser_screenshot tool including input parameters: name (required), selector (optional), fullPage (optional boolean).{ name: ToolName.BrowserScreenshot, description: "Take a screenshot of the current page or a specific element", inputSchema: { type: "object", properties: { name: { type: "string", description: "Name for the screenshot" }, selector: { type: "string", description: "CSS selector for element to screenshot" }, fullPage: { type: "boolean", description: "Take a full page screenshot (default: false)", default: false }, }, required: ["name"], }, },
- index.ts:840-842 (registration)Registration of all tools including browser_screenshot via the TOOLS array in the ListToolsRequestSchema handler.server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS, }));
- index.ts:844-846 (registration)Registration of the call tool handler which dispatches to browser_screenshot case in handleToolCall.server.setRequestHandler(CallToolRequestSchema, async (request) => handleToolCall(request.params.name as ToolName, request.params.arguments ?? {}) );
- index.ts:24-24 (registration)Enum definition mapping ToolName.BrowserScreenshot to string 'browser_screenshot'.BrowserScreenshot = "browser_screenshot",