web_screenshot
Screenshot a web page, with no session.
Opens a URL in a fresh browser and returns a screenshot of it. It does not use or create a session. Use it for a quick look at a page. To see the page a session is on, use browser_screenshot.
Inputs
| Name | Type | Default | Allowed values | Description |
|---|---|---|---|---|
urlrequired | string | – | – | The page to screenshot. |
fullPage | boolean | false | – | Capture the whole page, not only the first screen. |
Example call
This is what an MCP client sends. You do not write it yourself: ask the model in plain words and it calls the tool.
{ "name": "web_screenshot", "arguments": { "url": "https://example.com", "fullPage": true }}What it returns
An image (JPEG, quality 60) as MCP image content.
[image/jpeg]When a call fails, the result is marked as an error. Its text starts with the API’s error code, such as unauthorized or session_not_running, followed by its message.
Annotations
The server tells every client what this tool does to the world, so a client can decide what to ask you about before it runs.
| Annotation | Value |
|---|---|
title | Screenshot a web page |
readOnlyHint | true |
destructiveHint | false |
openWorldHint | true |
Good to know
- Your plan must include the quick web APIs (fetch, screenshot and PDF).
The same thing with the API
| Endpoint | Reference |
|---|---|
POST /v1/screenshot | Screenshot a page |
These docs describe a beta API. Endpoints, fields and SDK methods may change before general availability; breaking changes will be listed in the changelog.