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.

This guide walks you through connecting an AI client to your WordPress site and making your first ability calls. By the end, you’ll have a working connection, a bootstrapped session, and your first piece of AI-created content saved as a draft.

​
Before you start

Make sure you’ve installed the plugin and activated a license. If you haven’t done that yet, see Install Maxi AI Core first.
1

Install and activate the plugin

Follow the installation guide to install Maxi AI Core and activate your Lite or Pro license. Once maxi/get-site-info returns "status": "active", come back here.
2

Connect your AI client

Point your AI client at your site’s MCP endpoint:
https://yoursite.com/wp-json/mcp/mcp-adapter-default-server
Replace yoursite.com with your actual domain.With OAuth 2.1 (recommended)Paste the URL above into your AI client (Claude Desktop, ChatGPT, Cursor, Codex, or any MCP-compatible client). The client sends a request to the endpoint, discovers the OAuth authorization server automatically, and opens a browser consent page. Log in to WordPress if prompted, then click Authorize. The client receives a Bearer token and is ready to use.You only need to authorize once per client. The token refreshes automatically in the background.With application passwords (alternative)If your client doesn’t support OAuth, configure it to use HTTP Basic authentication with your WordPress username and a WordPress application password generated from your profile page.
OAuth is the recommended method for public AI clients. It requires no manual token management and automatically tracks connected clients in Settings → AI Connections.
3

Bootstrap the session

Every Maxi AI Core session must begin with maxi/bootstrap-session. This is enforced server-side — all other abilities are blocked until you call it. Bootstrap delivers your operational playbook, any active operator instructions, and knowledge note headers to the agent.
{
  "ability": "maxi/bootstrap-session"
}
The response includes the playbook content, operator notes, and available reference documents. The agent reads these before calling any other ability.
If you skip maxi/bootstrap-session, every subsequent ability call returns an error. This is intentional — the bootstrap delivers the rules and context the agent needs to operate safely.
4

Make your first ability call

Call maxi/get-site-info to confirm the connection is working and check your license status:
{
  "ability": "maxi/get-site-info"
}
A successful response:
{
  "success": true,
  "data": {
    "site_name": "My Site",
    "site_url": "https://yoursite.com",
    "maxi_ai_version": "3.6.0",
    "maxi_ai_license": {
      "tier": "pro",
      "status": "active"
    }
  }
}
If you see "success": true with an active license, the connection is working correctly.
5

Create your first content

Use maxi/create-content to save a draft post:
{
  "ability": "maxi/create-content",
  "input": {
    "post_type": "post",
    "title": "Hello from AI",
    "content": "<!-- wp:paragraph --><p>My first AI post.</p><!-- /wp:paragraph -->",
    "status": "draft"
  }
}
The response includes the new post ID. You can find the draft in Posts in your WordPress dashboard.
Write abilities — including maxi/create-content — require the connected WordPress user to have the Administrator role. This is enforced server-side and cannot be overridden by rules. If you see a permission error, check that the authenticated user is an administrator.
Content must be valid Gutenberg block markup. The example above uses a wp:paragraph block. You can also pass plain HTML or classic editor content — WordPress core’s block parser accepts all of these.

​
What’s next

Now that you have a working connection, explore what Maxi AI Core can do: