Guide

Abilities

Native Custom Fields uses the WordPress Abilities API to allow AI tools (MCP-compatible clients, REST API) to programmatically execute plugin operations. All abilities are registered under the native-custom-fields category and require the manage_options capability.

Ability List

Ability NameDescription
native-custom-fields/create-post-typeCreates a new custom post type
native-custom-fields/update-post-typeUpdates an existing custom post type
native-custom-fields/create-taxonomyCreates a new custom taxonomy
native-custom-fields/update-taxonomyUpdates an existing custom taxonomy
native-custom-fields/save-post-meta-fieldsCreates or updates the field configuration for a post type
native-custom-fields/save-term-meta-fieldsCreates or updates the field configuration for a taxonomy
native-custom-fields/save-user-meta-fieldsCreates or updates the field configuration shown on user profile pages
native-custom-fields/create-options-pageCreates a new admin options page
native-custom-fields/update-options-pageUpdates an existing admin options page
native-custom-fields/save-options-page-fieldsCreates or updates the field configuration for an options page

Common Properties

  • Permission: All abilities require the manage_options WordPress capability.
  • MCP: All abilities are marked mcp.public: true and are accessible to MCP-compatible clients.
  • REST: All abilities are registered with show_in_rest: true.
  • Idempotent: All abilities are idempotent; running them again with the same input updates the existing record.
  • Destructive: No ability performs destructive operations (no deletions).

Common Output Schema

Every ability returns the same output shape:

{
  "status": true,
  "message": "Operation completed successfully."
}
FieldTypeDescription
statusbooleantrue on success, false on failure
messagestringHuman-readable result or error message

Field Schema (Shared)

For the shared field definition schema used across field-bearing abilities, see field-schema.md.

Was this helpful?