Mehul Gohil

<p>Aculect AI Companion is a secure MCP connector for WordPress. It lets approved AI assistants such as ChatGPT, Claude, Codex, and OpenAI-compatible tools work with your WordPress content, media, comments, and site information through permission-aware workflows.</p>
<p>Instead of switching between WordPress admin screens, you can ask your AI assistant in plain English to draft a post, update a page, review comments, upload media, inspect safe site details, or prepare long-form content using WordPress blocks.</p>
<p>WordPress remains the source of truth. Aculect AI Companion checks the connected WordPress user’s permissions before every action, lets administrators choose which abilities are available, and keeps risky write actions behind configurable controls.</p>
<h4>What is MCP for WordPress?</h4>
<p>MCP stands for Model Context Protocol. In Aculect AI Companion, MCP gives supported AI assistants a structured, permission-controlled way to request WordPress actions. The assistant does not receive direct database access. It can only use the enabled tools exposed by WordPress and approved by an administrator.</p>
<h4>Why use Aculect AI Companion?</h4>
<ul>
<li>Connect WordPress to ChatGPT, Claude, Codex, and OpenAI-compatible MCP clients</li>
<li>Create, update, and organize WordPress content through controlled AI workflows</li>
<li>Work with posts, pages, custom post types, categories, tags, comments, and media</li>
<li>Use block-aware content workflows instead of raw custom HTML</li>
<li>Review AI activity with sanitized audit logs</li>
<li>Control access globally, by connection, by role, and by WordPress user permissions</li>
<li>Use diagnostics to verify OAuth, MCP, endpoint, and environment readiness</li>
</ul>
<p>Setup is designed to be simple:</p>
<ol>
<li>Copy your connection URL from AI Companion > Connect.</li>
<li>Open your AI tool and add a new connector.</li>
<li>Paste the URL when prompted.</li>
<li>Approve the connection on the screen that appears.</li>
</ol>
<p>After approval, Aculect AI Companion checks the connected WordPress user’s permissions before every action. You can also choose exactly what your AI assistant can do and disconnect assistants at any time.</p>
<h4>Features</h4>
<ul>
<li>Create, edit, and publish posts, pages, and supported custom post types</li>
<li>Plan and draft long-form block content for WordPress</li>
<li>Manage categories, tags, custom taxonomies, and content groups</li>
<li>Moderate, reply to, and bulk-manage comments</li>
<li>Upload, list, update, attach, detach, and safely rename media</li>
<li>View safe site settings, active plugins, active themes, and diagnostics</li>
<li>Connect, pause, review, and disconnect AI assistants</li>
<li>Control which MCP abilities each assistant can use</li>
</ul>
<h4>Supported AI Tools</h4>
<p>Aculect AI Companion includes setup guidance for popular AI assistants and MCP clients:</p>
<ul>
<li>ChatGPT app with Developer Mode connectors</li>
<li>OpenAI API integrations that support remote connectors</li>
<li>Claude app, Claude Desktop, Claude Cowork, and Claude mobile</li>
<li>Claude Code</li>
<li>Claude API integrations that support remote connectors</li>
</ul>
<p>Your AI tool must be able to reach your WordPress site over HTTPS to complete OAuth approval and send MCP requests.</p>
<h4>Supported Abilities</h4>
<p>Admins can enable or disable these abilities from AI Companion > Abilities after the first assistant connection is active.</p>
<p>Long-form content workflows:</p>
<ul>
<li>Prepare a post outline, section plan, taxonomy recommendations, media recommendations, and SEO recommendations</li>
<li>Create a draft from validated serialized WordPress block content</li>
<li>Update an existing post with block-safe content workflows</li>
<li>Update Rank Math SEO title, description, and focus keywords when Rank Math is active</li>
</ul>
<p>Content:</p>
<ul>
<li>List readable content types, including custom post types</li>
<li>List posts, pages, and custom content items with pagination</li>
<li>Read one content item by ID</li>
<li>Create a post, page, or custom content item with optional featured image, author, and taxonomy assignments</li>
<li>Update title, content, excerpt, slug, status, featured image, author, or taxonomy assignments for an existing item</li>
<li>Update SEO title, SEO description, and focus keywords for supported SEO plugins</li>
</ul>
<p>Content groups:</p>
<ul>
<li>List available categories, tags, and custom content groups</li>
<li>List terms for a supported taxonomy with pagination</li>
<li>Create a category, tag, or custom content group</li>
<li>Update a category, tag, or custom content group</li>
<li>Assign or clear an image for supported taxonomy terms</li>
</ul>
<p>Comments:</p>
<ul>
<li>List comments for review with pagination</li>
<li>Read one comment by ID</li>
<li>Reply to a comment as the connected WordPress user</li>
<li>Moderate comment content or status</li>
<li>Bulk moderate multiple comments</li>
</ul>
<p>Media:</p>
<ul>
<li>List media library attachments with pagination</li>
<li>Read, update, trash, and safely rename media items</li>
<li>Upload media from a public URL with server-side request checks</li>
<li>Attach media to posts or detach media from posts</li>
</ul>
<p>Site information:</p>
<ul>
<li>View safe, non-secret site settings</li>
<li>View WordPress version, PHP version, active theme, and basic site metadata</li>
<li>List installed plugins and active state for users who can manage plugins</li>
<li>List installed themes and active state for users who can manage themes</li>
</ul>
<p>WordPress abilities:</p>
<ul>
<li>Discover supported public WordPress abilities registered by WordPress and plugins</li>
<li>Inspect one supported public WordPress ability</li>
<li>Run a supported public WordPress ability using the connected user’s permissions</li>
</ul>
<h3>Third Party Services</h3>
<p>Aculect AI Companion does not send site data to an external service on activation, page load, cron, or without a site administrator connecting an AI assistant.</p>
<p>When a site administrator copies the connection URL into an external AI assistant and approves the connection screen in WordPress, that assistant can request the enabled abilities. Depending on the enabled abilities and the connected WordPress user’s permissions, requested data may include post titles, post content, excerpts, slugs, statuses, authors, dates, permalinks, category and tag names, media metadata, comments, and safe site settings such as site name, description, URLs, locale, timezone, date format, time format, permalink structure, and active theme name.</p>
<p>The external service that receives this data is the AI assistant selected and configured by the administrator. Aculect AI Companion’s built-in setup UI includes links for:</p>
<ul>
<li>ChatGPT by OpenAI: https://chatgpt.com/, terms at https://openai.com/policies/terms-of-use/, and privacy policy at https://openai.com/policies/row-privacy-policy/</li>
<li>Claude by Anthropic: https://claude.ai/, terms at https://www.anthropic.com/legal/consumer-terms, and privacy policy at https://www.anthropic.com/legal/privacy</li>
</ul>
<p>Administrators should review the terms and privacy policy for the AI assistant they connect. Aculect AI Companion controls the WordPress-side approval and permissions checks; it does not control how a connected external assistant processes data after the administrator authorizes access.</p>
<h3>Development</h3>
<p>The production package ships built assets and Composer dependencies. Development manifests such as <code>composer.json</code>, <code>composer.lock</code>, and <code>package.json</code> are intentionally excluded from release ZIP files. Generated files under <code>build/</code> are not committed to the source repository; release automation generates them before packaging.</p>
<p>For source code, build tooling, and exact dependency manifests, use the public GitHub repository:</p>
<p>https://github.com/mehul0810/aculect-ai-companion</p>
<p>Contributing guidelines:</p>
<p>https://github.com/mehul0810/aculect-ai-companion/blob/main/CONTRIBUTING.md</p>
<p>Security policy:</p>
<p>https://github.com/mehul0810/aculect-ai-companion/security/policy</p>
<p>From the repository checkout, use the Node.js version in <code>.nvmrc</code> and rebuild assets with:</p>
<pre><code>npm ci
npm run build
</code></pre>
<p>Composer dependencies for production releases are installed with:</p>
<pre><code>composer install --no-dev --prefer-dist --optimize-autoloader
</code></pre>


Aculect AI Companion

Use ChatGPT, Claude, Codex, and other MCP AI assistants to manage WordPress content, media, comments, and site workflows.

Olivier D. aka oliezekat

<blockquote>
<p>Back WordPress API to the content.</p>
</blockquote>
<p>You can request some* functions of WordPress API with same syntax for arguments into your posts, pages, or widgets content.<br />
 functionsCapacitor will insert function result into your content as HTML output.</p>
<p>(*) see <a href="https://wordpress.org/extend/plugins/functionscapacitor/other_notes/#Supported-functions" rel="ugc">Supported functions</a><br />
or <a href="https://wordpress.org/extend/plugins/functionscapacitor/other_notes/#Supported-conditional-functions" rel="ugc">conditional tags</a>.</p>
<h4>Features</h4>
<ul>
<li>Safe process to use this plugin on WordPress MU or WP MultiSite.</li>
<li>Allow to personalize <a href="https://wordpress.org/extend/plugins/functionscapacitor/other_notes/#Embedded-output" rel="ugc">Embedded output</a><br />
for each functions.</li>
<li>Easy and powerfull <a href="https://wordpress.org/extend/plugins/functionscapacitor/other_notes/#Functions-arguments-syntax" rel="ugc">Functions arguments syntax</a><br />
to apply any WordPress API options.</li>
<li>Generic functions arguments with <a href="https://wordpress.org/extend/plugins/functionscapacitor/other_notes/#Magic-keywords" rel="ugc">Magic keywords</a>.</li>
<li>NEW: use <a href="https://wordpress.org/extend/plugins/functionscapacitor/other_notes/#Supported-conditional-functions" rel="ugc">WordPress conditional tags</a> as option to display a widget.</li>
<li>Structured source-code to prevent any conflict.</li>
</ul>
<p>Three methods to use WordPress API functions :</p>
<h4>Method by shortcode tag</h4>
<p>Insert a tag into your content like [fct function_name=”parameter1=value&parameter2=value”].</p>
<p>One shortcode tag can request several functions, input [fct function_name1=”arguments” function_name2=”arguments”].</p>
<h4>Method with a widget</h4>
<p>Add a functionsCapacitor widget, select a function, input function parameters like “parameter1=value&parameter2=value” (without quotes).</p>
<p>Optional: choose a <a href="https://wordpress.org/extend/plugins/functionscapacitor/other_notes/#Supported-conditional-functions" rel="ugc">supported conditional function</a> to decide where to display your widget.</p>
<h4>Method by custom fields</h4>
<p>Set a custom field name with function name and put function arguments into custom field value like “parameter1=value&parameter2=value” (without quotes).</p>
<ul>
<li>Result is always inserted at end.</li>
<li>Plugin has priority 5. Most plugins use priority 10.</li>
<li>This method is applied if post/page is displayed.</li>
</ul>
<h4>Examples</h4>
<ul>
<li>Tag cloud of popular posts tags,<br />
insert [fct wp_tag_cloud]</li>
<li>List of children pages of current page,<br />
insert [fct wp_list_pages=”title_li=&child_of=%postID%&depth=1″]</li>
<li>List of category’s recent posts with excerpts,<br />
insert [fct wp_get_recent_posts=”category=X&fct:show_excerpt=1″]<br />
with X equal category ID number</li>
<li>List of categories without default category,<br />
insert [fct wp_list_categories=”title_li=&exclude=%defaultcatID%”]</li>
</ul>
<h3>Embedded output</h3>
<p>Any functionsCapacitor request will insert <code><div class="functionsCapacitor">functions output</div></code>.<br />
 Shortcode method allow to personalize main container like<br />
 [fct container=”HTML tag name” class=”class(es) name(s)” style=”CSS properties” function1=”args” function2=”args”].<br />
 set container=”” to remove main container.</p>
<p>Some functions output were inserted with dedicated container like</p>
<ul>function output</ul>
<p>or <code><div class="function_name">function output</div></code>.<br />
 Personalize this container with <a href="https://wordpress.org/extend/plugins/functionscapacitor/other_notes/#Special-functions-parameters" rel="ugc">Special functions parameters</a>.</p>
<h3>Functions arguments syntax</h3>
<p>Follow these examples to setup your requests :</p>
<ul>
<li>“parameter1=something&parameter2=25”,<br />
parameter1 and parameter2 typed as strings.</li>
<li>“parameter1=something&parameter2=false”,<br />
parameter2 typed as boolean.</li>
<li>“parameter1=&parameter2= &parameter3=””,<br />
any parameters equal empty string.</li>
<li>“parameter1= something &parameter2=’ something ‘”,<br />
parameter1 equal ‘something’,<br />
parameter2 equal ‘ something ‘.</li>
<li>“parameter1=something&parameter2=array(‘something’,’something’)”,<br />
parameter2 typed as an array of 2 strings.</li>
<li>“parameter1=something&parameter2=array(10,5,20)”,<br />
parameter2 typed as an array of 3 integers.</li>
<li>“parameter1=something&parameter2=array(true,false)”,<br />
parameter2 typed as an array of 2 booleans.</li>
</ul>
<p>Not supported issues :</p>
<ul>
<li>parameter’s value can’t contain “&” or “=” characters.</li>
<li>parameter’s value can’t contain an associative array like array(‘name’=>value,’name’=>value).</li>
<li>parameter’s value can’t contain an array of arrays.</li>
<li>parameter’s value can’t contain a PHP variable like $post->ID,<br />
see <a href="https://wordpress.org/extend/plugins/functionscapacitor/other_notes/#Magic-keywords" rel="ugc">Magic keywords</a>.</li>
<li>parameter’s value can’t request a PHP or WordPress function.</li>
<li>parameter’s value can’t contain PHP source-code.</li>
</ul>
<h3>Magic keywords</h3>
<p>Use these keywords to obtain variables values into your functions arguments :</p>
<ul>
<li>%postID% => $post->ID,<br />
ID of post or page where made the request :<br />
related post/page into a shortcode,<br />
or current post/page into a widget.</li>
<li>%postparent% => $post->post_parent,<br />
ID of parent page where made the request.</li>
<li>%postauthor% => $post->post_author,<br />
author ID of post where made the request.</li>
<li>%defaultcatID% => default_category,<br />
ID of default category for newest posts.</li>
<li>%posttagIDs% => wp_get_post_tags(),<br />
string of current post tags IDs as “1,2,3,…”</li>
<li>%posttagslugs% => wp_get_post_tags(),<br />
string of current post tags slugs as “slug-name,slug-name,…”</li>
</ul>
<p>You can use magic keywords into an array.<br />
 Example: wp_list_categories=”exclude=array(%defaultcatID%,1,2,…)”</p>
<h3>Special functions parameters</h3>
<ul>
<li>fct:container to set HTML tag of function container.<br />
Set “fct:container=”” to remove this container.<br />
Each functions have a default container related to its output.</li>
<li>fct:container_id to set container “id” attribute.</li>
<li>fct:container_class to set container “class” attribute.<br />
Function name as default.<br />
Example with shortcode: [fct function_name=”fct:container_class=name&param1=value&param2=value”].</li>
<li>fct:container_style to set container “style” attribute.</li>
</ul>
<p>functionsCapacitor not create a container if the API function still return a container.<br />
 See <a href="https://codex.wordpress.org/Function_Reference" title="Wordpress documentation" rel="nofollow ugc">WordPress Codex</a> to personalize them.</p>
<h3>Supported functions</h3>
<ul>
<li>get_the_post_thumbnail()<br />
with size=thumbnail|medium|large|post-thumbnail<br />
or size name defined with add_image_size() into theme’s file functions.php.</li>
<li>get_the_tag_list()<br />
with before=”&sep=’ ‘&after=” as default,<br />
apply only on page or post,<br />
rendered into DIV container</li>
<li>wp_get_archives()<br />
with echo=0&format=html as default</li>
<li>wp_get_recent_posts()<br />
rendered as list with UL container,<br />
with exclude=%postID%&suppress_filters=false&post_status=publish&fct:perm=readable as default<br />
(see bellow)</li>
<li>wp_list_authors()<br />
with echo=0 as default</li>
<li>wp_list_bookmarks()<br />
with echo=0 as default</li>
<li>wp_list_categories()<br />
with echo=0 as default</li>
<li>wp_list_pages()<br />
with echo=0 as default</li>
<li>wp_nav_menu()<br />
with echo=false as default,<br />
see Codex to setting its container</li>
<li>wp_tag_cloud()<br />
with echo=0 as default,<br />
format=flat|list only</li>
</ul>
<p>See <a href="https://codex.wordpress.org/Function_Reference" title="Wordpress documentation" rel="nofollow ugc">WordPress Codex</a> about these functions and their arguments syntax.</p>
<p>Need you to support more functions, mail to oliezekat@yahoo.fr</p>
<h4>wp_get_recent_posts()</h4>
<ul>
<li>if fct:perm=readable hide draft, future, pending, protected posts<br />
but display private posts if user is allowed.</li>
<li>if fct:perm=” not output permalink of draft, future, pending, private posts.</li>
<li>set fct:show_excerpt=1|true to display posts excerpts.</li>
<li>set fct:show_date=1|true to display posts dates.</li>
<li>set fct:show_thumbnail=1|true to display post thumbnail,<br />
with fct:thumbnail_size=thumbnail|medium|large|post-thumbnail<br />
or size name defined with add_image_size() into theme’s file functions.php.</li>
<li>fct:show_thumbnail=true if fct:thumbnail_size is defined</li>
<li>display excerpt and thumbnail for draft, future, pending, private, and protected posts<br />
but not create an excerpt from content.</li>
</ul>
<h3>Supported conditional functions</h3>
<ul>
<li>cat_is_ancestor_of()<br />
check if current category is child of conditional argument.</li>
<li>in_category()</li>
<li>is_category()</li>
<li>is_front_page()</li>
<li>is_home()</li>
<li>is_page()</li>
<li>is_single()</li>
</ul>
<p>See <a href="https://codex.wordpress.org/Conditional_Tags" title="Wordpress documentation" rel="nofollow ugc">WordPress Conditional Tags</a> about these functions and their arguments syntax.</p>
<h4>Not canonical conditional functions</h4>
<p>These functions are designed for this plugin only, not available elsewhere, and not documented into the WordPress Codex.</p>
<ul>
<li>in_tree_of()<br />
check if page, post, or category is descendant of conditional argument (or itself),<br />
require argument as page or category numeric ID.</li>
<li>is_category_in_tree_of()<br />
check if category is descendant of conditional argument (or itself),<br />
require argument as category numeric ID.</li>
<li>is_page_descendant_of()<br />
check if page is descendant of conditional argument,<br />
require argument as page numeric ID.</li>
<li>is_page_in_tree_of()<br />
check if page is descendant of conditional argument (or itself),<br />
require argument as page numeric ID.</li>
<li>is_single_in_tree_of()<br />
check if post is in descendant of conditional argument,<br />
require argument as category numeric ID.</li>
</ul>
<h4>Conditional functions arguments syntax</h4>
<p>Support only arguments as single value ; string, numeric, or <a href="https://wordpress.org/extend/plugins/functionscapacitor/other_notes/#Magic-keywords" rel="ugc">magic keyword</a>.</p>


functionsCapacitor

This plugin allow to apply some WordPress API's functions into your post/page content or as a widget.

Aculect AI Companion vs functionsCapacitor