Agent Abilities
GitHubGet it free
Product
FeaturesSecurityAll abilitiesIntegrationsBridge overviewBridge plugin directory196

Guides

WordPress MCP serverAbilities API guideElementor MCP

WordPress core abilities

Browse all abilitiesContentTaxonomies & TermsCommentsUsersMediaSite settingsPluginsThemes & stylesBlocksMenusSearch

Integrations

All integrationsWooCommerce52Advanced Custom Fields7Rank Math SEO5Yoast SEO3All in One SEO3Slim SEO2The Events Calendar13Event Tickets3Avada2GeoDirectory4

Bridge, most installed

Elementor Website BuilderYoast SEOWooCommerceAkismet Anti-spamWPFormsRank Math SEOWP Mail SMTPWPCode
Connect
All clientsChatGPTClaude.aiClaude DesktopManusClaude CodeCursorVS CodeWindsurfGemini CLIGetting startedHow connecting works
Resources
Prompt LibraryPlaybooksBlogComparisonsChangelogSupport
DocsGitHubGet it free

Governed ability

List block types

aafm/list-block-typesRead only

List block types is a governed ability in Agent Abilities for MCP, a free WordPress plugin that runs an MCP server on your site.

Lists the block types registered on this site (core, theme and plugin blocks, including ACF blocks), not saved reusable blocks; if aafm-get-block-type is enabled, use it for one block's attributes, supports, styles and, for ACF blocks, its field names and an example payload. Requires the edit-posts capability.

How it is governed

The same model as every ability in the plugin, stated for this one.

  • Off until you enable it

    Like every ability, List block types ships switched off. You turn it on one at a time, and an update never switches on a tool it serves.

  • Reads only

    It reads data and returns it to your client. Nothing on your site is created, changed, or removed.

  • Capability gated

    A connection only sees List block types if the user you connected can run it, and the plugin checks that capability again before it executes.

  • Every call audited

    The call is written to the log in your own database, denials included, with the argument keys and the identifiers it touched, never free-text content.

List block types is one of the 7 governed Blocks abilities. Browse the other Blocks abilities in the catalog.

See it in action

An illustrative run. Your real calls and data stay on your own site.

agent-abilities · auditGoverned
YouList block types on this site.
RunRunning aafm/list-block-types
GateAllowedread capability confirmed
Auditaafm/list-block-types · principal: editor · args: block_id
ResultReturns the data the agent asked for. Nothing on the site changes.

Try it with a prompt

Example requests you could paste to your agent.

  1. Which block types can I use on this site?
  2. List the ACF blocks registered by the theme.
  3. Show me every block type from the plugins on this site, with their titles.

These are illustrative example prompts. The agent runs them as the user you connected, checked against that user's capabilities and written to your audit log.

Frequently asked

Short answers for List block types.

Is this the same as List blocks?

No. List blocks returns your saved reusable blocks (synced patterns). List block types returns the kinds of block registered on the site: core, theme and plugin blocks, ACF blocks included.

What permission does it need?

The edit-posts capability. It stays off until an administrator turns it on, and every call is written to the audit log.

Related abilities

More in Blocks.

Get block type

Read only

Reads one registered block type by name (for example core/group): its attributes, supports, style variations, parent and context rules, and whether it renders on the server. For an ACF block it also lists the field names, types, choices and sub-fields, plus an example block comment that uses field names as data keys (image fields take attachment IDs). Requires the edit-posts capability.

View ability

Get block

Read only

Reads one reusable block by id, including its raw block markup. Requires edit access to that block.

View ability

Create block

Guarded write

Creates a reusable block (published immediately, unless the operator's force-draft setting holds it as a draft). Its markup is sanitized, and the author is always the agent. Requires the publish-posts capability. Put any block styling in the block delimiter attributes, not inline style, or the editor marks the content invalid.

View ability

Update block

Guarded write

Updates a reusable block's title or markup by id. The markup is sanitized. Requires edit access to that block. Put any block styling in the block delimiter attributes, not inline style, or the editor marks the content invalid.

View ability

Delete block

Guarded write

Moves a reusable block to the Trash, where you can restore it. Never a permanent delete. Requires delete access to that block.

View ability

List blocks

Read only

Lists saved reusable blocks (synced patterns), not block types; aafm-list-block-types lists those, if it is enabled. Returns id, title, slug, status, and modified date. No block markup in the list. Response includes total (the query-wide count of matching blocks; each page omits blocks you lack edit access to, so total can exceed the rows returned). Requires the edit-posts capability.

View ability

Back to all abilities

Governed by default, from the first call.

List block types is off until you enable it, scoped to the user you connect, and logged like everything else. Turn on only what you need.

Get it on WordPress.orgRead the docs

Every ability off until you enable it, capability-gated on every call.