Documentation

Documentation for the InsationAI plugin suite.

Seven plugins, one consistent system. Setup, authentication and configuration are consistent across the InsationAI suite — then each plugin adds its own MCP tools. Start here.

Getting started

Install any InsationAI plugin, activate your license, and connect your first MCP client in minutes.

Authentication

OAuth 2.1 with dynamic client registration — connect Claude, Cursor and other MCP clients.

Configuration

Per-plugin settings: enable/disable individual tools, restrict roles, review the audit log.

MCP tools reference

Every plugin's full tool list, grouped by capability area — see the breakdown below.

Hooks & filters

Lifetime updates and a strict per-site license, delivered straight to a licensed install.

Troubleshooting

Connection, licensing and endpoint issues — and how to resolve them.

Getting started

Every InsationAI plugin installs and licenses the same way:

  1. Download the plugin ZIP from your My Account → Downloads page.
  2. In WordPress admin, go to Plugins → Add New → Upload Plugin, choose the ZIP, Install Now, then Activate.
  3. Open InsationAI Tools in the admin menu, pick the plugin’s License tab, paste your key and click Activate license.
  4. The plugin’s MCP endpoint only serves once the license is active. Each plugin runs independently with its own tokens, endpoint and license, grouped under the shared InsationAI Tools menu.

Authentication

The six WordPress plugins use OAuth 2.1 with dynamic client registration. Your AI client (Claude Desktop/API, Cursor, etc.) registers itself on first connect and obtains an access token — no manual key exchange. Every tool call is then enforced against WordPress user capabilities, so an AI can only do what the authenticated user is permitted to do. Connect a client via Settings → Connectors → Add custom connector using the plugin’s endpoint URL, then approve the OAuth handshake.

WHMCSMCP instead uses a bearer token you generate in its admin (Addons → MCP Server → API Keys); every call runs as a WHMCS admin user you choose. Connect it with the Authorization: Bearer <token> header (or the bundled mcp-remote bridge for Claude Desktop).

Configuration

Each plugin’s admin tab under InsationAI Tools lets you enable/disable individual tools, manage API tokens, activate or re-check the per-site license, review the audit log of AI tool calls, and receive lifetime updates. The six WordPress plugins require WordPress 6.0+ and PHP 8.2+; WHMCSMCP runs on WHMCS 8.x with PHP 7.4+.

MCP Pro for WP

Turns core WordPress into a secure MCP server — no extra platform dependency. ~90 tools across 21 capability areas:

  • Content — list, read, create, update, surgically patch, delete any post type; discover content types; find by slug/URL
  • Taxonomy — discover taxonomies, manage terms, assign terms to content
  • Media — upload, attach, manage metadata
  • Plugins — inspect, install, activate/deactivate, read/write plugin files
  • Themes — inspect, switch, read/write theme files
  • Users & Roles — list/create/update/delete users, manage roles & capabilities
  • Comments — list, create, update, delete, moderate
  • Options & Settings — options, transients, theme mods
  • Menus — navigation menus, items, locations
  • Widgets — classic & block widgets, sidebars
  • Block Patterns — patterns & reusable blocks
  • Customizer — read, update, export settings
  • Cron — list, schedule, unschedule, run events
  • Rewrites — list, flush, add rewrite rules
  • Database — guarded queries, table info, optimize/repair, cleanup, search-replace
  • Diagnostics — system info, Site Health, debug log, hook inspection
  • SEO & Redirects — robots.txt, sitemap, redirects
  • Export & Import — export/import content, database backup
  • Audit Log — review/clear the record of AI tool calls
  • Multisite — network site & user management (multisite installs)
  • Code Execution — optional, off by default, constant-gated

Requires WordPress 6.0+ and PHP 8.2+.

MCP Pro for Elementor

Structured, safe AI access to everything Elementor builds. Requires the free Elementor plugin. ~96 tools across 17 capability areas:

  • Documents — list, read, replace, duplicate, delete documents; settings; version
  • Element Tree — find/get/list/insert/update/replace/delete/duplicate/move/wrap/unwrap any element
  • Widget Types — list widgets & categories, schemas, defaults, validate, bulk-replace
  • Templates & Library — list, create, update, delete, duplicate, export, import, apply; save element as template
  • Global Kit & Styles — Kit settings, global colors & fonts, Kit custom CSS
  • Revisions — list, inspect, restore, delete, prune
  • Page Settings — per-page settings & page templates
  • Custom CSS — page-level and element-level
  • Dynamic Tags — list tags & groups, find usage, inspect config
  • Experiments — list and toggle Elementor experiments
  • Diagnostics — system info, data validation, orphaned-data, requirements, CSS status
  • Cache & CSS Regen — clear cache, regenerate document/all CSS, sync global CSS
  • Maintenance Mode — read and set
  • Search & Replace — in a document and across all documents (incl. URLs)
  • Editor Roles — per-role editor access
  • Fonts — list fonts & groups, find usage
  • Style Variations — export, apply, compare, save Kit style variations

Requires WordPress 6.0+, PHP 8.2+, and Elementor (free) active. Also dual-registers tools on the WordPress Abilities API (WP 6.9+).

MCP Pro for Elementor Pro

The Elementor Pro–only feature surface. Runs alongside ElementorMCP; requires Elementor Pro. ~46 tools across 12 capability areas:

  • Theme Builder — Templates — list, get, create, update, delete, duplicate header/footer/single/archive/404/search templates
  • Theme Builder — Display Conditions — read, set, add, remove conditions; config; conflict detection
  • Theme Builder — Locations — list locations and assigned templates
  • Theme Builder — Widgets — list, schemas, insert, configure, find usages
  • WooCommerce Builder — list/create WooCommerce templates; list & insert WooCommerce widgets
  • Forms & Submissions — inspect forms, manage actions, list/inspect/count/manage submissions
  • Popups — list, get, create, delete, update triggers
  • Pro Widget Library — list, schemas, insert, configure Pro widgets
  • Pro Dynamic Tags — list Pro dynamic tags, find usage
  • Custom Code — list, get, create Custom Code snippets
  • Custom Fonts & Icons — list custom site assets
  • Role Manager — read & update per-role editor restrictions

Requires WordPress 6.0+, PHP 8.2+, and both Elementor and Elementor Pro active.

MCP Pro for Avada

AI control of the Avada theme configuration surface. Pair with FusionBuilderMCP for the page-builder surface. 33 tools across 8 capability areas:

  • Theme Options — environment summary, read all options, set or reset an option
  • Avada Content Types — list and read Portfolio, FAQ, Slider and other Avada CPTs
  • Global Colors & Typography — read/set the global palette (with repair), read/set global typography
  • Avada Library — list items & categories, read, create, update saved Library elements/templates
  • Avada Layout / Theme Builder — overview, list & read Layouts and Sections
  • Theme Builder Conditions — read, set, add display conditions, with one-call revert from an automatic snapshot
  • Prebuilt Websites — list prebuilt demos, tags, imported sites, plugin-dependency info (read-only)
  • Performance & Maintenance — system status, performance settings, reset caches, regenerate dynamic CSS

Requires WordPress 6.0+, PHP 8.2+, and the Avada theme active.

MCP Pro for Fusion Builder

AI control of Fusion Builder — the page builder bundled with the Avada theme. Pair with AvadaMCP for the theme surface. 11 tools:

  • Element library — environment overview, the full registry-driven element catalog, and the complete settings schema for any element
  • Builder content (read-only) — the raw Fusion shortcode/page-options for a page, and a recursive dotted-path element tree for precise targeting
  • Guarded builder writes — create, insert, modify, delete and move elements, dry-run by default (returns the exact proposed content, changes nothing until confirmed)
  • One-call revert — restore the snapshot taken automatically before the last committed write

Requires WordPress 6.0+, PHP 8.2+, and Fusion Builder (bundled with Avada) active.

MCP Pro for GitHub

Automated GitHub releases for your plugins, driven from inside WordPress. Store a fine-grained GitHub token once in the plugin’s GitHub tab; releases are published server-side — the token never reaches the AI client. 6 tools:

  • Releases — create a GitHub release (tag, title, notes, draft/prerelease) and list a repo’s existing releases
  • Release assets — attach a build to a release, fetched server-side from a URL so no file bytes pass through the AI client
  • Repository files — create or update a file via a commit (binary-safe via fetch-from-URL) — e.g. host a release zip at a stable raw URL
  • Repository & config — read repo metadata (default branch, visibility, permissions) and confirm the stored token / owner / repo configuration

Requires WordPress 6.0+ and PHP 8.2+. Set a repo-scoped GitHub token in the plugin’s GitHub tab.

WHMCSMCP

Turns your WHMCS billing system into a secure MCP server — the only InsationAI plugin that runs on WHMCS rather than WordPress. Authenticate with a bearer token, scope every call to a WHMCS admin user you choose, and enable or disable individual tools. 68 tools across 10 capability areas:

  • Client Management — list, search, view, create, update and delete clients
  • Products — list the catalog and create new products
  • Service Management — provision, suspend, unsuspend, terminate and update services; change package; change password via the server module
  • Invoice Management — list, view, create and update invoices; add line items and payments; apply credit; list transactions
  • Quote Management — create, view, list, update, send and accept quotes
  • Order Management — create, list, view, accept, cancel and delete orders
  • Support Tickets — open, view, list, reply, note, update and delete tickets; list departments and statuses
  • Domain Management — register, renew, transfer; manage nameservers and registrar locks; WHOIS lookups; TLD pricing; list client domains
  • Affiliates & Promotions — list affiliates, activate affiliates, list promotion codes
  • System — status & stats, activity log, admin users, servers, currencies, payment methods, email templates, send templated email, to-do items

Requires WHMCS 8.x and PHP 7.4+ (PHP 8.x recommended). Authentication is bearer-token based; the MCP endpoint only serves on a licensed, activated install.

Troubleshooting

If your AI client can’t connect:

  • Confirm the plugin’s license is active on its License tab — the endpoint does not serve on an unlicensed or lapsed install
  • Verify HTTPS is set up. MCP requires TLS 1.2 or higher
  • Check the plugin’s audit log for the rejection reason
  • Confirm the user role you’re authenticating as has the required capabilities

Still stuck? Email support@insation.ai and include the diagnostic summary from the plugin’s Support tab.