Check how a page build is going
get_buildUses no credits. Returns the build's status and, once finished, the complete page. A build takes about 10 to 20 minutes, so poll it with wait set to 300: the call holds open and returns the moment the stage moves or the page is ready, which turns a build from dozens of identical reads into a handful of calls that each have something to report. When a call comes back with the same stage you already mentioned, say nothing and call again rather than paraphrasing yourself. A status of running is non-terminal and contains no page. By default the HTML is summarised rather than returned in full, because a page is tens of thousands of characters and would flood the conversation. Set include_html when the user actually wants the file, for example to save it locally and open it. Includes elapsed_seconds: the true age of the build, measured server side from its start timestamp.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"build_run_id": "<build_run_id>"
},
"name": "get_build"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wait | No | Seconds to wait for a material change. Use 25 for broad client compatibility; longer waits are available for hosts that support them. A timeout preserves the run; resume by ID instead of starting again. | |
| build_run_id | Yes | ||
| include_html | No | Return the full page HTML. Large. Default false. |