Query Custom Taxonomy Terms is a WordPress ability from Advanced Custom Fields — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.
Install Free Plugin →Query Custom Taxonomy Terms
Read-onlyList terms from a specific AI-accessible ACF custom taxonomy, with search and filtering.
Requires Advanced Custom Fields (ACF) 6.8.0+ on a WordPress install where the Abilities API is available (native from WordPress 6.9, or via a compatible Abilities/Feature API polyfill). ACF's global 'Allow AI Access' setting (enable_acf_ai) must be turned on, and each individual field group, custom post type, or custom taxonomy must also have its own 'Allow AI Access' toggle enabled and be exposed in the REST API (show_in_rest) before its abilities are registered. Most abilities additionally require the current user to hold ACF's configured management capability (acf_get_setting('capability'), default manage_options) or the matching WordPress post-type/taxonomy capability (create_posts, edit_posts, delete_posts, manage_terms, edit_terms, delete_terms).
What it does
ACF dynamically registers one of these query abilities for every custom taxonomy that is active, has 'Allow AI Access' enabled, and is exposed in the REST API — the ability ID follows the pattern acf/{taxonomy-slug}s (e.g. acf/genres). It proxies directly to that taxonomy's WordPress REST API collection endpoint, so results follow the standard WP REST term schema plus any values from AI-accessible ACF field groups attached to the taxonomy. Callers can filter by search term, slug, parent term, or the post a term is assigned to, and control pagination and sort order.
See it in action
You ask your AI assistant
"List all Genre terms, sorted alphabetically by name."
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| per_page | integer | No | Number of terms per page (1-100). Defaults to 10. |
| page | integer | No | Page of results to return. Defaults to 1. |
| search | string | No | Search terms by name. |
| post | integer | No | Limit results to terms assigned to a specific post. |
| slug | array | No | Limit results to terms with specific slugs. |
| parent | integer | No | Filter by parent term ID for hierarchical taxonomies. Use 0 for top-level terms only. |
| orderby | string | No | Sort collection by attribute: id, name, slug, description, or count. Defaults to name. |
| order | string | No | Sort direction: asc or desc. Defaults to asc. |
| hide_empty | boolean | No | Whether to hide terms not assigned to any posts. Defaults to false. |
Returns
A paginated array of terms from the custom taxonomy's REST API collection endpoint, including any AI-accessible ACF field values.
Permission
The current user must have the 'read' capability.
More Advanced Custom Fields abilities
ACF Custom Post Types
List all ACF-registered custom post types that AI is allowed to access.
ACF Custom Taxonomies
List all ACF-registered custom taxonomies that AI is allowed to access.
Create Custom Post Type Item
Create a new item in a specific AI-accessible ACF custom post type.
Create Custom Taxonomy Term
Create a new term in a specific AI-accessible ACF custom taxonomy.
Delete Custom Post Type Item
Delete an item from a specific AI-accessible ACF custom post type by ID.
Delete Custom Taxonomy Term
Delete a term from a specific AI-accessible ACF custom taxonomy by ID.