ACPT
These abilities register when ACPT 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
ACPT registers 24 abilities: 11 that only read, 8 that write, and 5 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
Work with ACPT field groups, field-type schemas, option pages, post types, taxonomies, and structured values through WPPilot Pro.
Before you rely on it: Treat post-type, taxonomy, and field-schema changes as migrations with backups and rollback plans.
Typical workflows
- Discover the field type schema before creating a group
- Define a content model before writing records
- Review option-page structure before an update
The ACPT 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 ACPT 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/acpt-check-setupCheck ACPT Setup | Reports the ACPT (Advanced Custom Post Types) environment: whether the plugin is active, the version, whether the minimum version is satisfied, whether the Pro license is currently active, and counts of CPTs, taxonomies, meta groups, and option pages defined through ACPT. Call BEFORE any other ACPT ability to verify the runtime is ready. |
wppilot/acpt-get-field-group-schemaGet ACPT Field Group Schema | Returns the schema for one ACPT meta group (field group) identified by name. Default response: identity (id, name, label, context, priority), belongs[] rules, and box_count. Pass include_fields=true to also receive the 3-level hierarchy: meta_boxes[{id, name, label, sort, fields[{id, name, type, label, sort, required, default_value}]}]. For advanced options on a specific field type call wppilot/acpt-get-field-type-schema. |
wppilot/acpt-get-field-type-schemaGet ACPT Field Type Schema | Returns the option matrix for a single ACPT field type. Call this before creating or editing a field to discover what advanced options are available for the given type. Available types (case-sensitive): Text, Textarea, Editor, Number, Range, Email, Url, Password, Phone, Color, Date, DateTime, DateRange, Time, Image, File, Gallery, ImageSlider, Audio, AudioMulti, Video, VideoMulti, Post, PostObject, PostObjectMulti, User, UserMulti, TermObject, TermObjectMulti, Select, SelectMulti, Radio, Checkbox, Toggle, Repeater, FlexibleContent, List, Table, Address, AddressMulti, Embed, Icon, Currency, Country, Rating, Barcode, QRCode, HTML, ID, Length, Weight, Clone. |
wppilot/acpt-get-option-pageGet ACPT Option Page | Returns the full schema for one ACPT-managed option page identified by menu_slug. Includes id, menu_slug, page_title, menu_title, capability, icon, description, position, and children[] (sub-pages with the same shape). |
wppilot/acpt-get-post-typeGet ACPT Post Type | Returns the full schema for one ACPT-managed custom post type identified by name (WP slug). Default response includes identity, supports[], labels, settings, and meta_group_count. Pass include_meta_groups=true to also receive the names and box counts of attached meta groups (without fields — call wppilot/acpt-get-field-group-schema for field details). |
wppilot/acpt-get-taxonomyGet ACPT Taxonomy | Returns the full schema for one ACPT-managed taxonomy identified by slug. Includes id, slug, singular, plural, native, labels, settings, and the CPT names this taxonomy is associated with. |
wppilot/acpt-list-field-groupsList ACPT Field Groups | Returns a lightweight list of ACPT meta groups (field groups). Each entry contains id, name, label, context, priority, and box_count. Optionally filter by belongs_to (customPostType|taxonomy|optionPage|user|comment) and find (the slug/name of the CPT, taxonomy, or option page). Use wppilot/acpt-get-field-group-schema to fetch the full schema with fields for a single group. |
wppilot/acpt-list-option-pagesList ACPT Option Pages | Returns a lightweight list of all ACPT-managed option pages. Each entry includes id, menu_slug, page_title, menu_title, capability, icon, position, and child_count. Use wppilot/acpt-get-option-page to fetch the full schema for one page including its children. |
wppilot/acpt-list-post-typesList ACPT Post Types | Returns a lightweight list of all custom post types registered through ACPT. Each entry contains id, name (the WP post type slug), singular, plural, icon, native flag, and post_count. Use wppilot/acpt-get-post-type to fetch the full schema for a single CPT. |
wppilot/acpt-list-taxonomiesList ACPT Taxonomies | Returns a lightweight list of all custom taxonomies registered through ACPT. Each entry contains id, slug (WP taxonomy slug), singular, plural, native flag, and the list of CPT names it is associated with. Use wppilot/acpt-get-taxonomy to fetch the full schema for one taxonomy. |
wppilot/acpt-read-valuesRead ACPT Values | Reads ACPT meta field values for a target (post, term, user, or option-page). Requires target {type, id} and the meta group name. Pass fields[] as [{box_name, field_name}] pairs to read specific fields; omit to read all fields in all boxes of the group. Returns a values map nested by box_name → field_name → value. Target types: post (id=post_id int), term (id=term_id int), user (id=user_id int), option-page (id=menu_slug string). ACPT does not store meta on comments. |
Writes
Gated by the active profile and your WordPress capabilities. Rate limited to 120 per minute per credential.
| Ability | What it does |
|---|---|
wppilot/acpt-create-field-groupCreate ACPT Field Group | Creates a new ACPT meta group (field group). Required: name (unique slug-like string). Optional: label, display (standard|accordion|vertical_tabs|horizontal_tabs), context (normal|advanced|side), priority (default|high|low|core), belongs[] (location rules), boxes[] (initial meta boxes with fields). belongs[] items: {belongs_to: customPostType|taxonomy|optionPage|user|comment, operator: "=", find: "cpt-slug-or-taxonomy-slug"}. boxes[] items: {name, label?, fields[{name, type, label?, required?, default_value?}]}. |
wppilot/acpt-create-option-pageCreate ACPT Option Page | Creates a new ACPT-managed WordPress admin option page. Required: menu_slug (unique WP admin menu slug), page_title, menu_title. Optional: capability (default: manage_options), icon (dashicons slug or URL), description, position (int, WP menu position), parent_menu_slug (to create a sub-page under an existing option page). |
wppilot/acpt-create-post-typeCreate ACPT Post Type | Creates a new ACPT-managed custom post type. Required: name (WP slug, ≤20 chars, lowercase alphanumeric/dash/underscore), singular, plural. Optional: icon (dashicons slug), supports[] (title|editor|thumbnail|excerpt|revisions|etc.), labels{} (WP label overrides), settings{} (public, show_in_rest, hierarchical, has_archive, menu_position, etc.). Reserved WP slugs (post, page, attachment, revision, nav_menu_item, wp_block, wp_template, wp_template_part, wp_navigation) are rejected. |
wppilot/acpt-create-taxonomyCreate ACPT Taxonomy | Creates a new ACPT-managed custom taxonomy. Required: slug (WP taxonomy slug, ≤32 chars), singular, plural. Optional: post_types[] (CPT slugs to associate), labels{} (WP label overrides), settings{} (public, hierarchical, show_in_rest, etc.). Reserved WP taxonomy slugs are rejected by the ACPT model. |
wppilot/acpt-edit-field-groupEdit ACPT Field Group | Edits an existing ACPT meta group (PATCH for top-level fields; REPLACE for belongs[] and boxes[]). Identify by name. Passing boxes[] replaces the entire box/field structure — include all boxes and fields you want to keep. Uses ACPT's SaveMetaGroupCommand internally so all hooks fire and orphans are cleaned up. |
wppilot/acpt-edit-option-pageEdit ACPT Option Page | Edits an existing ACPT-managed option page (PATCH semantics). Identify by menu_slug. Omitted fields keep their current value. |
wppilot/acpt-edit-post-typeEdit ACPT Post Type | Edits an existing ACPT-managed custom post type (PATCH semantics for top-level fields; REPLACE for supports[] and labels{}). Identify by name. Omitted top-level fields keep their current value. Passing supports[] or labels{} replaces the entire array. |
wppilot/acpt-edit-taxonomyEdit ACPT Taxonomy | Edits an existing ACPT-managed taxonomy (PATCH for top-level fields; REPLACE for labels{}). Identify by slug. Omitted fields keep their current value. |
Destructive
Marked destructive in the source, so each call needs an explicit confirmation flag, every time.
| Ability | What it does |
|---|---|
wppilot/acpt-delete-field-groupDelete ACPT Field Group | Permanently deletes an ACPT meta group and all its boxes and fields. Field value data stored in wp_postmeta / wp_termmeta / etc. is NOT automatically deleted. Idempotent: deleting a non-existent name returns deleted=false. |
wppilot/acpt-delete-option-pageDelete ACPT Option Page | Permanently deletes an ACPT-managed option page. Idempotent: deleting a non-existent menu_slug returns deleted=false. |
wppilot/acpt-delete-post-typeDelete ACPT Post Type | Permanently removes an ACPT-managed custom post type from ACPT's registry. By default leaves existing posts in wp_posts (they become orphaned with an unregistered post_type). Pass delete_posts=true to also delete all posts of this type from wp_posts. Idempotent: deleting a non-existent name returns deleted=false. |
wppilot/acpt-delete-taxonomyDelete ACPT Taxonomy | Permanently removes an ACPT-managed taxonomy from ACPT's registry. Idempotent: deleting a non-existent slug returns deleted=false. |
wppilot/acpt-write-valuesWrite ACPT Values | Writes ACPT meta field values for a target (post, term, user, or option-page). Pass target {type, id}, and a values map: {box_name: {field_name: value}}. Each write uses save_acpt_meta_field_value() so ACPT hooks fire. Returns a per-field results array with status ok|error. Target types: post (id=post_id int), term (id=term_id int), user (id=user_id int), option-page (id=menu_slug string). ACPT does not store meta on comments. |