{"id":323892,"date":"2026-06-17T08:52:53","date_gmt":"2026-06-17T08:52:53","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/ai-cart-assistant\/"},"modified":"2026-06-17T08:52:30","modified_gmt":"2026-06-17T08:52:30","slug":"kzb-ai-cart-assistant","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/kzb-ai-cart-assistant\/","author":23297975,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.2","stable_tag":"1.0.2","tested":"7.0","requires":"7.0","requires_php":"8.3","requires_plugins":null,"header_name":"KZB AI Cart Assistant for WooCommerce","header_author":"KZB Studio","header_description":"AI-powered WooCommerce cart assistant \u2014 exposes an MCP server for autonomous agents and a storefront chatbot powered by the WordPress AI Client.","assets_banners_color":"82aff2","last_updated":"2026-06-17 08:52:30","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/wordpress.org\/plugins\/kzb-ai-cart-assistant\/","header_author_uri":"https:\/\/kzbstudio.pl","rating":0,"author_block_rating":0,"active_installs":0,"downloads":16,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.2":{"tag":"1.0.2","author":"kzbstudio","date":"2026-06-17 08:52:30"}},"upgrade_notice":{"1.0.2":"<p>Security hardening: product catalog endpoint no longer exposes hidden products; Ability API requires login.<\/p>","1.0.1":"<p>This update renames internal plugin identifiers (prefix <code>kzb<\/code> \u2192 <code>kzbaca<\/code>) and migrates the chatbot to the WordPress AI Client. After upgrading, re-activate the plugin to recreate the audit log table under the new name. Existing Bearer tokens will be invalidated and must be regenerated. Requires WordPress 7.0.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3575557,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3575557,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon.svg":{"filename":"icon.svg","revision":3575557,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3575471,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3575471,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250},"banner.svg":{"filename":"banner.svg","revision":3575471,"resolution":false,"location":"assets","locale":false}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.2"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3575471,"resolution":"1","location":"assets","locale":"","width":1440,"height":902},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3575471,"resolution":"2","location":"assets","locale":"","width":1440,"height":902},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3575471,"resolution":"3","location":"assets","locale":"","width":1440,"height":902},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3575471,"resolution":"4","location":"assets","locale":"","width":1440,"height":902},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3575471,"resolution":"5","location":"assets","locale":"","width":1440,"height":900},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3575471,"resolution":"6","location":"assets","locale":"","width":1440,"height":1391},"screenshot-7.png":{"filename":"screenshot-7.png","revision":3575471,"resolution":"7","location":"assets","locale":"","width":1440,"height":900},"screenshot-8.png":{"filename":"screenshot-8.png","revision":3575471,"resolution":"8","location":"assets","locale":"","width":1440,"height":900},"screenshot-9.png":{"filename":"screenshot-9.png","revision":3575471,"resolution":"9","location":"assets","locale":"","width":1440,"height":900}},"screenshots":{"1":"Admin panel \u2014 Settings tab with allowed product categories and security limits.","2":"Admin panel \u2014 API Tokens tab with token generation and active tokens list.","3":"Admin panel \u2014 Audit Log showing AI cart operations with status and error codes.","4":"Admin panel \u2014 Chatbot tab with widget settings (AI provider configured in Settings \u2192 AI).","5":"Storefront \u2014 chat widget open with product recommendation cards.","6":"My Account \u2014 AI Assistant tab where customers can manage their own tokens.","7":"Storefront chatbot \u2014 customer asks about outdoor LED lights; assistant replies with matching product cards.","8":"Storefront chatbot \u2014 product detail panel slides in showing image, price, description, and a link to the product page.","9":"Storefront chatbot \u2014 after asking to add a product, the assistant confirms and displays a \"Go to cart\" button; the cart badge updates in the widget header."}},"plugin_section":[],"plugin_tags":[2353,3047,2364,242115,286],"plugin_category":[45],"plugin_contributors":[262273],"plugin_business_model":[],"class_list":["post-323892","plugin","type-plugin","status-publish","hentry","plugin_tags-ai","plugin_tags-cart","plugin_tags-chatbot","plugin_tags-mcp","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-kzbstudio","plugin_committers-kzbstudio"],"banners":{"banner":"https:\/\/ps.w.org\/kzb-ai-cart-assistant\/assets\/banner-772x250.png?rev=3575471","banner_2x":"https:\/\/ps.w.org\/kzb-ai-cart-assistant\/assets\/banner-1544x500.png?rev=3575471","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/kzb-ai-cart-assistant\/assets\/icon.svg?rev=3575557","icon":"https:\/\/ps.w.org\/kzb-ai-cart-assistant\/assets\/icon.svg?rev=3575557","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/kzb-ai-cart-assistant\/assets\/screenshot-1.png?rev=3575471","caption":"Admin panel \u2014 Settings tab with allowed product categories and security limits."},{"src":"https:\/\/ps.w.org\/kzb-ai-cart-assistant\/assets\/screenshot-2.png?rev=3575471","caption":"Admin panel \u2014 API Tokens tab with token generation and active tokens list."},{"src":"https:\/\/ps.w.org\/kzb-ai-cart-assistant\/assets\/screenshot-3.png?rev=3575471","caption":"Admin panel \u2014 Audit Log showing AI cart operations with status and error codes."},{"src":"https:\/\/ps.w.org\/kzb-ai-cart-assistant\/assets\/screenshot-4.png?rev=3575471","caption":"Admin panel \u2014 Chatbot tab with widget settings (AI provider configured in Settings \u2192 AI)."},{"src":"https:\/\/ps.w.org\/kzb-ai-cart-assistant\/assets\/screenshot-5.png?rev=3575471","caption":"Storefront \u2014 chat widget open with product recommendation cards."},{"src":"https:\/\/ps.w.org\/kzb-ai-cart-assistant\/assets\/screenshot-6.png?rev=3575471","caption":"My Account \u2014 AI Assistant tab where customers can manage their own tokens."},{"src":"https:\/\/ps.w.org\/kzb-ai-cart-assistant\/assets\/screenshot-7.png?rev=3575471","caption":"Storefront chatbot \u2014 customer asks about outdoor LED lights; assistant replies with matching product cards."},{"src":"https:\/\/ps.w.org\/kzb-ai-cart-assistant\/assets\/screenshot-8.png?rev=3575471","caption":"Storefront chatbot \u2014 product detail panel slides in showing image, price, description, and a link to the product page."},{"src":"https:\/\/ps.w.org\/kzb-ai-cart-assistant\/assets\/screenshot-9.png?rev=3575471","caption":"Storefront chatbot \u2014 after asking to add a product, the assistant confirms and displays a \"Go to cart\" button; the cart badge updates in the widget header."}],"raw_content":"<!--section=description-->\n<p>KZB AI Cart Assistant for WooCommerce connects your store to AI systems using the open <strong>Model Context Protocol (MCP)<\/strong>. It also adds an optional AI-powered chat widget to your storefront, powered by the <strong>WordPress AI Client<\/strong> built into WordPress 7.0.<\/p>\n\n<p><strong>The guiding principle: automation stops at the cart.<\/strong> The plugin never initiates checkout or processes payments \u2014 those actions always require a human.<\/p>\n\n<h4>What the free version includes<\/h4>\n\n<ul>\n<li><strong>MCP server<\/strong> \u2014 REST endpoints that expose your product catalog and allow authenticated AI agents to add products to a customer's cart (<code>add_to_cart<\/code>) and view cart contents (<code>view_cart<\/code>)<\/li>\n<li><strong>Storefront chatbot<\/strong> \u2014 floating chat widget powered by the WordPress AI Client; customers can ask product questions and add items to their cart through conversation<\/li>\n<li><strong>Bearer token authentication<\/strong> \u2014 per-user tokens that let an AI agent act on a specific customer's behalf<\/li>\n<li><strong>My Account integration<\/strong> \u2014 customers can generate and revoke their own tokens from the My Account page<\/li>\n<li><strong>Admin panel<\/strong> \u2014 category filters, security limits (max quantity, max cart value), token management, and an audit log of every AI action<\/li>\n<li><strong>Privacy-first<\/strong> \u2014 respects the Global Privacy Control (GPC) signal; no API keys are stored by the plugin<\/li>\n<\/ul>\n\n<h4>Pro version<\/h4>\n\n<p>The <strong>KZB AI Cart Assistant Pro<\/strong> extension unlocks additional MCP tools and support for variable (configurable) products:<\/p>\n\n<ul>\n<li><code>remove_from_cart<\/code> \u2014 remove a specific product from the cart<\/li>\n<li><code>update_cart<\/code> \u2014 change the quantity of a cart item (quantity 0 removes the item)<\/li>\n<li><code>clear_cart<\/code> \u2014 empty the entire cart<\/li>\n<li>Variable product support \u2014 add product variants by specifying a variation ID<\/li>\n<\/ul>\n\n<p>The Pro extension is available at <a href=\"https:\/\/kzbstudio.pl\">kzbstudio.pl<\/a>.<\/p>\n\n<h4>MCP Server<\/h4>\n\n<p>AI agents discover the MCP endpoint via a <code>&lt;link rel=\"mcp-server\"&gt;<\/code> tag automatically injected into your site's <code>&lt;head&gt;<\/code>. The agent can then browse the product catalog (JSON-LD format) and call tools on behalf of an authenticated customer.<\/p>\n\n<p>Typical agent flow:<\/p>\n\n<ol>\n<li>Agent reads <code>&lt;link rel=\"mcp-server\"&gt;<\/code> from your page HTML<\/li>\n<li><code>GET \/wp-json\/kzbaca\/v1\/mcp<\/code> \u2014 reads available tools and the product catalog URL<\/li>\n<li><code>GET \/wp-json\/kzbaca\/v1\/mcp\/resources<\/code> \u2014 fetches the product list<\/li>\n<li><code>POST \/wp-json\/kzbaca\/v1\/mcp\/tools\/add_to_cart<\/code> \u2014 adds a product (Bearer token required)<\/li>\n<li>Agent returns the cart URL to the customer for payment<\/li>\n<\/ol>\n\n<h4>External Services<\/h4>\n\n<p>This plugin connects to external AI services <strong>only when the chatbot is enabled and an AI provider is configured in WordPress Settings \u2192 AI<\/strong>. No data is sent to any external service when the chatbot is disabled (the default state).<\/p>\n\n<p><strong>WordPress AI Client<\/strong>\nThe storefront chatbot uses the WordPress AI Client (built into WordPress 7.0) to communicate with your configured AI provider. The AI provider and its privacy policy are managed in <strong>Settings \u2192 AI<\/strong> in your WordPress admin \u2014 this plugin does not communicate directly with any AI provider.\nData sent: conversation messages, product catalog summary, cart context.<\/p>\n\n<p>No data is ever sent to the plugin author's servers.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>kzb-ai-cart-assistant<\/code> folder to <code>\/wp-content\/plugins\/<\/code>, or install through the WordPress plugin directory.<\/li>\n<li>Activate <strong>KZB AI Cart Assistant for WooCommerce<\/strong> from the Plugins screen.<\/li>\n<li>Go to <strong>WooCommerce \u2192 KZB AI Cart Assistant<\/strong> to configure the plugin.<\/li>\n<li>To enable the chatbot: configure an AI provider in <strong>Settings \u2192 AI<\/strong>, then open the <strong>Chatbot<\/strong> tab and enable the widget.<\/li>\n<li>To authorise an AI agent: open the <strong>API Tokens<\/strong> tab, select a user, and generate a Bearer token.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20this%20plugin%20process%20payments%3F\"><h3>Does this plugin process payments?<\/h3><\/dt>\n<dd><p>No. The plugin can add items to a WooCommerce cart and view the cart. Checkout and payment always require a human action. This is by design.<\/p><\/dd>\n<dt id=\"how%20do%20i%20configure%20the%20ai%20provider%20for%20the%20chatbot%3F\"><h3>How do I configure the AI provider for the chatbot?<\/h3><\/dt>\n<dd><p>The chatbot uses the WordPress AI Client, which is built into WordPress 7.0. Go to <strong>Settings \u2192 AI<\/strong> in your WordPress admin to configure your preferred AI provider. No API key is needed in the plugin settings.<\/p><\/dd>\n<dt id=\"can%20customers%20manage%20their%20own%20tokens%3F\"><h3>Can customers manage their own tokens?<\/h3><\/dt>\n<dd><p>Yes. Logged-in customers can generate and revoke their own Bearer tokens from <strong>My Account \u2192 AI Assistant<\/strong>. Admins can also create and revoke tokens for any user from the admin panel.<\/p><\/dd>\n<dt id=\"what%20is%20mcp%20%28model%20context%20protocol%29%3F\"><h3>What is MCP (Model Context Protocol)?<\/h3><\/dt>\n<dd><p>MCP is an open protocol that lets AI systems interact with external tools and data sources in a standardised way. This plugin implements an MCP server so that any compatible AI agent can interact with your WooCommerce store.<\/p><\/dd>\n<dt id=\"does%20the%20plugin%20work%20if%20woocommerce%20is%20not%20active%3F\"><h3>Does the plugin work if WooCommerce is not active?<\/h3><\/dt>\n<dd><p>No. WooCommerce is a required dependency. If it is not active, the plugin displays a warning in the admin and does not initialise.<\/p><\/dd>\n<dt id=\"what%20data%20is%20sent%20to%20external%20ai%20services%3F\"><h3>What data is sent to external AI services?<\/h3><\/dt>\n<dd><p>When the chatbot processes a message, the plugin sends conversation history, a summary of your product catalog, and cart context to the AI provider configured in WordPress Settings \u2192 AI. No customer personal data beyond the conversation content is sent.<\/p><\/dd>\n<dt id=\"what%20is%20included%20in%20the%20free%20version%3F\"><h3>What is included in the free version?<\/h3><\/dt>\n<dd><p>The free version includes the full MCP server (add to cart, view cart), the AI chatbot (using the WordPress AI Client), Bearer token authentication, the My Account integration, and the admin panel with audit log and category\/limit controls.<\/p><\/dd>\n<dt id=\"what%20does%20the%20pro%20extension%20add%3F\"><h3>What does the Pro extension add?<\/h3><\/dt>\n<dd><p>The Pro extension adds the <code>remove_from_cart<\/code>, <code>update_cart<\/code>, and <code>clear_cart<\/code> MCP tools and variable product support. See <a href=\"https:\/\/kzbstudio.pl\">kzbstudio.pl<\/a> for details.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Fixed: product catalog endpoint now excludes products with <code>catalog_visibility = hidden<\/code>, aligning public exposure with WooCommerce storefront behaviour<\/li>\n<li>Fixed: <code>add-to-cart<\/code> Ability now requires the user to be logged in (<code>is_user_logged_in()<\/code>), consistent with the \"authenticated user's cart\" contract<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Migrated chatbot to WordPress AI Client (built-in WP 7.0) \u2014 no API key needed in plugin settings<\/li>\n<li>Renamed internal prefix from <code>kzb<\/code> to <code>kzbaca<\/code> to meet WordPress.org guidelines (4+ character prefix)<\/li>\n<li>Bumped minimum WordPress requirement to 7.0<\/li>\n<li>Removed direct Google Gemini API integration from free plugin<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial public release<\/li>\n<li>MCP server: product catalog (JSON-LD), <code>add_to_cart<\/code> and <code>view_cart<\/code> tools<\/li>\n<li>AI chatbot widget: Google Gemini integration, product recommendation cards, cart view and removal<\/li>\n<li>Bearer token authentication per WordPress user<\/li>\n<li>My Account integration: self-service token generation and revocation<\/li>\n<li>Admin panel: category filters, security limits, token management, audit log<\/li>\n<li>Pro features (remove\/update\/clear cart, variable products) available via KZB AI Cart Assistant Pro extension<\/li>\n<li>Polish translation included (pl_PL)<\/li>\n<\/ul>","raw_excerpt":"Allow AI agents and a storefront chatbot to browse your product catalog and add items to customers&#039; carts. Payment is always completed by a human.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/323892","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=323892"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/kzbstudio"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=323892"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=323892"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=323892"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=323892"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=323892"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=323892"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}