mcp-easy-ai__wp_list_terms
Lists terms of ANY taxonomy exposed in the REST API — media folders such as mlo-category, product categories and brands (product_cat, product_brand), ACF or other custom taxonomies, as well as category and post_tag. Use wp_get_taxonomies to discover the taxonomy slugs. Required: taxonomy (the taxonomy slug). Optional: search, parent (filter by parent ID; use 0 for top-level only), per_page (default 100), page, orderby (id/term_id/name/slug/count/include/term_group/description/parent/term_taxonomy_id/none/meta_value/meta_value_num — default name), order (asc/desc), hide_empty (boolean, default false), and the get_terms() filters include / exclude / exclude_tree / term_taxonomy_id (arrays of IDs), slug / name (arrays of exact values), child_of (every descendant of a term), childless (boolean), name__like / description__like (substring), pad_counts (boolean: add descendants' counts to each parent's count), meta_key with optional meta_value and meta_compare (needs … Through Royally: its server marks it read-only, so it runs straight away.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Only terms with one of these names (the whole name, not a part of it; see name__like for that). | |
| page | No | Page number for pagination. | |
| slug | No | Only terms with one of these slugs. | |
| order | No | Sort direction. | asc |
| parent | No | Parent term ID to filter by (hierarchical taxonomies only; 0 for top-level terms). | |
| search | No | Search query to filter terms. | |
| exclude | No | Leave out these term IDs. | |
| include | No | Only these term IDs. WordPress ignores exclude and exclude_tree when include is given, so they cannot be combined. | |
| orderby | No | Field to order results by. term_id is the same as id; include keeps the order of `include`; none leaves the database order; meta_value and meta_value_num (numeric) sort by the value of `meta_key`, which they require. | name |
| site_id | No | Site to run this tool on: 8ef2e52b-bd07-4671-a363-ebe8b480b65c (https://demo.royalplugins.com) | |
| child_of | No | Only descendants (children, grandchildren and so on) of this term ID. Hierarchical taxonomies only; cannot be combined with a parent above 0, which WordPress lets override it. total and total_pages then count the descendants (counted separately, since WordPress's own total ignores child_of). | |
| meta_key | No | Only terms that have this term meta key (in plain printable ASCII, no spaces). Needs the taxonomy's edit_terms capability, the one reading term meta needs; a protected key (starting with an underscore) also needs manage_options. Also the key orderby meta_value / meta_value_num sorts by. | |
| per_page | No | Number of terms per page (1-100). | |
| taxonomy | Yes | The taxonomy slug (e.g. category, post_tag, product_cat, mlo-category). Use wp_get_taxonomies to list the available slugs. | |
| childless | No | true: only terms that have no children. | |
| hide_empty | No | Whether to hide terms with no objects assigned. | |
| meta_value | No | With meta_key: only terms whose value for that key matches (see meta_compare). Requires meta_key; must not be empty (to match any value use meta_compare EXISTS). | |
| name__like | No | Only terms whose name contains this text. | |
| pad_counts | No | true: each term's count also includes the objects of its descendants. Hierarchical taxonomies only (a flat taxonomy has no descendants). | |
| include_url | No | true: add each term's archive URL as `url`. Default false. | |
| exclude_tree | No | Leave out these term IDs and every descendant of each. | |
| meta_compare | No | With meta_key: how meta_value is compared. Default "=". IN and NOT IN take a comma-separated meta_value, BETWEEN and NOT BETWEEN exactly two comma-separated values; EXISTS and NOT EXISTS need no meta_value. | |
| term_taxonomy_id | No | Only terms with these term_taxonomy_id values. | |
| description__like | No | Only terms whose description contains this text. |