Playwright MCP Server

Instructions

Implementation Reference

• src/tools.ts:184-195 (schema)

  Defines the tool name, description, and input schema for 'playwright_upload_file'.

  {
    name: "playwright_upload_file",
    description: "Upload a file to an input[type='file'] element on the page",
    inputSchema: {
      type: "object",
      properties: {
        selector: { type: "string", description: "CSS selector for the file input element" },
        filePath: { type: "string", description: "Absolute path to the file to upload" }
      },
      required: ["selector", "filePath"],
    },
  },

• src/tools/browser/interaction.ts:139-150 (handler)

  The UploadFileTool class implements the core logic for uploading a file using Playwright's setInputFiles method on the specified selector.

  export class UploadFileTool extends BrowserToolBase {
    /**
     * Execute the upload file tool
     */
    async execute(args: any, context: ToolContext): Promise<ToolResponse> {
      return this.safeExecute(context, async (page) => {
          await page.waitForSelector(args.selector);
          await page.setInputFiles(args.selector, args.filePath);
          return createSuccessResponse(`Uploaded file '${args.filePath}' to '${args.selector}'`);
      });
    }
  }

• src/toolHandler.ts:502-503 (registration)

  Dispatches the tool call to the UploadFileTool's execute method in the main tool handler switch statement.

  case "playwright_upload_file":
    return await uploadFileTool.execute(args, context);

• src/toolHandler.ts:327-327 (registration)

  Instantiates the UploadFileTool instance during tool initialization.

  if (!uploadFileTool) uploadFileTool = new UploadFileTool(server);

• src/tools.ts:459-459 (registration)

  Lists 'playwright_upload_file' in the BROWSER_TOOLS array for conditional browser launching.

  "playwright_upload_file",