Title: FlavourSuite AI
Author: FlavourSuite
Published: <strong>July 26, 2026</strong>
Last modified: July 27, 2026

---

Search plugins

![](https://ps.w.org/flavoursuite-ai/assets/banner-772x250.png?rev=3624889)

![](https://ps.w.org/flavoursuite-ai/assets/icon-256x256.png?rev=3624889)

# FlavourSuite AI

 By [FlavourSuite](https://profiles.wordpress.org/masrawy2025/)

[Download](https://downloads.wordpress.org/plugin/flavoursuite-ai.0.3.0.zip)

 * [Details](https://wordpress.org/plugins/flavoursuite-ai/#description)
 * [Reviews](https://wordpress.org/plugins/flavoursuite-ai/#reviews)
 *  [Installation](https://wordpress.org/plugins/flavoursuite-ai/#installation)
 * [Development](https://wordpress.org/plugins/flavoursuite-ai/#developers)

 [Support](https://wordpress.org/support/plugin/flavoursuite-ai/)

## Description

FlavourSuite AI makes your WordPress site **agent-ready**: it exposes a [Model Context Protocol](https://modelcontextprotocol.io/)(
MCP) server so AI agents like Claude, Cursor, and ChatGPT can query your site through
safe, structured tools instead of scraping pages or guessing at your REST API.

It is built on the WordPress core **Abilities API** (WordPress 6.9+) and the official**
wordpress/mcp-adapter**, so it speaks the same standards WordPress itself is adopting—
no proprietary protocol, no lock-in.

#### Security first

 * **Off by default.** Installing the plugin exposes nothing. The MCP endpoint only
   exists after an administrator turns it on under _Settings  FlavourSuite AI_.
 * **Every tool call is permission-checked.** Agents authenticate as a real WordPress
   user — via a connection token, an Application Password, or OAuth 2.1 with PKCE
   for cloud clients — and each tool enforces that user’s capabilities (`manage_options`,`
   read`, `manage_woocommerce`, …). There is no anonymous access, ever. Connected
   agents are listed in settings and can be revoked in one click.
 * **Scoped credentials.** Connection tokens are named, individually revocable, 
   optionally expiring, and accepted _only_ on the MCP endpoint — the rest of the
   REST API rejects them. Give each agent its own, and a leaked config costs you
   that agent’s access rather than the whole account. Only a SHA-256 hash is stored,
   so a database dump yields nothing usable.
 * **Rate limited.** Tool calls are capped per user per minute so a runaway agent
   gets a 429 instead of exhausting your server, and the public OAuth endpoints 
   are capped more tightly per IP.
 * **Agents propose, you approve.** No tool writes to your live site. Agents can
   _propose_ changes (Additional CSS, post/page content), which land as pending 
   change requests under _Tools  Agent Changes_ — you review a before/after diff
   and approve, reject, or later roll back each one. Propose tools are additionally**
   off by default**, and read-only tools have per-tool switches too.
 * **Audit trail.** The settings screen shows who called which tool, when, and whether
   it succeeded, and exports to CSV. Arguments and results are never stored.
 * **No data leaves your site.** The plugin makes no external requests and needs
   no API keys. Agents connect to _you_.

#### Tools in this version

 * **Site overview** — WordPress/PHP versions, active plugins, content counts (administrators
   only).
 * **List recent posts** — recent published entries of any public post type.
 * **Search content** — full-text search across public content with snippets.
 * **Site policies** — privacy, terms, returns, shipping, FAQ and contact pages 
   with their text, so agents answer pre-sale and trust questions from your real
   policies.
 * **WooCommerce store overview** — product and order counts by status, currency,
   WooCommerce version (shop managers only; no customer data). Registered automatically
   when WooCommerce is active. WooCommerce also supplies its configured terms and
   refund pages to the site-policies tool.
 * **FluentCRM tools** — when FluentCRM 3.0+ is active, its own read-only CRM context,
   campaigns, and automations tools appear on this server (contact-level tools are
   deliberately excluded here; FluentCRM’s dedicated MCP server carries the full
   set).
 * **Get custom CSS** — read the current Additional CSS so proposals start from 
   reality.
 * **Propose custom CSS change** _(off by default)_ — stage a full replacement of
   the Additional CSS as a pending change request with a reviewable diff.
 * **Propose content edit** _(off by default)_ — stage a new title and/or content
   for a post or page, same review flow.
 * **List change requests** — agents can check whether their proposals were approved,
   rejected, applied, or rolled back.

#### Agents propose, you approve

The propose tools never touch your live site. Each proposal stores the _current_
state alongside the desired state, and applying it re-checks both the reviewer’s
capabilities and staleness — if a human edited the CSS or the post after the proposal
was made, the apply is refused instead of overwriting that work. Applied changes
keep their before-state for one-click rollback, and content edits are additionally
covered by core revisions.

#### Works with any agent

MCP is model-agnostic, so the model behind your agent is irrelevant to this plugin—
Claude, GPT, Gemini, DeepSeek, Qwen, Kimi, GLM, Llama, Mistral, anything routed 
through OpenRouter, or a model running locally on your own machine. What matters
is the client, and the settings screen generates a ready-to-paste recipe for each
one:

 * **Command line** — Claude Code, Codex CLI, OpenCode.
 * **Editors** — Cursor, VS Code (Copilot), Cline, Roo Code, Windsurf.
 * **Cloud clients** — Claude (web and desktop connectors) and ChatGPT connect over
   OAuth 2.1: they discover the site automatically and you approve the connection
   in wp-admin, with no password to copy anywhere.
 * **Apps with a settings screen** — Cherry Studio, ChatWise, 5ire, LibreChat, Dify,
   n8n and similar: paste the endpoint and one header.
 * **Everything else** — a stdio bridge recipe (`mcp-remote`) covers agents that
   cannot speak HTTP directly, including LM Studio, Goose and most self-hosted or
   open-source clients.

#### Works with your stack

Integrations are detected automatically: if WooCommerce is active its tools appear,
if not they don’t — no configuration, no errors. More integrations are on the way.

## Screenshots

[⌊Settings → FlavourSuite AI: master switch (off until you turn it on), per-tool
toggles with write tools flagged in red, and the per-user rate limit.⌉⌊Settings 
→ FlavourSuite AI: master switch (off until you turn it on), per-tool toggles with
write tools flagged in red, and the per-user rate limit.⌉[

Settings  FlavourSuite AI: master switch (off until you turn it on), per-tool toggles
with write tools flagged in red, and the per-user rate limit.

[⌊Tools → Agent Changes: a pending agent proposal shown as a before/after diff with
Approve & apply, Reject, and rollback for applied changes.⌉⌊Tools → Agent Changes:
a pending agent proposal shown as a before/after diff with Approve & apply, Reject,
and rollback for applied changes.⌉[

Tools  Agent Changes: a pending agent proposal shown as a before/after diff with
Approve & apply, Reject, and rollback for applied changes.

[⌊Connect an agent: pick your client and get the exact config for it — the endpoint
and credential are filled in for you, and the header is built in your browser.⌉⌊
Connect an agent: pick your client and get the exact config for it — the endpoint
and credential are filled in for you, and the header is built in your browser.⌉[

Connect an agent: pick your client and get the exact config for it — the endpoint
and credential are filled in for you, and the header is built in your browser.

[⌊Connection tokens: a named, revocable credential per agent, with optional expiry
and a last-used column. Each one works only on the MCP endpoint.⌉⌊Connection tokens:
a named, revocable credential per agent, with optional expiry and a last-used column.
Each one works only on the MCP endpoint.⌉[

Connection tokens: a named, revocable credential per agent, with optional expiry
and a last-used column. Each one works only on the MCP endpoint.

## Installation

 1. Install and activate the plugin (WordPress 6.9+, PHP 7.4+).
 2. Go to _Settings  FlavourSuite AI_ and enable the MCP server.
 3. Create a connection token on the same screen — give it a name and, if you like,
    an expiry. It is shown once.
 4. Choose your agent from the list below it. The recipe builder produces the exact
    configuration block for that client, with the endpoint and the token already filled
    in. The header is assembled in your browser and never sent back or stored. Cloud
    clients such as Claude and ChatGPT skip steps 3 and 4 entirely: point them at the
    endpoint and approve the connection when prompted.

For example, with Claude Code: `claude mcp add --transport http flavoursuite https://
example.com/wp-json/flavoursuite-ai/mcp`

Full documentation — including per-client connection guides (Claude Code, Claude
Desktop, Cursor, ChatGPT), the Approvals walkthrough, and troubleshooting: [flavoursuite.github.io/docs](https://flavoursuite.github.io/docs/)

## FAQ

### Is this safe to install on a production site?

Installing it changes nothing until you opt in: the MCP endpoint is not even registered
while the master switch is off. When enabled, every request must authenticate as
a WordPress user and every tool re-checks that user’s capabilities. Tools that read
are read-only; tools that would change anything only create proposals for you to
review.

### Does this send my site’s data to an AI company?

No. The plugin contains no API keys and makes no outbound requests. It’s a server:
AI agents you control connect to your site, authenticated as a user you created,
seeing only what that user may see.

### How do agents authenticate?

Three ways, all as a real WordPress user limited to that user’s capabilities.

**Connection tokens** (recommended for desktop and command-line clients) are created
on the settings screen, sent as `Authorization: Bearer …`, and accepted only on 
the MCP endpoint — the same token is refused by every other REST route, so an agent
that has one cannot use it to read your users or edit posts directly. Each token
has a name, an optional expiry, and its own Revoke button. Only a hash is stored.

**Application Passwords** still work, for setups already built around them. Be aware
that they authenticate against the entire REST API, not just MCP.

**OAuth 2.1 with PKCE** is for cloud clients such as claude.ai and ChatGPT: they
discover the site automatically, you approve the connection on a consent screen 
in wp-admin, and you can revoke that agent at any time under Settings  FlavourSuite
AI.

### What happens if a connection token leaks?

Whoever holds it can call the MCP tools you have enabled, as the user it was issued
for — and nothing else. It is rejected on every REST route except the MCP endpoint,
so it cannot be replayed against `wp-json/wp/v2/*`. Revoke it on the settings screen
and it stops working on the next request; other agents are unaffected. Every call
it made is in the audit log.

### Which AI agents and models does this work with?

Any MCP client, and any model. This plugin is an MCP _server_, so the model your
agent runs — Claude, GPT, Gemini, DeepSeek, Qwen, Kimi, GLM, Llama, Mistral, an 
OpenRouter route, or something local — never touches this plugin and makes no difference
to it. The settings screen generates the right config for Claude Code, Codex CLI,
OpenCode, Cursor, VS Code, Cline, Roo Code, Windsurf, Claude and ChatGPT cloud connectors,
and GUI apps like Cherry Studio, ChatWise, 5ire, LibreChat, Dify and n8n. For anything
not listed, the `mcp-remote` stdio bridge recipe works with any agent that accepts
an `mcpServers` block.

### What is MCP?

The Model Context Protocol is an open standard that lets AI assistants use external
tools. Claude, Cursor, ChatGPT, and a growing list of clients support it natively.

### Does it work without WooCommerce?

Yes. The core site tools work on any WordPress site. WooCommerce tools appear only
when WooCommerce is active.

### Which FluentCRM versions are supported?

FluentCRM 3.0 or newer — that’s where FluentCRM introduced its own abilities, which
this plugin curates. With an older FluentCRM the CRM tools simply don’t appear; 
nothing breaks.

### Can agents modify my site?

Only through you. Agents can _propose_ changes (Additional CSS, post/page content),
which appear as pending change requests under _Tools  Agent Changes_ with a before/
after diff. Nothing touches the live site until an administrator approves it there,
and applied changes can be rolled back. The propose tools are also disabled by default—
you switch them on per tool.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“FlavourSuite AI” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ FlavourSuite ](https://profiles.wordpress.org/masrawy2025/)

[Translate “FlavourSuite AI” into your language.](https://translate.wordpress.org/projects/wp-plugins/flavoursuite-ai)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/flavoursuite-ai/), 
check out the [SVN repository](https://plugins.svn.wordpress.org/flavoursuite-ai/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/flavoursuite-ai/)
by [RSS](https://plugins.trac.wordpress.org/log/flavoursuite-ai/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 0.3.0

 * Connection tokens: create named, revocable, optionally expiring bearer tokens
   for each agent. Unlike an Application Password they are accepted only on the 
   MCP endpoint, so a leaked agent config cannot be used against the rest of the
   REST API. Only a SHA-256 hash is stored and the token is displayed once, at creation.
 * OAuth discovery: the authorization-server and protected-resource documents are
   now served from `/.well-known/`, so cloud MCP clients (claude.ai, ChatGPT) can
   find and connect to the site without an Application Password.
 * Connected agents: OAuth clients are now listed under Settings  FlavourSuite AI
   with a Revoke action that removes the registration and immediately invalidates
   every token issued to it.
 * Rate limiting: authenticated tool calls are capped per user per minute (60 by
   default, configurable, 0 to disable) and the public OAuth endpoints are capped
   per IP. Over-budget requests get a 429 with Retry-After.
 * Audit log export: download the recorded tool calls as CSV.
 * Connection recipes for every major agent: pick your client on the settings screen
   and get the exact config block for it — Claude Code, Codex CLI, OpenCode, Cursor,
   VS Code, Cline, Roo Code, Windsurf, Claude and ChatGPT cloud connectors, GUI 
   apps such as Cherry Studio and LibreChat, plus an `mcp-remote` stdio bridge that
   covers any other agent. Works regardless of which model the agent runs.

#### 0.2.1

 * Proposed CSS is now validated with WordPress core’s own Customizer CSS validation(
   the same checks as Appearance  Additional CSS), both when an agent proposes it
   and again before it is applied.
 * List change requests now only returns requests the current user authored or has
   the capability to decide, instead of all requests.
 * Updated the jetpack-autoloader library to 5.0.21.

#### 0.2.0

 * Approvals: agents propose, humans approve. New change-request flow with before/
   after diffs, approve/reject, and rollback under Tools  Agent Changes.
 * New tools: get custom CSS, propose custom CSS change, propose content edit, list
   change requests. Propose tools are off by default.
 * Staleness protection: a proposal is refused at apply time if the CSS or post 
   changed after it was made; rollback is refused if the target changed after apply.
 * Lowered the PHP requirement to 7.4.

#### 0.1.0

 * Initial release.
 * MCP server (Streamable HTTP) built on the core Abilities API and the official
   wordpress/mcp-adapter.
 * Tools: site overview, list recent posts, search content, site policies, WooCommerce
   store overview (auto-detected), FluentCRM 3.0+ tool curation (auto-detected).
 * Settings screen: master switch (off by default), per-tool toggles, connection
   snippet.
 * Audit log of tool calls (user, tool, status, duration — never arguments or results).

## Meta

 *  Version **0.3.0**
 *  Last updated **16 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.9 or higher **
 *  Tested up to **7.0.2**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [Agents](https://wordpress.org/plugins/tags/agents/)[AI](https://wordpress.org/plugins/tags/ai/)
   [ChatGPT](https://wordpress.org/plugins/tags/chatgpt/)[Claude](https://wordpress.org/plugins/tags/claude/)
   [mcp](https://wordpress.org/plugins/tags/mcp/)
 *  [Advanced View](https://wordpress.org/plugins/flavoursuite-ai/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/flavoursuite-ai/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/flavoursuite-ai/reviews/)

## Contributors

 *   [ FlavourSuite ](https://profiles.wordpress.org/masrawy2025/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/flavoursuite-ai/)