Custom fields integration
ACF & ACF Pro AI agent tool reference
Advanced Custom Fields stores its values as post meta and its structure as its own internal posts. WP MCP exposes both through the acf-read and acf-write pair. Values: read and update field values on a post, validated through ACF first, and snapshotted as ordinary post meta. Structure: read a field group, list field types, and create or update field groups (with nested sub fields), ACF post types and ACF taxonomies through ACF's own import and update APIs, so its validation, defaults and caches all apply. Every structure write is an upsert keyed by the ACF key and snapshotted, so rollback-operation removes a created group or restores an edited one exactly. With ACF Pro, options page values are readable and writable too, and WP MCP Pro adds a batch-update-fields op that writes values across many posts under one session. Writes are opt-in.
ACF in plain language: ACF MCP.
In practice
How ACF & ACF Pro work goes with an agent.
Advanced Custom Fields splits a site into two kinds of data. Values are ordinary post meta, with a hidden _field_name reference key stored beside each one. The structure, meaning field groups, post types and taxonomies, lives in ACF's own internal posts, keyed by group_, field_ and post_type_ identifiers. WP MCP covers both through one read and one write dispatcher. Value writes snapshot the post, structure writes snapshot the object by its ACF key, and an agent can validate values against ACF's own rules before saving them.
What fields does the Team member post type have, and of what types?
Runs list-field-groups to find the group whose location rules match, then get-field-group with its key, which returns every setting and the full field tree. Both are reads and need no opt-in.
Create an "Event details" group with a date picker, a venue text field and a repeater of speakers, shown on the event post type.
Runs list-field-types, then save-field-group. Each field needs a label, a name and a real type, sub fields nest, and keys are generated in ACF's style. The group is saved through ACF's import API and snapshotted, so rollback-operation deletes it.
Check these values against the fields before you save them to post 150.
Runs validate-fields with post_id, which applies ACF's own validation (required, ranges, email, URL, custom rules) and writes nothing. Then update-fields, which snapshots the post and its reference keys. update-fields does not pre-validate on its own.
Set sponsor_level to gold on these 60 posts.
With Pro, runs batch-update-fields, up to 100 posts per call. Every value and post permission is checked first and one bad value refuses the whole batch with nothing written. Each post is snapshotted under one session_id, so rollback-session reverses all 60.
What your AI can do
Real ACF & ACF Pro operations, every write reversible.
- Discover field groups, fields and field types
- Read and update field values, validated through ACF first
- Create or edit field groups and their fields, including nested sub fields
- Create or edit ACF post types and taxonomies (ACF 6.1+)
- With ACF Pro: read and write options page values
- Pro: update fields across many posts in one batch, undone with one rollback-session
Example prompts
Example ACF prompts.
What ACF fields does the Team member post type have?
Add a "Speaker" field group with name, photo and bio fields to the Event post type.
Set the "role" field on all Team members from this spreadsheet.
Under the hood
The ACF calls, under the hood.
acf-write({ operation: "save-field-group", args: { title: "Speaker", fields: [{ label: "Bio", name: "bio", type: "textarea" }] } }), opt-in; snapshotted, rollback removes it
acf-write({ operation: "update-fields", args: { post_id: 33, fields: {…} } }), snapshotted as post meta
Safety and access
What can be undone on ACF, and what costs what.
Recoverable on ACF
- update-fields and batch-update-fields snapshot each post, including the hidden reference keys, and rollback-operation restores them exactly.
- save-field-group, save-post-type and save-taxonomy snapshot the object by its ACF key. Rolling back a create removes it, and rolling back an edit restores the previous version.
- update-options snapshots the option rows under the fields it names, and a rollback restores the prior rows.
ACF limits and opt-ins
- Every ACF write is off until a site enables it with the wpmcp_enable_acf_write filter, structure writes and options included.
- Passing fields to save-field-group replaces the field list. A field you leave out is deleted, though the snapshot brings it back.
- A group or post type defined in PHP or local JSON, not in the database, is refused as local_definition and cannot be edited here.
- save-post-type and save-taxonomy need ACF 6.1 or later, and options pages need ACF Pro. On older or free ACF these refuse cleanly.
- Structure writes need ACF's own capability setting, manage_options by default.
Free or Pro: Nearly all of it is free: reading groups, post types and taxonomies, validating, reading and writing values, saving structure, and options page values. The one WP MCP Pro operation is batch-update-fields. Do not confuse the two Pros: options pages depend on the ACF Pro plugin on your site, while batch-update-fields depends on a WP MCP Pro licence. Every write, free or Pro, stays off until the site opts in with wpmcp_enable_acf_write.
In the free plugin
The ACF integration is in the free plugin.
The core ACF tools ship in the free, GPL plugin with the full snapshot and undo engine, and no trial clock. Pro adds 133 more tools, including Elementor deep editing, the other page builders, the forms adapter pack and, for some integrations, extra operations. The pricing page lists what each tier includes.
Frequently asked
ACF MCP: questions, answered.
Does WP MCP support ACF PRO?
Yes. Values and structure work on both; options pages need ACF Pro, and on free ACF those ops refuse cleanly.
Can I undo a field group change?
Yes. Every structure write is snapshotted under its ACF key before it lands, so rollback-operation deletes a created group, post type or taxonomy, or puts an edited one back exactly.
Are writes on by default?
No. ACF writes, values and structure alike, are off until a site enables them with the wpmcp_enable_acf_write filter.
Will a group the agent creates show up in ACF's admin?
Yes. It is saved as a normal database-stored group through ACF's import function, so it appears in ACF's field group list and can be edited there like any other. Only definitions living in code or local JSON are out of reach.
Does the agent need to know field keys?
No. update-fields accepts a field name or key and ACF resolves it against the post. validate-fields reports "No ACF field matches this name or key" for a name it cannot resolve, so mistakes show before a write.
What stops an agent registering a clashing post type?
The slug must be 1 to 20 lowercase letters, digits, underscores or dashes for a post type (32 for a taxonomy). WordPress reserved terms, slugs used by another ACF item, and slugs registered outside ACF are all refused before anything is saved.
Can it write to an options page without ACF Pro?
No. Without ACF Pro the options operations stay listed but refuse with acf_options_unavailable, and nothing reaches an undefined function. Values and structure on posts keep working on free ACF, so only the options page part is lost.
Is there an AI agent for ACF?
Yes, through WP MCP rather than ACF itself. An agent you choose, such as Claude or Cursor, can discover field groups, fields and field types. WP MCP is a separate plugin, not a built-in AI feature of ACF. On the undo side: update-fields and batch-update-fields snapshot each post, including the hidden reference keys, and rollback-operation restores them exactly.
Related integrations
More integrations for the same agent.
MCP for Meta Box
FreeCustom fields, 5 tools.
MCP for JetEngine
FreeCustom fields, 2 tools.
MCP for Pods
FreeCustom fields, 2 tools.
MCP for Code Snippets
FreeOperations, 2 tools.
MCP for Elementor
ProPage builders, 14 tools.
MCP for Gutenberg
FreePage builders, 4 tools.
Browse the full Integrations hub, or read more on ACF MCP and the WordPress MCP plugin.