readfetch_screenshot
Paid routes require a funded Base USDC wallet. Use readfetch-client / @readfetch/client or the MCP signing proxy (@readfetch/mcp-x402-proxy). Direct calls without a signing client will stop at 402. Screenshot a public URL in headless Chromium (page JavaScript runs; no ad blocker) and return PNG or JPEG in JSON — image_base64, mime, width, height, status_code, billed (not a hosted URL). Scope: viewport only (full_page: false), full scrollable page (default), or one element (selector). mode caps total render time: fast (15 s), render (30 s, default), full (60 s, always full-page regardless of full_page). Set width/height before navigation (default 1280×800, max 3840×2160). delay_ms (0–30000) waits after navigation, then captures — raise it or use mode=full for slow SPAs and lazy media. Prefer readfetch_text or readfetch_scrape for extractable text; readfetch_pdf for PDF files; readfetch_fetch for raw HTTP without rendering. Read-only on the origin (GET + render, no form POST). Bot-check or blank frames may still return pixels with billed: false and a hint; paid x402 like other routes.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"url": "<url>"
},
"name": "readfetch_screenshot"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Public http(s) URL to render in headless Chromium. | |
| mode | No | Whole-call budget: fast (15 s), render (30 s, default), or full (60 s; always captures the full scrollable page). | render |
| width | No | Viewport width in pixels before navigation (default 1280, max 3840). | |
| format | No | Image encoding for `image_base64` (png default, or jpeg). | png |
| height | No | Viewport height in pixels before navigation (default 800, max 2160). | |
| delay_ms | No | Milliseconds to wait after navigation before capture (0–30000); use for SPAs and lazy-loaded content. | |
| selector | No | CSS selector — capture that element's box only. Omit for page/viewport per full_page. | |
| full_page | No | true (default): entire scrollable document; false: viewport only. Ignored when mode=full. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | ||
| hint | No | ||
| mime | No | ||
| size | No | ||
| width | No | ||
| billed | No | ||
| format | No | ||
| height | No | ||
| status | No | ||
| status_code | No | ||
| image_base64 | No | ||
| content_sha256 | No |