Cloudflare Playwright MCP

Instructions

Implementation Reference

• src/tools/wait.ts:35-65 (handler)

  Handler function that implements the core logic of the 'browser_wait_for' tool: validates params, waits for time if specified, locates elements by text using Playwright, waits for visibility or hidden state, generates corresponding code snippet, and returns execution result.

  handle: async (context, params) => {
    if (!params.text && !params.textGone && !params.time)
      throw new Error('Either time, text or textGone must be provided');
  
    const code: string[] = [];
  
    if (params.time) {
      code.push(`await new Promise(f => setTimeout(f, ${params.time!} * 1000));`);
      await new Promise(f => setTimeout(f, Math.min(10000, params.time! * 1000)));
    }
  
    const tab = context.currentTabOrDie();
    const locator = params.text ? tab.page.getByText(params.text).first() : undefined;
    const goneLocator = params.textGone ? tab.page.getByText(params.textGone).first() : undefined;
  
    if (goneLocator) {
      code.push(`await page.getByText(${JSON.stringify(params.textGone)}).first().waitFor({ state: 'hidden' });`);
      await goneLocator.waitFor({ state: 'hidden' });
    }
  
    if (locator) {
      code.push(`await page.getByText(${JSON.stringify(params.text)}).first().waitFor({ state: 'visible' });`);
      await locator.waitFor({ state: 'visible' });
    }
  
    return {
      code,
      captureSnapshot,
      waitForNetwork: false,
    };
  },

• src/tools/wait.ts:23-33 (schema)

  Input schema and metadata for the 'browser_wait_for' tool, using Zod for validation of optional time, text, and textGone parameters.

  schema: {
    name: 'browser_wait_for',
    title: 'Wait for',
    description: 'Wait for text to appear or disappear or a specified time to pass',
    inputSchema: z.object({
      time: z.coerce.number().optional().describe('The time to wait in seconds'),
      text: z.string().optional().describe('The text to wait for'),
      textGone: z.string().optional().describe('The text to wait for to disappear'),
    }),
    type: 'readOnly',
  },

• src/tools/wait.ts:68-70 (registration)

  Exports a tool factory function that registers the 'browser_wait_for' tool (via the 'wait' factory) for inclusion in the MCP tools list.

  export default (captureSnapshot: boolean) => [
    wait(captureSnapshot),
  ];