MCP TOOLcubeshell.web.screenshot

No 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

ParameterTypeDescription
request_idrequiredstringStable idempotency key. Replay the same input with the same ID to avoid a second call or charge.
quote_onlyrequiredfalseMust be false in the current direct-execution contract.
input.urlrequiredpublic HTTP(S) URLOne public page. Credentials, private hosts and nonstandard ports are rejected.
input.full_pagerequiredbooleantrue captures the page; false captures the requested viewport.
input.widthrequiredinteger 320–1920Viewport width in pixels.
input.heightrequiredinteger 240–1080Viewport height in pixels.
input.formatrequired"png" | "jpeg" | "webp"Returned image format.
max_microcreditsintegerOptional 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

ParameterTypeDescription
result.urlstringNormalized requested URL.
result.mime_typeimage/png | image/jpeg | image/webpValidated image media type.
result.data_base64base64 stringValidated inline image, bounded to 4 MiB decoded.
result.widthintegerRequested viewport width.
result.heightintegerRequested viewport height.
result.full_pagebooleanWhether 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.