Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.maxicore.ai/llms.txt

Use this file to discover all available pages before exploring further.

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 — it is 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.
GroupAbilitiesDescription
Content12Create, read, update, delete, and manage posts, pages, and custom post types
Taxonomy9Manage categories, tags, and any custom taxonomy
Media9Upload, manage, and delete media attachments
Meta5Read and write post, term, and user meta
Notes7Agent-to-operator and agent-to-agent communication system
System13Site info, licensing, playbooks, session bootstrap, and ability rules
Yoast SEO1Set Yoast SEO meta for taxonomy terms
AI Generation8Text and image generation and editing via multiple providers
Analytics2Page view and WooCommerce conversion analytics
WooCommerce22+Products, variations, orders, coupons, shipping zones, and tax rates
Development5WP-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

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

Taxonomy

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

Media

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

Meta

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

Notes

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

System

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

Yoast SEO

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

AI Generation

8 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.