MCP TOOL
cubeshell.web.screenshotWeb Screenshot
Captures one exact public page as PNG, JPEG, or WebP. It does not search, sign in, accept cookies, or perform interactive browser actions.
i
Price
A successful valid screenshot costs 7.50 Cubeshell credits. A definitive failure is not charged. Cubeshell returns the image and exact receipt together.
Request
| Parameter | Type | Description |
|---|---|---|
request_idrequired | string | Stable idempotency key. Replay the same input with the same ID to avoid a second call or charge. |
quote_onlyrequired | false | Must be false in the current direct-execution contract. |
input.urlrequired | public HTTP(S) URL | One public page. Credentials, private hosts and nonstandard ports are rejected. |
input.full_pagerequired | boolean | true captures the page; false captures the requested viewport. |
input.widthrequired | integer 320–1920 | Viewport width in pixels. |
input.heightrequired | integer 240–1080 | Viewport height in pixels. |
input.formatrequired | "png" | "jpeg" | "webp" | Returned image format. |
max_microcredits | integer | Optional ceiling. Set 7500000 to permit the current 7.50-credit price. |
tools/call
{
"name": "cubeshell.web.screenshot",
"arguments": {
"request_id": "screenshot-homepage-001",
"quote_only": false,
"max_microcredits": 7500000,
"input": {
"url": "https://example.com/",
"full_page": false,
"width": 1280,
"height": 720,
"format": "png"
}
}
}Result
| Parameter | Type | Description |
|---|---|---|
result.url | string | Normalized requested URL. |
result.mime_type | image/png | image/jpeg | image/webp | Validated image media type. |
result.data_base64 | base64 string | Validated inline image, bounded to 4 MiB decoded. |
result.width | integer | Requested viewport width. |
result.height | integer | Requested viewport height. |
result.full_page | boolean | Whether full-page capture was requested. |
!
Public pages only
Do not send secrets or logged-in pages. Cubeshell validates the target before execution and again after DNS resolution, and never follows a provider-returned image URL.