Playwright MCP Server

Instructions

Implementation Reference

• src/server.ts:269-286 (handler)

  The handler function that executes the browser_take_screenshot tool. It ensures a browser and page are available, saves a screenshot to the specified filename (or a timestamped default), optionally full page, and returns a success message.

  private async handleScreenshot(filename?: string, fullPage?: boolean) {
    await this.ensureBrowser();
    
    const screenshotPath = filename || `screenshot-${Date.now()}.png`;
    await this.browserState.page!.screenshot({
      path: screenshotPath,
      fullPage: fullPage || false,
    });
    
    return {
      content: [
        {
          type: 'text',
          text: `Screenshot saved to ${screenshotPath}`,
        },
      ],
    };
  }

• src/server.ts:122-138 (schema)

  The tool schema definition returned by listTools, including name, description, and inputSchema for filename (optional string) and fullPage (optional boolean).

  {
    name: 'browser_take_screenshot',
    description: 'Take a screenshot of the current page',
    inputSchema: {
      type: 'object',
      properties: {
        filename: {
          type: 'string',
          description: 'File name to save the screenshot to',
        },
        fullPage: {
          type: 'boolean',
          description: 'Take screenshot of full page',
        },
      },
    },
  },

• src/server.ts:169-171 (registration)

  The switch case registration that maps the tool name to its handler function in the CallToolRequest handler.

  case 'browser_take_screenshot':
    return await this.handleScreenshot(args?.filename as string | undefined, args?.fullPage as boolean | undefined);