MCP TOOLcubeshell.web.screenshot

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.