PageBolt MCP Server

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)
• List device presets — 25+ devices (iPhone, iPad, MacBook, Galaxy, etc.)
• Check usage — monitor your API quota 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:

{
  "mcpServers": {
    "pagebolt": {
      "command": "npx",
      "args": ["-y", "pagebolt-mcp"],
      "env": {
        "PAGEBOLT_API_KEY": "pf_live_your_key_here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project (or global config):

{
  "mcpServers": {
    "pagebolt": {
      "command": "npx",
      "args": ["-y", "pagebolt-mcp"],
      "env": {
        "PAGEBOLT_API_KEY": "pf_live_your_key_here"
      }
    }
  }
}

Windsurf

Add to your Windsurf MCP settings:

{
  "mcpServers": {
    "pagebolt": {
      "command": "npx",
      "args": ["-y", "pagebolt-mcp"],
      "env": {
        "PAGEBOLT_API_KEY": "pf_live_your_key_here"
      }
    }
  }
}

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: <h1>Hello World</h1>"

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, fill, select, hover, scroll, wait, wait_for, evaluate, screenshot, pdf

Example prompts:

• "Go to https://example.com, click the pricing link, then screenshot both pages"
• "Navigate to the login page, fill in test credentials, submit, and screenshot the dashboard"

inspect_page

Inspect a web page and get a structured map of all interactive elements, headings, forms, links, and images — each with a unique CSS selector.

Key parameters: url/html, width, height, viewportDevice, darkMode, cookies, headers, authorization, blockBanners, blockAds, waitUntil, waitForSelector

Example prompts:

• "Inspect https://example.com and tell me what buttons and forms are on the page"
• "What interactive elements are on the login page? I need selectors for a sequence"

Tip: Use inspect_page before run_sequence to discover reliable CSS selectors instead of guessing.

record_video

Record a professional demo video of a multi-step browser automation sequence with cursor effects, click animations, and smooth movement.

Key parameters:

• steps — same actions as run_sequence (except no screenshot/pdf — the whole sequence is the video)
• format — mp4, webm, or gif (default: mp4; webm/gif require Starter+)
• framerate — 24, 30, or 60 fps (default: 30)
• pace — speed preset: "fast", "normal", "slow", "dramatic", "cinematic", or a number 0.25–6.0
• cursor — style (highlight/circle/spotlight/dot), color, size, smoothing
• clickEffect — style (ripple/pulse/ring), color
• zoom — auto-zoom on clicks with configurable level and duration
• saveTo — output file path

Example prompts:

• "Record a video of logging into https://example.com with a spotlight cursor"
• "Make a demo video of the signup flow at slow pace, save as demo.mp4"

list_devices

List all 25+ available device presets with viewport dimensions.

Example prompt:

• "What device presets are available for screenshots?"

check_usage

Check your current API usage and plan limits.

Example prompt:

• "How many API requests do I have left this month?"

---

Prompts

Pre-built prompt templates for common workflows. In clients that support MCP prompts, these appear as slash commands.

/capture-page

Capture a clean screenshot of any URL with sensible defaults (blocks banners, ads, chats, trackers).

Arguments: url (required), device, dark_mode, full_page

/record-demo

Record a professional demo video. The agent inspects the page first to discover selectors, then builds a video recording sequence.

Arguments: url (required), description (required — what the demo should show), pace, format

/audit-page

Inspect a page and get a structured analysis of its elements, forms, links, headings, and potential issues.

Arguments: url (required)

---

Resources

pagebolt://api-docs

The full PageBolt API reference as a text resource. AI agents that support MCP resources can read this for detailed parameter documentation beyond what fits in tool descriptions. Content is fetched from the live llms-full.txt endpoint.

---

Configuration

Environment Variable	Required	Default	Description
PAGEBOLT_API_KEY	Yes	—	Your PageBolt API key (get one free)
PAGEBOLT_BASE_URL	No	https://pagebolt.dev	API base URL

---

Pricing

Plan	Price	Requests/mo	Rate Limit
Free	$0	100	10 req/min
Starter	$29/mo	5,000	60 req/min
Growth	$79/mo	25,000	120 req/min
Scale	$199/mo	100,000	300 req/min

Free plan requires no credit card. Starter and Growth include a 14-day free trial.

---

Why PageBolt?

• 6 APIs, one key — screenshot, PDF, OG image, browser automation, video recording, page inspection. Stop paying for separate tools.
• Clean captures — automatic ad blocking, cookie banner removal, chat widget suppression, tracker blocking.
• 25+ device presets — iPhone SE to Galaxy S24 Ultra, iPad Pro, MacBook, Desktop 4K.
• Ship in 5 minutes — plain HTTP, no SDKs required, works in any language.
• Inline results — screenshots and OG images appear directly in your AI chat.

---

Links

• Website: pagebolt.dev
• API Docs: pagebolt.dev/docs.html
• npm: npmjs.com/package/pagebolt-mcp
• Issues: github.com/Custodia-Admin/pagebolt-mcp/issues

---

License

MIT