Take a screenshot
grabCapture a screenshot of any public web page by URL and get back a hosted image, with no local headless browser, Chromium, Playwright, or Puppeteer to install or run. Hosted rendering handles cookie and consent banners, lazy-loaded and JavaScript-heavy pages, and full-page capture. Reach for this whenever you need to SEE a page: verifying your own UI/frontend work, capturing a live site, or feeding a real rendered image into a vision step. Live grabs cost 1 credit ($0.002 flat); test-environment keys return free placeholders. Returns the image inline by default plus the hosted URL and your remaining credits. Wraps the Grabbit screenshot API (POST /v1/grabs; same parameters): https://grabbit.live/screenshot-api
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": "grab"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Absolute http/https URL to capture (e.g. https://nyt.com) | |
| width | No | Viewport width (default 1280) | |
| format | No | Image format (default png) | |
| height | No | Viewport height (default 720; ignored when full_page) | |
| delay_ms | No | Settle delay before capture | |
| selector | No | CSS selector to capture a single element | |
| full_page | No | Capture the full page height | |
| return_image | No | Inline the image in the response (default true; set false to save tokens) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Grab id. | |
| bytes | No | Image size in bytes. | |
| width | No | Viewport width in pixels. | |
| format | No | Image format. | |
| height | No | Viewport height in pixels (3240 in the response for full_page captures). | |
| status | Yes | Lifecycle state. Only done grabs have an image_url. | |
| image_url | No | Hosted image URL once status is done (relative for sk_test_ placeholders). | |
| created_at | No | ISO 8601 creation time. | |
| target_url | No | The captured URL. | |
| execution_ms | No | Render time in milliseconds. | |
| error_message | No | Why a failed grab failed. | |
| credits_remaining | No | Team credits left after this grab (live keys only). |