LogoSTMCP
Download
Puppeteer

Puppeteer

A Model Context Protocol server that provides browser automation capabilities using Puppeteer. This server enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment.

Tools

1. puppeteer_navigate

Navigate to any URL in the browser. This tool allows you to direct the browser to load a specific web page.

Parameters:

  • url (string, required): URL to navigate to
  • launchOptions (object, optional): PuppeteerJS LaunchOptions. Default null. If changed and not null, browser restarts. Example: { headless: true, args: ['--user-data-dir="C:/Data"'] }
  • allowDangerous (boolean, optional): Allow dangerous LaunchOptions that reduce security. When false, dangerous args like --no-sandbox, --disable-web-security will throw errors. Default false.
2. puppeteer_screenshot

Capture screenshots of the entire page or specific elements. This tool enables you to take visual snapshots of web content.

Parameters:

  • name (string, required): Name for the screenshot
  • selector (string, optional): CSS selector for element to screenshot
  • width (number, optional, default: 800): Screenshot width
  • height (number, optional, default: 600): Screenshot height
  • encoded (boolean, optional): If true, capture the screenshot as a base64-encoded data URI (as text) instead of binary image content. Default false.
3. puppeteer_click

Click elements on the page. This tool simulates mouse clicks on specified web page elements.

Parameters:

  • selector (string, required): CSS selector for element to click
4. puppeteer_hover

Hover elements on the page. This tool simulates mouse hover actions over specified web page elements.

Parameters:

  • selector (string, required): CSS selector for element to hover
5. puppeteer_fill

Fill out input fields. This tool allows you to enter text into form fields and input elements.

Parameters:

  • selector (string, required): CSS selector for input field
  • value (string, required): Value to fill
6. puppeteer_select

Select an element with SELECT tag. This tool enables you to choose options from dropdown menus and select elements.

Parameters:

  • selector (string, required): CSS selector for element to select
  • value (string, required): Value to select
7. puppeteer_evaluate

Execute JavaScript in the browser console. This tool allows you to run custom JavaScript code within the browser context.

Parameters:

  • script (string, required): JavaScript code to execute

JSON Config

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
    }
  }
}

Useful Links

Information