project_screenshots
Real picture of the deployed site for each recent version. The platform captures a desktop screenshot of the project's homepage after every deploy and stores it alongside the version history. Answers "what does this app look like right now" (e.g. for design / visual-editor workflows) and "did the last deploy change the way the homepage renders" (regression spot-check).
An optional version filters to a specific deploy.
By DEFAULT returns metadata only per screenshot (version, viewport, captured_at, size_bytes) — the large inline base64 image bytes are omitted to keep your context lean. include_data: true returns each as a data_url (data:image/png;base64,...) you can render with <img src={data_url}>; the browser tool sees and inspects the live page.
Example:
{ "project_id": "my-saas" }
// Returns (metadata only — data_url omitted by default):
{
"project_id": "my-saas-uuid",
"screenshots": [
{ "version": 12, "viewport": "desktop", "captured_at": "2026-05-19T...", "size_bytes": 142_321 },
{ "version": 11, "viewport": "desktop", "captured_at": "2026-05-18T...", "size_bytes": 138_004 }
]
}
// With include_data:true, each entry also contains: "data_url": "data:image/png;base64,..."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": {
"project_id": "<project_id>"
},
"name": "project_screenshots"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| version | No | Optional — filter to a single deploy version. | |
| project_id | Yes | Project ID (UUID), subdomain, or slug — resolved server-side, no UUID lookup needed. 'default' also works when the account has exactly one project; multi-project accounts must name one (the error lists them). | |
| include_data | No | Optional, default false. When false (default) the response omits the large inline base64 image bytes and returns metadata only — keeps your context lean. true returns the pixels. |