PagePixels Screenshots MCP Server

A Model Context Protocol (MCP) server for the PagePixels Screenshot API. Enables AI assistants to capture instant and scheduled screenshots, generate images from raw HTML, take screenshots after performing browser actions, and run AI-powered website domain research using natural language.

Features

• Instant Screenshots — Capture any URL or render raw HTML to an image on demand

• Multi-Step Browser Actions — Click, type, submit forms, navigate pages, and wait for elements before capturing

• Scheduled Screenshots — Create recurring capture configurations on minute, hour, day, week, month, or year intervals

• Real Location Screenshots — Screenshot from 150+ geographical locations (countries, US states, and major cities)

• AI Analysis Screenshots — Capture screenshots and have AI analyze the images guided by custom text prompts

• Custom HTML Screenshots — Create screenshots from HTML and data available in the MCP client

• Multiple Image AI Analysis — Have AI compare up to 5 images and 5 prompts

• Extract HTML — Enable AI to find CSS Selectors and get HTML content from websites that generate their HTML using JavaScript

• Website Domain Research — AI-powered structured data extraction across multiple domains

• Full Configuration Management — Create, read, update, delete, and list screenshot configurations programmatically

• OAuth 2.1 Authentication — Secure, spec-compliant MCP auth via Streamable HTTP transport

Requirements

• A PagePixels account (free tier available — no payment info required)

Quick Start

MCP Server URL

Connect over Streamable HTTP by pointing your client at:

https://mcp.pagepixels.com/mcp

For clients that support remote MCP servers with OAuth, authentication is handled via the standard MCP OAuth 2.1 flow with PKCE — authorize through the browser prompt when first connecting.

Example: Claude.ai Web

1. Open Settings (bottom-left)

2. Select Connectors

3. Click Add custom connector

4. Enter the server URL:

   https://mcp.pagepixels.com/mcp

5. Complete the OAuth authorization when prompted in the browser

Once connected, PagePixels tools will be available in all new conversations.

Tools

Screenshot Capture

Screenshot Configuration Management

Screenshot History

Change Notifications

Domain Research

Multiple Image AI Analysis

Account & Utilities

Usage Examples

Once connected, interact naturally with your AI assistant:

Take a screenshot:

"Take a screenshot of https://example.com in PNG format at 540px wide and remove cookie banners"

Multi-step capture:

"Go to https://example.com, click the login button, fill in the email field with test@example.com, submit the form, then take a full-page screenshot"

Scheduled monitoring:

"Create a screenshot configuration for https://example.com/pricing that captures every 6 hours"

Geo-located capture:

"Screenshot https://example.com from Japan and wait 6000ms before taking the screenshot"

Domain research:

"Research these 5 competitor domains and extract their pricing tiers, founding year, and team size"

Account overview:

"Show me my current usage and remaining credits"

Capture Options

The snap and snap_html tools support extensive configuration:

• Viewport: page_width, page_height, scale_factor (1x or 2x Retina)

• Output: image_format (jpeg, png, webp), quality (1–100 for JPEG), thumbnails

• Full Page: fullpage, fullpage_advanced, incremental_scroll for lazy-loaded content

• Timing: wait (ms delay before capture), wait_for (CSS selector to appear)

• Injection: js_inject, css_inject for custom page modifications

• Privacy: no_ads, no_cookie_banners, no_tracking

• Geo-Location: real_location (150+ locations)

• AI Analysis: analyze_image_with_ai and ai_prompt to analyze a screenshot guided by a custom text prompt

• Custom Cookies & Headers: cookies, headers

• Element Capture: selectors to capture a specific DOM element

• HTML Extraction: html_only to return fully rendered HTML instead of an image

• Caching: ttl to control cache duration (0 for always fresh)

See full list of screenshot options.

Multi-Step Actions

Automate browser interactions before capturing with multi_step_actions:

[
  { "type": "click", "selector": "#login-btn" },
  { "type": "text_field", "selector": "#email", "value": "user@example.com" },
  { "type": "text_field", "selector": "#password", "value": "secret" },
  { "type": "submit" },
  { "type": "wait_for_selector", "selector": ".dashboard" }
]

Supported action types: click, hover, change, redirect, javascript, evaluateJs, css, text_field, select, checkbox, submit, wait, wait_for_selector

Authentication

Authentication is handled through the standard MCP OAuth 2.1 flow with PKCE. When connecting through Claude.ai, Cursor, or other OAuth-capable MCP clients, authorize through the browser prompt when first connecting. No manual API key configuration is needed.

For programmatic access outside of MCP, see the PagePixels API documentation.

Transport

This server uses the MCP Streamable HTTP transport, hosted at:

https://mcp.pagepixels.com/mcp

All MCP clients that support remote Streamable HTTP servers can connect directly. OAuth 2.1 with PKCE is enforced on all connections.

Related

• PagePixels Documentation — Full API reference

• screenshots-pagepixels — Node.js API client

• screenshots-pagepixels (PyPI) — Python API client

• screenshots_pagepixels (RubyGems) — Ruby API client

• Model Context Protocol — MCP specification

License

MIT