render.screenshot

Instructions

Implementation Reference

• src/tools/render.ts:35-67 (handler)

  The core handler function for the render.screenshot tool. Launches a Puppeteer browser, creates a new page, sets viewport, navigates to the URL, waits, takes a screenshot (fullPage option), saves to screenshots directory with timestamp filename, and returns success with file details or error.

  async ({ url, fullPage = false, waitTime = 2000 }: any): Promise<ToolResult> => {
    let page: Page | null = null;
    try {
      const browserInstance = await getBrowser();
      page = await browserInstance.newPage();
      
      await page.setViewport({ width: 1920, height: 1080 });
      await page.goto(url, { waitUntil: 'networkidle2', timeout: 30000 });
      await new Promise(resolve => setTimeout(resolve, waitTime));
  
      const screenshotsDir = path.join(process.cwd(), 'screenshots');
      await fs.ensureDir(screenshotsDir);
      
      const filename = `screenshot_${Date.now()}.png`;
      const filepath = path.join(screenshotsDir, filename);
      
      await page.screenshot({
        path: filepath,
        fullPage,
      });
  
      await page.close();
  
      return formatToolResult(true, {
        url,
        screenshot: filepath,
        filename,
      });
    } catch (error: any) {
      if (page) await page.close().catch(() => {});
      return formatToolResult(false, null, error.message);
    }
  }

• src/tools/render.ts:26-33 (schema)

  Input schema for the render.screenshot tool defining the expected parameters: url (required string), fullPage (optional boolean), waitTime (optional number).

    type: 'object',
    properties: {
      url: { type: 'string', description: 'URL to screenshot' },
      fullPage: { type: 'boolean', description: 'Capture full page', default: false },
      waitTime: { type: 'number', description: 'Wait time in ms before screenshot', default: 2000 },
    },
    required: ['url'],
  },

• src/tools/render.ts:22-68 (registration)

  Registration of the render.screenshot tool using server.tool(), including name, description, inputSchema, and inline handler function. Called within registerRenderTools.

    'render.screenshot',
    {
      description: 'Take a screenshot of a webpage',
      inputSchema: {
        type: 'object',
        properties: {
          url: { type: 'string', description: 'URL to screenshot' },
          fullPage: { type: 'boolean', description: 'Capture full page', default: false },
          waitTime: { type: 'number', description: 'Wait time in ms before screenshot', default: 2000 },
        },
        required: ['url'],
      },
    },
    async ({ url, fullPage = false, waitTime = 2000 }: any): Promise<ToolResult> => {
      let page: Page | null = null;
      try {
        const browserInstance = await getBrowser();
        page = await browserInstance.newPage();
        
        await page.setViewport({ width: 1920, height: 1080 });
        await page.goto(url, { waitUntil: 'networkidle2', timeout: 30000 });
        await new Promise(resolve => setTimeout(resolve, waitTime));
  
        const screenshotsDir = path.join(process.cwd(), 'screenshots');
        await fs.ensureDir(screenshotsDir);
        
        const filename = `screenshot_${Date.now()}.png`;
        const filepath = path.join(screenshotsDir, filename);
        
        await page.screenshot({
          path: filepath,
          fullPage,
        });
  
        await page.close();
  
        return formatToolResult(true, {
          url,
          screenshot: filepath,
          filename,
        });
      } catch (error: any) {
        if (page) await page.close().catch(() => {});
        return formatToolResult(false, null, error.message);
      }
    }
  );

• src/tools/render.ts:9-17 (helper)

  Helper function to lazily initialize and return a shared Puppeteer Browser instance used by all render tools, including screenshot.

  async function getBrowser(): Promise<Browser> {
    if (!browser) {
      browser = await puppeteer.launch({
        headless: true,
        args: ['--no-sandbox', '--disable-setuid-sandbox'],
      });
    }
    return browser;
  }

• src/index.ts:42-42 (registration)

  Invocation of registerRenderTools(server) which registers the render.screenshot tool (and others) on the main MCP Server instance.

  registerRenderTools(server);