Browse documentation +
Getting startedInstallationConnect a clientSafety profilesWordPress ChatPro licensingAntigravity CLIAntigravity IDETroubleshootingOAuth 2.1 setupApplication PasswordsPage builder workflowsLedger and rollbackApprovals and memoryAbility reference
Pro module24 abilities

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.

AbilityWhat it does
wppilot/acpt-check-setupCheck ACPT SetupReports 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 SchemaReturns 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 SchemaReturns 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 PageReturns 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 TypeReturns 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 TaxonomyReturns 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 GroupsReturns 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 PagesReturns 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 TypesReturns 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 TaxonomiesReturns 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 ValuesReads 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.

AbilityWhat it does
wppilot/acpt-create-field-groupCreate ACPT Field GroupCreates 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 PageCreates 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 TypeCreates 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 TaxonomyCreates 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 GroupEdits 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 PageEdits 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 TypeEdits 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 TaxonomyEdits 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.

AbilityWhat it does
wppilot/acpt-delete-field-groupDelete ACPT Field GroupPermanently 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 PagePermanently deletes an ACPT-managed option page. Idempotent: deleting a non-existent menu_slug returns deleted=false.
wppilot/acpt-delete-post-typeDelete ACPT Post TypePermanently 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 TaxonomyPermanently removes an ACPT-managed taxonomy from ACPT's registry. Idempotent: deleting a non-existent slug returns deleted=false.
wppilot/acpt-write-valuesWrite ACPT ValuesWrites 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.