Kadence Blocks
These abilities register when Kadence Blocks is detected on the site and a Pro licence is active. If either is missing the module stays absent rather than failing at call time.
At a glance
Kadence Blocks registers 3 abilities: 3 that only read, 0 that write, and 0 marked destructive. That split is the practical answer to how much of this module can run unattended. Reads cost nothing and are safe to repeat, so discovery is the part to be generous with; the writes are where review belongs, and the destructive calls stop for an explicit confirmation every single time regardless of which profile is active.
What this module is for
Expose Kadence Blocks discovery and schema information to AI clients, then use WPPilot's guarded Gutenberg workflow to prepare content changes.
Before you rely on it: Use the block editor finalization step to catch theme and responsive differences.
Typical workflows
- Choose the right Kadence block for a content goal
- Validate block attributes before insertion
- Prepare a batch for review in the block editor
The Kadence Blocks integration page covers the same module from the workflow side, with the capability map and the questions worth asking before a first write.
Availability on your site
The Kadence Blocks module needs three things at once: WPPilot Free as the MCP foundation, an active Pro licence, and the companion plugin detected on the site. Miss any one and the module does not register, which is deliberate: an ability that appears in the tool list but fails at call time is worse than an ability that was never offered. What the connected agent can actually call is then narrowed twice more: by the safety profile active on the site, and by the WordPress capabilities of the user behind the credential. A read that succeeds for an administrator can be absent entirely for an editor.
Every write these abilities perform is recorded in the change ledger, and destructive calls can be routed through the approval queue so a person signs off before anything is applied. A successful tool result means the operation returned, not that the front end, the cache, and every dependent template are correct: that still needs a look.
Reads
Available in every safety profile, including Read Only. Inspection costs nothing and is not rate limited.
| Ability | What it does |
|---|---|
wppilot/kadenceblocks-check-setupCheck Kadence Blocks Setup | Reports the presence + version of Kadence Blocks (free) and Kadence Blocks Pro, plus the count of registered blocks per family. This integration is an introspection layer ONLY — it does NOT read or write post_content. To read or write block trees on a post, use the wppilot/gutenberg-* abilities exposed by the base WPPilot plugin. Note: Kadence Blocks Pro extends the same kadence/* namespace as the free plugin (unlike GenerateBlocks which uses a separate generateblocks-pro/* namespace). The free/Pro distinction is recovered by inspecting each block's render_callback class — surfaced here as a count per family for at-a-glance sanity checks. |
wppilot/kadenceblocks-get-block-schemaGet Kadence Block Schema | Returns the full attribute schema, nesting constraints, and supports map for a single Kadence-family block. Attributes come straight from WP_Block_Type::$attributes — each key carries type, default, enum when relevant, and any other JSON Schema fields the block author declared. parent / ancestor are nesting constraints. uses_context lists the block-context keys this block reads from ancestors. Pair this with kadenceblocks-list-blocks (catalogue lookup) and wppilot/gutenberg-add-pending-change (write path). |
wppilot/kadenceblocks-list-blocksList Kadence Blocks | Lists every block registered in the kadence/* namespace as a compact catalogue: name, title, family (free/pro), category, is_dynamic, attribute count, plus parent / ancestor nesting hints. Use this to browse the catalogue before calling kadenceblocks-get-block-schema for the full attribute schema of a specific block. Output is intentionally lean (no attribute schemas) — call get-block-schema only on the block you intend to author. |