Get the plugin
WP MCP/Integrations/ACF MCP

ACF MCP · Free and Pro

ACF MCP: Advanced Custom Fields, readable and writable by AI.

An ACF MCP server lets an AI agent understand your content model and work with it: see which fields a post type has, fill them in, or add a new field group. WP MCP does it through Advanced Custom Fields' own APIs, so ACF's validation, defaults and caches all apply.

Self-hosted · snapshot before every write · one-click undo

What it is

What a ACF MCP server does.

On an ACF site the real content is rarely in the editor. It is in fields: a team member's role, an event's venue, a product's spec sheet. An agent that cannot see field groups is working blind. An ACF MCP server shows it the structure first, then lets it read and write values against that structure.

WP MCP covers both halves. Values are read and updated on a post, validated through ACF first. Structure, meaning field groups with nested sub fields, ACF post types and ACF taxonomies, is created or updated through ACF's own import and update APIs, each write an upsert keyed by the ACF key.

ACF sites are defined by their content model: which field groups attach to which post types. The question an agent is most useful for is "what does this model look like and can you fill it in". WP MCP goes through ACF's own APIs, so ACF's defaults and caches apply, and a validate-fields read checks values before you write them, and it keys every structure snapshot by the ACF key so a created group or post type can be removed again by a rollback.

Read and change

What WP MCP can read and change in ACF.

It can read

  • Field groups, their fields and the available field types
  • Field values on any post
  • With ACF Pro: options page values

It can change

  • Update field values, validated through ACF first
  • Create or edit field groups, including nested sub fields
  • Create or edit ACF post types and taxonomies (ACF 6.1 and later)
  • With ACF Pro: write options page values
  • On WP MCP Pro: update fields across many posts in one batch
acf-readacf-writeget-fieldsupdate-fieldslist-field-groupssave-field-group

These are the real ability and operation names the agent calls. TheACF & ACF Pro AI agent tool reference page lists the calls in detail.

Example prompts

Three things to ask first.

What ACF fields does the Team member post type have, and which are required?

Add a 'Venue' field group with address, capacity and a map link to Events.

Fill in the 'role' field for these six team members from the list below.

What ACF fields does the Team member post type have, and which are required?

acf-read with list-field-groups returns the groups, fields and types for that post type; nothing is written.

Add a "Venue" field group with address, capacity and a map link to Events.

save-field-group goes through ACF's import API under a snapshot keyed by the ACF key. rollback-operation deletes a created group.

Fill in the "role" field for these six team members from the list.

update-fields writes through ACF's own API, and validate-fields can check values first. On WP MCP Pro, batch-update-fields does it across many posts in one session.

Safety

Every ACF write has a way back.

Field values are ordinary post meta, so the post snapshot captures them. 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.

Snapshot before every write

No tool that writes can skip it. The before-state is saved first, the change is applied second.

One-click undo

Restore a single change with rollback-operation or a whole agent run with rollback-session, from the agent or from wp-admin.

Writes are opt-in

ACF writes, values and structure alike, are off until the site enables them with the wpmcp_enable_acf_write filter. Reads work straight away.

Free or Pro

Free, with more on Pro.

ACF support is in the free plugin: reading and writing field values, and building field groups, post types and taxonomies. Options page values need ACF Pro on the site. WP MCP Pro adds one thing, a batch-update-fields operation that writes values across many posts under a single session.

WP MCP Pro starts at $49 a year for one site. See pricing for what each tier includes.

How to connect

Connect ACF MCP in four steps.

  1. 01
    Install WP MCP

    Upload the free wpmcp plugin and activate it. It needs WordPress 6.9 or newer and PHP 8.1 or newer, and it runs entirely on your own server.

  2. 02
    Check the requirement

    ACF or ACF Pro active. Options pages need ACF Pro; post types and taxonomies need ACF 6.1 or later.

  3. 03
    Connect your client

    Add the site to Claude Code, Claude Desktop, Cursor or any MCP client with a WordPress application password, or the WP-CLI stdio bridge locally. OAuth 2.1 with full or read-only access is there too, once the site owner switches it on.

  4. 04
    Ask for the change

    Describe what you want done in ACF. WP MCP snapshots the target, makes the change, and leaves a Restore button next to it in wp-admin.

Step-by-step guides: Claude,Claude Code andCursor. The docscover the safety model in full.

Frequently asked

ACF MCP: questions, answered.

What is ACF MCP?

It is Advanced Custom Fields made available to AI agents over the Model Context Protocol. WP MCP lets Claude, Cursor or any MCP client read field groups and values, write values, and build field groups, post types and taxonomies.

Is ACF MCP free?

Yes. The ACF tools are in the free WP MCP plugin. Only the batch update across many posts is a WP MCP Pro feature.

Does it work with ACF Pro fields like repeaters?

Field groups can be created and edited with nested sub fields, and values are validated through ACF before they are written. Options pages are available when ACF Pro is active.

Can an agent create field groups, or only fill in values?

Both. Field groups, ACF post types and ACF taxonomies are created and updated through ACF's own APIs, so its validation and caches apply.

Can I undo a field group change?

Yes. Structure writes are snapshotted under the ACF key, and rollback-operation removes a created group or restores an edited one.

Are ACF writes on by default?

No. Values and structure writes are off until the site enables them with the wpmcp_enable_acf_write filter. Reads work straight away.

What needs ACF Pro?

Options page values need ACF Pro on the site. ACF post types and taxonomies need ACF 6.1 or later.

Does ACF MCP work with Claude, Claude Code and Cursor?

Yes. Claude Code and Cursor connect to WP MCP over HTTP with a WordPress application password, and Claude Desktop uses the desktop bundle from the WP MCP Connection screen. Clients that can only sign in with OAuth, such as the claude.ai custom connector, need OAuth switched on first with one line in wp-config.php, because it ships off. Once connected, the ACF tools are available in every client the same way.

Point your AI agent at ACF.