home / mcp / webshot mcp server

Webshot MCP Server

A MCP server for generating web page screenshots using Playwright

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "bingal-webshot-mcp": {
      "command": "uvx",
      "args": [
        "webshot-mcp"
      ]
    }
  }
}

This MCP server lets you generate web page screenshots using PagePlaywright, supporting desktop, mobile, and tablet views across multiple image formats. It runs asynchronously for fast processing and can be integrated with MCP clients to automate screenshot tasks across many pages and configurations.

How to use

You connect to the webshot MCP server from your MCP client and request screenshots by specifying the target URL, output file, and optional settings such as device type, size, format, and quality. Common workflows include creating full-page screenshots, capturing mobile or tablet views, and producing batch screenshots for multiple URLs. Use the client’s MCP protocol to send a request and receive the resulting image file at the location you specify.

How to install

Prerequisites: you need Python installed on your system. You may also use a runtime tool to host MCP servers (uvx) or a local executable for the server.

Install the webshot MCP package and the Chromium browser for Playwright to drive screenshots.

Then configure your MCP client to point at the server, using the desired command and arguments.

Configuration and usage examples

If you run the server directly with the runtime, you can expose it to clients by starting the MCP server process with the appropriate entry point and ensuring the server is reachable by the client.

Here is a typical configuration you can place in your MCP client setup to connect to a locally hosted server via the standard stdio path.

{
  "mcpServers": {
    "webshot": {
      "type": "stdio",
      "command": "uvx",
      "args": ["webshot-mcp"]
    }
  }
}

Notes on installation flow

If you prefer a local executable, you can install the package and run the server directly, then connect your MCP client to the local process. The client configuration may reference the local command as shown in the examples.

Available tools

screenshot

Generates a screenshot for a provided URL with options for device type, size, format, and quality.