Skip to main content
Abilities are the discrete, permission-gated operations that AI agents call through the MCP adapter to read and manage your WordPress and WooCommerce site. Every ability call passes through the same lifecycle — authentication, license check, capability check, and ability-rule acknowledgement — before any site data is touched. The result always arrives in the same JSON envelope, whether the call succeeded or failed.

MCP endpoint

Your AI client connects to the following URL, where yoursite.com is your WordPress site’s domain:
https://yoursite.com/wp-json/mcp/mcp-adapter-default-server
Paste this URL into your AI client’s MCP configuration. The client discovers authentication endpoints automatically from there.

Call lifecycle

Every ability call follows this sequence on the server:
1

Authentication

The server validates the incoming request — either an OAuth 2.1 Bearer token or a WordPress application password. Unauthenticated requests are rejected immediately.
2

License check

The server confirms your site has an active license. Without a valid license, only session bootstrap and license activation abilities are callable.
3

Capability check

The server verifies the authenticated WordPress user has the capability the ability requires (for example, edit_posts for content creation). This is enforced at execution time, not at connection time.
4

Ability-rule acknowledgement

If the ability has an associated rule, the server confirms it has been acknowledged for the current session. Read-only abilities attach the rule to their first successful response. Write abilities block the first call and deliver the rule in the rejection, then pass the retry through.
5

Execution

The ability runs and returns a response in the standard { success, data, error } envelope.
All other abilities are blocked until you call maxi/bootstrap-session at the start of each session. Bootstrap is server-enforced and it’s not optional.

Listing conventions

Most list-* abilities accept a consistent set of pagination and ordering parameters:
ParameterValuesNotes
orderbydate, title, modified, rand (plus type-specific values like price for products)See each ability’s input schema for its supported values
orderASC, DESC (case-insensitive)Has no effect when orderby is rand
per_pageintegerNumber of results per page
pageintegerPage offset for pagination

Ability groups

Abilities are organized into feature groups. Your license plan determines which groups are available on your site. Lite plan abilities are available to all licensed installs; Pro-only abilities are marked [PRO] throughout the reference.
GroupDescription
ContentCreate, read, update, delete, and manage posts, pages, and custom post types
TaxonomyManage categories, tags, and any custom taxonomy
MediaUpload, manage, and delete media attachments
MetaRead and write post, term, and user meta
NotesAgent-to-operator and agent-to-agent communication system
SystemSite info, licensing, playbooks, session bootstrap, and ability rules
Yoast SEOSet Yoast SEO meta for taxonomy terms
AI GenerationText and image generation and editing via multiple providers
AnalyticsPage view and WooCommerce conversion analytics
WooCommerceProducts, variations, orders, coupons, shipping zones, and tax rates
DevelopmentWP-CLI, cache flushing, transients, and rewrite rules
Call maxi/get-site-info to check your current license tier and the full list of feature groups your plan includes.

Browse by group

Content

Abilities for creating, reading, updating, deleting, duplicating, scheduling, and searching posts, pages, and custom post types.

Taxonomy

Abilities for managing categories, tags, and custom taxonomies — including bulk term assignment across up to 500 objects.

Media

Abilities for uploading attachments from URLs or base64, managing featured images, regenerating thumbnails, and deleting media.

Meta

Abilities for reading and writing post, term, and user meta — including bulk updates across up to 500 objects and 100 keys per call.

Notes

Abilities for the persistent knowledge and communication system: agent bug reports, how-to knowledge notes, and live operator instructions.

System

Abilities for session bootstrap, licensing, site info, playbook management, ability rules, and Pro file system access.

Yoast SEO

Ability to set Yoast SEO title and meta description for any taxonomy term. Requires Yoast SEO plugin to be active.

AI Generation

Abilities for synchronous and batch text generation, image generation, and image editing via OpenAI, Anthropic, OpenRouter, Replicate, BFL, and local providers.

Analytics

2 abilities for querying page views, traffic sources, UTM data, and WooCommerce conversion rates. Requires the Maxi Web Analytics plugin for local tracking.

WooCommerce

22+ abilities covering products, variations, bulk pricing, orders, coupons, shipping zones, and tax rates. Requires WooCommerce to be active.

Development

5 abilities for WP-CLI commands, object cache flushing, transient management, and permalink regeneration — each with strict safety controls.

Response format and error handling

Every ability returns the same JSON envelope regardless of the group or outcome. For the full field reference and metadata fields, see Ability response format and metadata. For a guide to common error codes and what to do when a call fails, see Handling errors from Maxi AI Core abilities.