> ## 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 licensing: Lite and Pro plans explained

> Maxi AI Core requires an active Lite or Pro license. Learn what each plan includes, how to activate your license, and what happens when it expires.

Maxi AI Core ships in two paid tiers: **Lite** and **Pro**. There is no free tier — every install requires an active license to use abilities beyond session bootstrap and license activation. Abilities are gated by feature groups, so your plan determines exactly which operations are available to your agents.

## What each plan includes

<CardGroup cols={2}>
  <Card title="Lite" icon="star">
    Content read and write, taxonomy, notes, basic media, basic meta, AI settings read, and basic development tools.
  </Card>

  <Card title="Pro" icon="crown">
    Everything in Lite, plus bulk meta, AI settings write, AI generation, analytics, full development tools, and the complete WooCommerce suite (catalog, orders, coupons, shipping, tax, and bulk operations).
  </Card>
</CardGroup>

### Feature group breakdown

| Feature group              | Lite | Pro |
| -------------------------- | ---- | --- |
| `content_read`             | Yes  | Yes |
| `content_write_basic`      | Yes  | Yes |
| `taxonomy`                 | Yes  | Yes |
| `notes`                    | Yes  | Yes |
| `media_basic`              | Yes  | Yes |
| `meta_basic`               | Yes  | Yes |
| `ai_settings_read`         | Yes  | Yes |
| `dev_tools_basic`          | Yes  | Yes |
| `meta_bulk`                | —    | Yes |
| `ai_settings_write`        | —    | Yes |
| `ai_generation`            | —    | Yes |
| `analytics`                | —    | Yes |
| `dev_tools_admin`          | —    | Yes |
| `woocommerce_catalog`      | —    | Yes |
| `woocommerce_orders`       | —    | Yes |
| `woocommerce_coupons`      | —    | Yes |
| `woocommerce_shipping_tax` | —    | Yes |
| `woocommerce_bulk`         | —    | Yes |

<Note>
  The `session_system` and `licensing` feature groups are always available — no license required. This allows unlicensed installs to bootstrap a session and activate a key.
</Note>

## Purchasing and activating

Purchase a license at [maxicore.ai](https://maxicore.ai). Once you have a key, you can activate it two ways:

<Steps>
  <Step title="Activate via the WordPress admin">
    Go to **Settings → Maxi AI → License**, enter your license key, and click **Activate**.
  </Step>

  <Step title="Activate via ability">
    Call `maxi/activate-license` with your key. This works from any connected AI client without needing admin UI access.
  </Step>
</Steps>

## Checking your license status

Call `maxi/get-site-info` to see your current license state. The response includes:

```json theme={null}
{
  "maxi_ai_version": "3.6.0",
  "maxi_ai_license": {
    "tier": "pro",
    "status": "active",
    "entitlements": ["content_read", "content_write_basic", "ai_generation", "woocommerce_orders"]
  }
}
```

| Field          | Values                                                                    |
| -------------- | ------------------------------------------------------------------------- |
| `tier`         | `lite`, `pro`, or `unlicensed`                                            |
| `status`       | `active`, `grace_period`, `expired`, `inactive`, `invalid`, or `disabled` |
| `entitlements` | Array of feature-group names your license currently grants                |

Scan `entitlements` before planning a task — if the feature group you need is not in the array, the ability will be gated.

## Grace period and offline resilience

**Grace period:** When a license expires, entitlement-granted abilities continue to work for 7 days. Each successful response includes a warning during this window. Renew before the grace period closes to avoid interruption.

**Offline resilience:** If the Maxi AI license server is temporarily unreachable, the cached license status is extended by 24 hours. Your agents keep working through transient network issues without accidental lockout.

## When an ability is gated

If you call an ability your plan does not include, the response carries a `reason` field that tells you exactly what to do:

<AccordionGroup>
  <Accordion title="plan_insufficient — upgrade your plan">
    Your license is valid, but your current plan does not include the feature group this ability requires. The response also includes `required_group` (the group you need) and `plan` (your current plan name).

    To resolve: upgrade at [maxicore.ai](https://maxicore.ai). The new plan takes effect on the next license refresh — up to 12 hours automatically, or immediately via **Settings → Maxi AI → License**.
  </Accordion>

  <Accordion title="license_required — activate a license">
    No valid license is active on this site. The response includes `required_group` so you know which plan tier covers the ability you need.

    To resolve: purchase a license at [maxicore.ai](https://maxicore.ai), then activate it via `maxi/activate-license` or **Settings → Maxi AI → License**.
  </Accordion>
</AccordionGroup>

## Deactivating your license

Call `maxi/deactivate-license` or use **Settings → Maxi AI → License** to deactivate. After deactivation, only `session_system` and `licensing` abilities remain callable — all other abilities are gated until you activate a new key.

<Warning>
  Deactivation clears the stored license key immediately. Agents connected to the site lose access to gated abilities as soon as deactivation completes.
</Warning>