List block usage
list_block_usageReport where each block type is stored across draft, published, layout, and developer surfaces, with counts, pages, and orphan or unused status to guide migration or removal before code changes.
Instructions
Show where each block type is stored across the workspace: draft and published page blocks, layout regions (draft and published) and developer drafts, with per-surface counts and the pages that hold it. registered says whether the active block manifest still declares the type; orphanTypes lists types stored but no longer registered (the site renders nothing for them), unusedTypes lists registered types no page uses. Use it before renaming or removing a block type in code, then migrate or remove the instances it lists with update_block_content / remove_block_from_page.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_block_usage"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| types | No | Only report these block types. Omit to report every type the workspace stores or registers. | |
| includeHistory | No | Also count the page version history, including versions of deleted pages. Off by default. |