filePathstring
Absolute or relative path to the image file
sourceUrlstring
URL to download the image from (max 50MB, 30s timeout). SSRF filtering active on https:. Set TILER_DENY_HTTP_PRIVATE=1 to block private IPs on http:
dataUrlstring
Data URL with base64-encoded image (e.g. "data:image/png;base64,...")
imageBase64string
Raw base64-encoded image data (no data URL prefix)
urlstring
URL of the web page to capture. Requires Chrome/Chromium installed.
viewportWidthinteger
Browser viewport width in pixels. Defaults to 1280 for desktop, 390 when mobile is true.
waitUntilenum
When to consider the page loaded: "load" (default), "networkidle", or "domcontentloaded"
delayinteger
Additional delay in ms after the page is loaded, before capturing (default: 3000)
mobileboolean
Whether to emulate a mobile device. When true, defaults viewportWidth to 390, deviceScaleFactor to 2, and sets a mobile user agent if not explicitly provided.
deviceScaleFactornumber
Device pixel ratio (e.g., 2 for retina). Defaults to 1 for desktop, 2 when mobile is true.
userAgentstring
Custom user agent string
screenshotPathstring
Path to a previously captured screenshot. When provided and accessible, skips URL capture.
tilesDirstring
Path to the tiles directory (returned as outputDir from a previous tiling call). When provided, returns tiles as base64 images for pagination.
startinteger
Start tile index (0-based, inclusive). Used with tilesDir for pagination.
endinteger
End tile index (0-based, inclusive). Defaults to start + 4. Max 5 tiles per batch to stay within MCP response limits.
skipBlankTilesboolean
Skip blank tiles in get-tiles mode, returning text annotations instead of images. Set to false to include all tiles. Default: true.
presetenum
DO NOT provide on Phase 1 (first call). Only specify on Phase 2 after the user has chosen from the comparison table. Available: "claude" (1092px tiles, ~1590 tokens/tile), "openai" (768px tiles, ~765 tokens/tile), "gemini3" (1536px tiles, ~1120 tokens/tile), "gemini" (768px tiles, ~258 tokens/tile). Auto-selects cheapest when omitted on Phase 2.
modelenum
Deprecated: use "preset" instead. Accepted for backward compatibility. Available: "claude" (1092px tiles, ~1590 tokens/tile), "openai" (768px tiles, ~765 tokens/tile), "gemini3" (1536px tiles, ~1120 tokens/tile), "gemini" (768px tiles, ~258 tokens/tile).
tileSizeinteger
Tile size in pixels. If omitted, uses the model's optimal default (Claude: 1092, OpenAI: 768, Gemini 3: 1536, Gemini: 768). Values outside the model's supported range are automatically clamped with a warning.
maxDimensioninteger
Max dimension in px (0 to disable, or 256-65536). When set, the image is resized so its longest side fits within this value before tiling. Reduces token consumption for large images. Defaults to 10000px. Set to 0 to disable auto-downscaling.
outputDirstring
Directory to save tiles. Defaults to tiles/{name}_vN/ next to source for filePath; {base}/tiles/tiled_{ts}_{hex}/ for URL/base64 sources; {base}/tiles/capture_{ts}_{hex}/ for captures.
pageinteger
Tile page to return (0 = first 5, 1 = next 5, etc.). Default: 0
formatenum
Output format for tiles: "webp" (smaller, default) or "png" (lossless)
includeMetadataboolean
Analyze each tile and return content hints (blank, low-detail, mixed, high-detail) and brightness stats. Enabled by default; set to false to skip.