bricks_get_page_summary
Phase 1BeginnerRead OnlyComplexity: 2/10
Get a condensed section-by-section overview of a page
Overview
Retrieves a condensed, section-by-section overview of a Bricks page. Shows the page structure with headings, text previews, image counts, and element counts per section without fetching the full element tree. This is significantly lighter than bricks_get_page_content and ideal for understanding page layout at a glance.
Key Features
Section-by-section overview
Breaks down the page into its root sections with heading text, content previews, and image counts for each section.
Lightweight alternative
Much smaller response than bricks_get_page_content — ideal for understanding structure without the full element payload.
Content area support
Can summarize different content areas (content, header, footer) separately.
When to Use
When you need to understand the structure of an existing page before modifying it
When you want a quick count of sections, headings, and images on a page
Before deciding which section to replace, reorder, or delete
When you need an overview without the overhead of the full element data
When debugging page layout issues — quickly see which sections exist and their content summaries
When you want a quick count of sections, headings, and images on a page
Before deciding which section to replace, reorder, or delete
When you need an overview without the overhead of the full element data
When debugging page layout issues — quickly see which sections exist and their content summaries
Prerequisites
The page must exist (valid page_id)
The page should have Bricks content — returns empty summary for pages without Bricks data
The page should have Bricks content — returns empty summary for pages without Bricks data
When NOT to Use
When you need the full element tree with all settings — use bricks_get_page_content instead
When you need to find a specific element by ID or ref — use bricks_get_element_by_ref instead
When you need to search for text across multiple pages — use bricks_search_content instead
When you need to find a specific element by ID or ref — use bricks_get_element_by_ref instead
When you need to search for text across multiple pages — use bricks_search_content instead
Parameters
2 Total Parameters1 Required1 Optional
page_idnumberREQUIREDPage ID to summarize.
content_areastringoptionalContent area to summarize.
Default:
content Values: content, header, footerCode Examples
Warning: Undefined array key "example_description" in /var/www/vhosts/mcpbricksbuilder.wecode.swiss/httpdocs/wp-content/themes/bricks/includes/elements/code.php(236) : eval()'d code on line 10
Deprecated: preg_replace(): Passing null to parameter #3 ($subject) of type array|string is deprecated in /var/www/vhosts/mcpbricksbuilder.wecode.swiss/httpdocs/wp-includes/kses.php on line 2018
Get page structure overview
JSON
{
"tool": "bricks_get_page_summary",
"params": {
"page_id": 33
}
}Response
{
"total_sections": 5,
"total_elements": 47,
"sections": [
{
"id": "abc123",
"label": "hero-section",
"headings": ["Build Websites with AI"],
"text_preview": "The most powerful MCP server...",
"image_count": 1,
"element_count": 8
},
{
"id": "def456",
"label": "features-section",
"headings": ["110+ Tools", "Key Features"],
"text_preview": "Design system, pages, templates...",
"image_count": 0,
"element_count": 15
}
]
}Common Mistakes
Warning: Undefined array key "fix_description" in /var/www/vhosts/mcpbricksbuilder.wecode.swiss/httpdocs/wp-content/themes/bricks/includes/elements/code.php(236) : eval()'d code on line 47
Deprecated: preg_replace(): Passing null to parameter #3 ($subject) of type array|string is deprecated in /var/www/vhosts/mcpbricksbuilder.wecode.swiss/httpdocs/wp-includes/kses.php on line 2018
Warning: Undefined array key "wrong_code" in /var/www/vhosts/mcpbricksbuilder.wecode.swiss/httpdocs/wp-content/themes/bricks/includes/elements/code.php(236) : eval()'d code on line 48
Warning: Undefined array key "right_code" in /var/www/vhosts/mcpbricksbuilder.wecode.swiss/httpdocs/wp-content/themes/bricks/includes/elements/code.php(236) : eval()'d code on line 49
If you only need to understand page structure, use get_page_summary instead of get_page_content. The summary is much lighter and faster, saving tokens and API calls.
Warning: Undefined array key "fix_description" in /var/www/vhosts/mcpbricksbuilder.wecode.swiss/httpdocs/wp-content/themes/bricks/includes/elements/code.php(236) : eval()'d code on line 47
Deprecated: preg_replace(): Passing null to parameter #3 ($subject) of type array|string is deprecated in /var/www/vhosts/mcpbricksbuilder.wecode.swiss/httpdocs/wp-includes/kses.php on line 2018
Warning: Undefined array key "wrong_code" in /var/www/vhosts/mcpbricksbuilder.wecode.swiss/httpdocs/wp-content/themes/bricks/includes/elements/code.php(236) : eval()'d code on line 48
Warning: Undefined array key "right_code" in /var/www/vhosts/mcpbricksbuilder.wecode.swiss/httpdocs/wp-content/themes/bricks/includes/elements/code.php(236) : eval()'d code on line 49
If your page has header or footer overrides, the default "content" area will not show those sections. Specify content_area: "header" or "footer" to inspect override areas.
Tips & Warnings
Tips & Warnings
Performance tip: Use bricks_get_page_summary as your first step when working with an existing page. It gives you enough context to decide which sections to modify without the overhead of fetching all element data.
Workflow tip: Combine with bricks_get_element_by_ref after identifying the section you need — summary gives you the section labels, then you can fetch specific elements by their ref names.
Return Values
Related Tools
Technical Details
Changelog
v1.0
Initial release
20250101