Neve MCP Abilities

Neve Pro 3.2.6 introduces a set of WordPress Abilities API tools that MCP clients can use to read and configure a Neve site programmatically. This guide covers prerequisites, available abilities, safe usage order, and important safety notes.

Requirements

• Neve Pro 3.2.6 or newer must be active on your site.
• The WordPress Abilities API must be available — either from WordPress core or an installed MCP/Abilities API adapter.
• The authenticated user must have the capability required by each ability:
  • Most design and Customizer abilities require edit_theme_options.
  • Site operations such as module toggles, performance settings, and starter site imports require manage_options.

Recommended Workflow

Follow this order to avoid unintended changes:

1. Call neve/site-get-state to inspect the current site configuration before making any changes.
2. Use read-only helpers such as neve/header-list-components, neve/custom-layout-list, neve/custom-layout-get-condition-schema, neve/starter-site-list, and neve/pro-module-list to gather information before writing.
3. Use write abilities only after confirming the target state from the read step.
4. Treat abilities marked as destructive — such as starter site import/cleanup, menu deletion, custom layout deletion, and site mode changes — as operations that require explicit confirmation before executing.

Ability Groups

Site State and Discovery

These abilities are read-only and safe to call at any time.

Ability	Description
neve/site-get-state	Returns a full snapshot of the current site configuration. Call this first.
neve/header-list-components	Lists all available header builder components.
neve/custom-layout-get-condition-schema	Returns the schema of conditions that can be applied to custom layouts.
neve/pro-module-list	Lists all Neve Pro modules and their current status.

Appearance and Layout

These abilities write to Customizer settings. They require the edit_theme_options capability.

Ability	Description
neve/appearance-update	Updates one or more Customizer appearance settings.
neve/appearance-apply-preset	Applies a predefined appearance preset.
neve/header-configure	Configures the header builder layout and component settings.
neve/footer-configure	Configures the footer builder layout and component settings.
neve/site-set-theme-mod	Sets an individual theme mod value.

Menus and Custom Layouts

Menu deletion and custom layout deletion are destructive and cannot be undone.

Ability	Description
neve/site-configure-menu	Creates or updates a navigation menu and its assignments.
neve/site-delete-menu	Destructive. Permanently deletes a navigation menu.
neve/custom-layout-list	Lists all existing custom layouts.
neve/custom-layout-get	Returns the content and settings of a specific custom layout.
neve/custom-layout-upsert	Creates or updates a custom layout.
neve/custom-layout-set-status	Publishes, drafts, or changes the status of a custom layout.
neve/custom-layout-set-site-mode	Destructive. Changes the site-wide layout mode used by custom layouts.
neve/custom-layout-delete	Destructive. Permanently deletes a custom layout.

Starter Sites, Modules, and Performance

Starter site import and cleanup are destructive operations that affect site-wide content.

Ability	Description
neve/starter-site-list	Lists all available starter sites for import.
neve/starter-site-import	Imports a starter site. Supports a dry_run parameter to preview without making changes.
neve/starter-site-cleanup	Destructive. Removes starter site content from the current site.
neve/site-set-performance	Updates site performance settings such as emoji removal, oEmbed, and local Google Fonts.
neve/pro-module-toggle	Enables or disables a Neve Pro module by slug.

Example Payloads

Read the current site state:

{
  "sections": ["colors", "typography", "layout", "modules", "license", "integrations"]
}

Preview a starter site import without applying changes:

{
  "slug": "your-starter-site-slug",
  "dry_run": true
}

Update performance options:

{
  "remove_emoji": true,
  "remove_oembed": true,
  "local_google_fonts": true,
  "content_visibility": true
}

Toggle a Neve Pro module:

{
  "module": "custom-layouts",
  "enabled": true
}

Safety Notes

⚠️ Destructive operations: Some abilities permanently change menus, custom layouts, starter site content, or the whole-site layout mode. Review each ability's schema and annotations in your MCP client before executing any write or destructive operation.

📝 Note: Always call neve/site-get-state before making changes so you have a baseline snapshot to compare against or restore from if needed.

💡 Tip: Use the dry_run option on neve/starter-site-import to preview what would change before committing to a full import.