Custodia-Admin/pagebolt-mcp

Take screenshots, generate PDFs, create OG images, inspect pages, and record demo videos directly from your AI coding assistant.
**Works with Claude Desktop, Cursor, Windsurf, Cline, and any MCP-compatible client.**
---
What It Does
PageBolt MCP Server connects your AI assistant to PageBolt's web capture API, giving it the ability to:
- **Take screenshots** of any URL, HTML, or Markdown (30+ parameters)
- **Generate PDFs** from URLs or HTML (invoices, reports, docs)
- **Create OG images** for social cards using templates or custom HTML
- **Run browser sequences** — multi-step automation (navigate, click, fill, screenshot)
- **Record demo videos** — browser automation as MP4/WebM/GIF with cursor effects, click animations, and auto-zoom
- **Inspect pages** — get a structured map of interactive elements with CSS selectors (use before sequences)
- **Observe pages for agents** — compact, token-budgeted observation with an optional flatdomtree mode for browser-use / page-agent interop
- **Import agent traces** — turn a browser-use / page-agent action trace into a re-runnable PageBolt sequence
- **List device presets** — 25+ devices (iPhone, iPad, MacBook, Galaxy, etc.)
- **Check usage & track async jobs** — monitor your API quota and long async video renders in real time
All results are returned inline — screenshots appear directly in your chat.
---
Quick Start
1. Get a free API key
Sign up at pagebolt.dev — the free tier includes 100 requests/month, no credit card required.
2. Install & configure
Claude Desktop
Add to ~/.claude/claude_desktop_config.json:
Cursor
Add to .cursor/mcp.json in your project (or global config):
Windsurf
Add to your Windsurf MCP settings:
Cline / Other MCP Clients
Same config pattern — set command to npx, args to ["-y", "pagebolt-mcp"], and provide your API key in env.
3. Try it
Ask your AI assistant:
> "Take a screenshot of https://github.com in dark mode at 1920x1080"
The screenshot will appear inline in your chat.
---
Tools
take_screenshot
Capture a pixel-perfect screenshot of any URL, HTML, or Markdown.
**Key parameters:**
- url / html / markdown — content source
- width, height — viewport size (default: 1280x720)
- viewportDevice — device preset (e.g. "iphone_14_pro", "macbook_pro_14")
- fullPage — capture the entire scrollable page
- darkMode — emulate dark color scheme
- format — png, jpeg, or webp
- blockBanners — hide cookie consent banners
- blockAds — block advertisements
- blockChats — remove live chat widgets
- blockTrackers — block tracking scripts
- extractMetadata — get page title, description, OG tags alongside the screenshot
- selector — capture a specific DOM element
- delay — wait before capture (for animations)
- cookies, headers, authorization — authenticated captures
- geolocation, timeZone — location emulation
- ...and 15+ more
**Example prompts:**
- "Screenshot https://example.com on an iPhone 14 Pro"
- "Take a full-page screenshot of https://news.ycombinator.com with ad blocking"
- "Capture this HTML in dark mode: Hello World "
generate_pdf
Generate a PDF from any URL or HTML content.
**Parameters:** url/html, format (A4/Letter/Legal), landscape, margin, scale, pageRanges, delay, saveTo
**Example prompts:**
- "Generate a PDF of https://example.com and save it to ./report.pdf"
- "Create a PDF from this invoice HTML in Letter format, landscape"
create_og_image
Create Open Graph / social preview images.
**Parameters:** template (default/minimal/gradient), html (custom), title, subtitle, logo, bgColor, textColor, accentColor, width, height, format
**Example prompts:**
- "Create an OG image with title 'How to Build a SaaS' using the gradient template"
- "Generate a social card with a dark blue background and white text"
run_sequence
Execute multi-step browser automation.
**Actions:** navigate, click, dblclick, fill, select, hover, scroll, wait, wait_for, evaluate, press_key, screenshot, pdf, diff
**observeAfterEachStep** (optional, **free**): attaches a compact state snapshot (page type + top interactive elements + suggested actions, no screenshot) to each step result, so an agent can confirm what's on screen — e.g. that a dropdown opened — and pick the right selector for its next call without blind-batching.
**Example prompts:**