Neve MCP Abilities

The Neve theme includes WordPress Abilities API tools that AI assistants can use to read and configure a Neve site. Neve Pro adds tools and fields for premium features. This guide covers connection, prerequisites, available abilities, safe usage order, and important safety notes.

In this article

• Requirements
• Connect your AI client and enable Neve's abilities
• Recommended Workflow
• Ability Groups
  • Core Neve Abilities
  • Neve Pro: Menus and Custom Layouts
  • Neve Pro: Starter Sites and Modules
• Example Payloads
• Safety Notes

Requirements

• The Neve theme must be active on your site.
• WordPress 6.9 or later.
• You also need a compatible connector, such as Easy MCP AI, and an AI client connected to your WordPress site. For setup instructions, see Getting Started with Easy MCP AI.
• Neve Pro is required only for abilities or fields that manage Pro features.
• 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.

Connect your AI client and enable Neve's abilities

1. In your WordPress dashboard, open Easy MCP AI > Dashboard. In the Connect your AI client area, choose your AI client and follow the on-screen steps to connect it to your site. If you use another compatible connector, follow its connection instructions.

2. Open Easy MCP AI > Tools, then select Abilities.

3. All abilities are off by default. In the Neve group, enable all abilities that you need.

   Click Save changes to make them available to connected clients.

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

Core Neve Abilities

These nine abilities are included with the Neve theme. Read-only abilities can be called at any time.

Site State and Discovery

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 and footer builder components.

Appearance and Layout

These abilities write to Customizer settings. They require the edit_theme_options capability. Per-page updates also require permission to edit the selected post, page, or product.

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.
neve/page-layout-update	Reads or updates the Neve layout settings for a post, page, or product.
neve/site-set-performance	Updates site performance settings such as emoji removal, oEmbed, and local Google Fonts.

Some fields within shared abilities require Neve Pro and return a Pro-required error when the addon is unavailable.

Neve Pro: Menus and Custom Layouts

Neve Pro adds the following abilities for 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-get-condition-schema	Returns the schema of conditions that can be applied to custom layouts.
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.

Neve Pro: Starter Sites and Modules

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/pro-module-list	Lists all Neve Pro modules and their current status.
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", "buttons", "menus", "performance"]
}

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",
  "action": "enable"
}

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.