MCP TOOL
cubeshell.web.screenshotNo valid result, no charge
Web 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.