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

# Maxi AI Core abilities: complete reference overview

> Browse every ability group, understand the call lifecycle, and find links to detailed reference pages for each area of Maxi AI Core.

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:

```text theme={null}
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:

<Steps>
  <Step title="Authentication">
    The server validates the incoming request — either an OAuth 2.1 Bearer token or a WordPress application password. Unauthenticated requests are rejected immediately.
  </Step>

  <Step title="License check">
    The server confirms your site has an active license. Without a valid license, only session bootstrap and license activation abilities are callable.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Execution">
    The ability runs and returns a response in the standard `{ success, data, error }` envelope.
  </Step>
</Steps>

<Note>
  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.
</Note>

## Listing conventions

Most `list-*` abilities accept a consistent set of pagination and ordering parameters:

| Parameter  | Values                                                                                    | Notes                                                    |
| ---------- | ----------------------------------------------------------------------------------------- | -------------------------------------------------------- |
| `orderby`  | `date`, `title`, `modified`, `rand` (plus type-specific values like `price` for products) | See each ability's input schema for its supported values |
| `order`    | `ASC`, `DESC` (case-insensitive)                                                          | Has no effect when `orderby` is `rand`                   |
| `per_page` | integer                                                                                   | Number of results per page                               |
| `page`     | integer                                                                                   | Page 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.

| Group         | Description                                                                  |
| ------------- | ---------------------------------------------------------------------------- |
| Content       | Create, read, update, delete, and manage posts, pages, and custom post types |
| Taxonomy      | Manage categories, tags, and any custom taxonomy                             |
| Media         | Upload, manage, and delete media attachments                                 |
| Meta          | Read and write post, term, and user meta                                     |
| Notes         | Agent-to-operator and agent-to-agent communication system                    |
| System        | Site info, licensing, playbooks, session bootstrap, and ability rules        |
| Yoast SEO     | Set Yoast SEO meta for taxonomy terms                                        |
| AI Generation | Text and image generation and editing via multiple providers                 |
| Analytics     | Page view and WooCommerce conversion analytics                               |
| WooCommerce   | Products, variations, orders, coupons, shipping zones, and tax rates         |
| Development   | WP-CLI, cache flushing, transients, and rewrite rules                        |

<Tip>
  Call `maxi/get-site-info` to check your current license tier and the full list of feature groups your plan includes.
</Tip>

## Browse by group

<CardGroup cols={2}>
  <Card title="Content" icon="file-lines" href="/abilities/content">
    Abilities for creating, reading, updating, deleting, duplicating, scheduling, and searching posts, pages, and custom post types.
  </Card>

  <Card title="Taxonomy" icon="tags" href="/abilities/taxonomy">
    Abilities for managing categories, tags, and custom taxonomies — including bulk term assignment across up to 500 objects.
  </Card>

  <Card title="Media" icon="image" href="/abilities/media">
    Abilities for uploading attachments from URLs or base64, managing featured images, regenerating thumbnails, and deleting media.
  </Card>

  <Card title="Meta" icon="database" href="/abilities/meta">
    Abilities for reading and writing post, term, and user meta — including bulk updates across up to 500 objects and 100 keys per call.
  </Card>

  <Card title="Notes" icon="note-sticky" href="/abilities/notes">
    Abilities for the persistent knowledge and communication system: agent bug reports, how-to knowledge notes, and live operator instructions.
  </Card>

  <Card title="System" icon="gear" href="/abilities/system">
    Abilities for session bootstrap, licensing, site info, playbook management, ability rules, and Pro file system access.
  </Card>

  <Card title="Yoast SEO" icon="magnifying-glass" href="/abilities/taxonomy">
    Ability to set Yoast SEO title and meta description for any taxonomy term. Requires Yoast SEO plugin to be active.
  </Card>

  <Card title="AI Generation" icon="wand-magic-sparkles" href="/abilities/ai-text">
    Abilities for synchronous and batch text generation, image generation, and image editing via OpenAI, Anthropic, OpenRouter, Replicate, BFL, and local providers.
  </Card>

  <Card title="Analytics" icon="chart-line" href="/abilities/analytics">
    2 abilities for querying page views, traffic sources, UTM data, and WooCommerce conversion rates. Requires the Maxi Web Analytics plugin for local tracking.
  </Card>

  <Card title="WooCommerce" icon="cart-shopping" href="/abilities/woocommerce-products">
    22+ abilities covering products, variations, bulk pricing, orders, coupons, shipping zones, and tax rates. Requires WooCommerce to be active.
  </Card>

  <Card title="Development" icon="terminal" href="/abilities/development">
    5 abilities for WP-CLI commands, object cache flushing, transient management, and permalink regeneration — each with strict safety controls.
  </Card>
</CardGroup>

## 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](/abilities/response-format). For a guide to common error codes and what to do when a call fails, see [Handling errors from Maxi AI Core abilities](/abilities/error-handling).