copperline-labs/rendex-mcp

MCP server for Rendex — render raw HTML, Markdown, or any URL to an image or PDF via AI agents using the Model Context Protocol.
Quick Start
Claude Desktop / Cursor / Windsurf (npx)
Add to your MCP client config:
**Where to add this:**
| Client | Config location |
|--------|----------------|
| Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) |
| Cursor | .cursor/mcp.json in project root, or Settings > MCP |
| Windsurf | Settings > MCP Servers |
Claude Code (CLI)
Add a .mcp.json to your project root with the same config above. Then restart Claude Code.
> **Important**: Add .mcp.json to your .gitignore — it contains your API key.
Remote (zero-install, OAuth or API key)
Connect to the hosted server at https://mcp.rendex.dev/mcp — no install needed.
It's fronted by **OAuth 2.1** (authorization-code + PKCE S256), so OAuth-capable
clients (ChatGPT, Claude, Cursor, the MCP Inspector) connect with **no API key** —
you sign in with a one-time email code and each caller bills against their own
Rendex plan and credit pool.
Clients that prefer a static key can still pass one directly:
Tools
rendex_screenshot
Render any webpage, raw HTML, or Markdown to an image or PDF.
**Parameters:**
| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| url | string | required* | Webpage URL to capture. Mutually exclusive with html and markdown. |
| html | string | — | Raw HTML to render. Mutually exclusive with url and markdown. |
| markdown | string | — | Markdown to render (server converts to HTML). Mutually exclusive with url and html. |
| data | object | — | Key-value data for Mustache templating. When set, the html or markdown string is rendered as a logic-less Mustache template before capture. Invalid with url. |
| format | "png" \| "jpeg" \| "webp" \| "pdf" | "png" | Output format |
| fullPage | boolean | false | Capture full scrollable page |
| darkMode | boolean | false | Emulate dark color scheme |
| width | number | 1280 | Viewport width (320-3840) |
| height | number | 800 | Viewport height (240-2160) |
| resizeWidth | number | — | Downscale output to this width in px (aspect ratio preserved if resizeHeight omitted). Ignored for PDF |
| resizeHeight | number | — | Downscale output to this height in px (aspect ratio preserved if resizeWidth omitted). Ignored for PDF |
| quality | number | 80 | Image quality 1-100 (JPEG/WebP only, default 80) |
| delay | number | 0 | Wait ms before capture |
| blockAds | boolean | true | Block ads and trackers |
| blockCookieBanners | boolean | — | Hide common cookie/consent banners (GDPR/CCPA) before capture |
| blockResourceTypes | string[] | — | Block resource types: font, image, media, stylesheet, other |
| device | string | — | Device preset: desktop, iphone_15, iphone_se, pixel_8, ipad, ipad_pro — sets viewport, scale, and user agent in one shot. Overrides width/height/deviceScaleFactor/userAgent |
| deviceScaleFactor | number | 2 | Device pixel ratio (1-3). 2× Retina by default |
| timeout | number | 30 | Max seconds to wait for page load (5-60) |
| waitUntil | string | "networkidle2" | Page readiness: load, domcontentloaded, networkidle0, networkidle2 |
| waitForSelector | string | — | CSS selector to wait for before capture |
| bestAttempt | boolean | true | Return partial render on timeout instead of failing |
| selector | string | — | CSS selector of element to capture instead of full page |
| hideSelectors | string[] | — | CSS selectors to hide (display:none) before capture, e.g. ['.modal', '#newsletter-popup']. Max 50 |
| css | string | — | Custom CSS to inject before capture (max 50KB) |
| js | string | — | Custom JavaScript to execute before capture (max 50KB) |
| cookies | array | — | Cookies to set for authenticated captures (max 50) |