Description
Uncap AI Shopping Connector for WooCommerce connects your store to AI shopping agents. It implements the Universal Commerce Protocol (UCP) and Model Context Protocol (MCP), so any AI agent that speaks these open standards can discover your store, search products, and create checkouts — without any custom integration work on your part.
What this means in practice
AI agents like Claude, ChatGPT, and others are beginning to shop on behalf of users. When a user says “order me roses for my wife’s birthday,” the agent needs a structured way to find a store, check availability, and complete a purchase. UCP is the protocol that makes that possible. This plugin makes your WooCommerce store a first-class destination for those agents.
Features
- UCP discovery —
/.well-known/ucpand REST discovery endpoint so agents can find and understand your store automatically - Product search — AI-optimised search endpoint with full product metadata, pricing, availability, and attributes
- Checkout flow — create, update, and complete checkouts via REST API with support for fulfillment, coupons, and webhooks
- MCP endpoint — JSON-RPC 2.0 server at
/wp-json/ucp/v1/mcpfor tool-calling agents like Claude Desktop - WebMCP — browser-based agent integration so in-browser AI agents can search and initiate purchases directly
- Conformance verified — passes all 57 UCP conformance tests across 13 test suites
Requirements
- WordPress 6.0+
- WooCommerce 7.0+
- PHP 8.0+
- Pretty Permalinks enabled
External Services
This plugin connects to the following external services:
UCP schema and specification URLs
The plugin includes https://ucp.dev/ URLs in UCP discovery and schema response payloads as passive identifiers for the Universal Commerce Protocol specification. These values are not service endpoints used by the plugin. The plugin never connects to ucp.dev and never sends store, customer, order, or analytics data to ucp.dev.
The plugin also includes passive schema identifiers from https://schema.org/ in front-end JSON-LD markup and https://json-schema.org/ inside the bundled local WebMCP library. The plugin does not connect to either domain or send data to either domain.
AI agent webhook URLs
When an AI agent initiates a checkout, it may supply an agent profile URL in the UCP-Agent request header. When Agent Webhooks are enabled, the plugin fetches that profile URL to read the agent’s configured webhook URL. The plugin then sends order event notifications (e.g. order placed, order shipped) to that webhook URL. This feature is disabled by default and must be enabled by the store owner under Uncap AI Settings Agent Webhooks.
- Data sent to the agent profile URL: the HTTP request needed to retrieve the public agent profile
- Data sent to the webhook URL: order status, checkout ID, fulfillment events
- When: only during an active agent-initiated checkout session, and only when the store owner has enabled webhooks
- Who receives it: the AI agent service that initiated the checkout (e.g. Claude, a custom agent)
- Opt-in: store owner controls this in plugin settings
- Terms and privacy policy: the destination is supplied by the external AI agent service, so there is no single terms or privacy URL controlled by this plugin. Store owners should review that agent service’s terms and privacy policy before enabling Agent Webhooks.
Bundled JavaScript library
The WebMCP feature uses the @mcp-b/global library (MIT licence), bundled locally in assets/js/mcp-global.iife.js. No requests are made to unpkg.com or any CDN at runtime. Source code: https://github.com/WebMCP-org/npm-packages/tree/main/packages/global
Installation
- Upload the plugin folder to
/wp-content/plugins/ - Activate the plugin through the Plugins menu in WordPress
- Ensure WooCommerce is installed and active
- Go to Uncap Settings to see your live endpoint URLs
FAQ
-
What is UCP?
-
Universal Commerce Protocol (UCP) is an open standard that enables AI agents to interact with online stores. It defines how agents discover stores, browse product catalogs, create checkouts, and handle fulfillment. See ucp.dev for the full specification.
-
What is MCP?
-
Model Context Protocol (MCP) is a JSON-RPC 2.0 protocol that lets AI models call tools on external servers. This plugin exposes your WooCommerce store as a set of MCP tools, making it usable by agents like Claude Desktop without any custom code.
-
Do I need to change anything about my store?
-
No. The plugin works with your existing WooCommerce setup — products, payment gateways, shipping methods, and order flows stay exactly as they are. The plugin adds a protocol layer on top.
-
Which AI agents does this work with?
-
Any agent that implements UCP or MCP. That includes Claude (via MCP), and any custom agent built on top of the UCP open standard. The protocol is designed to be agent-agnostic.
-
Does this replace my normal WooCommerce checkout?
-
No. Human customers continue to use your regular WooCommerce checkout. The UCP/MCP endpoints are an additional interface used only by AI agents.
-
Why are some REST endpoints public?
-
UCP and MCP discovery/search endpoints are public so agents can inspect the public product catalog before checkout. OAuth authorize/token endpoints are public protocol entry points: authorization requires a logged-in WordPress user and nonce-protected consent, while token exchange requires a one-time authorization code or refresh token stored server-side. Checkout/order follow-up routes use generated checkout UUIDs rather than sequential WooCommerce order IDs, so possession of the active checkout UUID is the protocol credential for that session.
-
What data is sent externally?
-
By default, nothing. If the store owner enables Agent Webhooks under Uncap AI Settings, the plugin may fetch the agent profile URL supplied in the
UCP-Agentrequest header to discover a webhook URL, then POST order status events to that webhook URL at checkout time. URLs underhttps://ucp.dev/appear only as passive protocol/schema identifiers in UCP response payloads; the plugin never fetches them and never sends data to ucp.dev. See the External Services section below for full details.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Uncap AI Shopping Connector for WooCommerce” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Uncap AI Shopping Connector for WooCommerce” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial release
- UCP REST API: discovery, search, checkout, fulfillment, webhooks
- MCP JSON-RPC 2.0 server endpoint
- WebMCP browser agent integration
