Dhiraj Patra

UCP Adapter For WooCommerce is a powerful WordPress plugin that provides REST API endpoints for Universal Commerce Platform (UCP) integration. It enables seamless communication between your WordPress site and external commerce platforms through secure, standardized API endpoints.
Thank you for using our plugin! This add-on connects your WordPress site to the powerful world of WordPress’s Agentic Commerce, allowing you to create automated shopping assistants for your users.
<h3>🚀 Core Features</h3>
Our plugin leverages WordPress’s MCP (Model Context Protocol) servers plugin and the open Universal Commerce Protocol (UCP) standard to enable secure, intelligent commerce actions. Here’s what you can build:
<ul>
<li>Smart Product Discovery: Enable agents to search products across WordPress merchants, apply filters, and display interactive product cards directly within a chat interface on your site.</li>
<li>Seamless Checkout: Allow agents to create checkout sessions, collect buyer information, attach payment details, and complete purchases on behalf of users.</li>
<li>Order Tracking: After a purchase, agents can track order status, fulfillment updates, and post-purchase events like refunds or returns.</li>
</ul>
<h3>🔗 How It Works</h3>
The plugin acts as a Platform within the UCP framework, facilitating secure communication between your users (buyers), WordPress Merchants, and payment or credential providers. It implements these key UCP capabilities:
<ol>
<li>Discovery → Checkout: An agent can help a user find a product and instantly retrieve the necessary details to start a checkout session.</li>
<li>Checkout Completion: The agent can securely submit the checkout. If further user action is needed, it can gracefully open a web checkout page.</li>
<li>Post-Purchase: The agent provides ongoing value by fetching real-time updates on order delivery and status changes.</li>
</ol>
<h3>💡 Use Case Example</h3>
Imagine a user in your site’s chat asking, “Find me a red coffee mug under $20.” The plugin-powered agent can: 
* Query the WordPress Catalog across multiple stores. 
* Return filtered, interactive results. 
* Guide the user through selecting a variant, adding it to cart, and checking out—all without leaving your WordPress environment. 
* Get this client https://github.com/dhirajpatra/adk-agent-gcp/tree/main/ai-agents-adk/ucp_recommendation_system to connect your site with AI agent.
<h4>Key Features</h4>
<ul>
<li>Session Management: Create and manage user sessions with automatic expiration</li>
<li>REST API Endpoints: Three core endpoints (Session, Update, Complete) for UCP communication</li>
<li>Security First: API key authentication, rate limiting, and IP whitelisting</li>
<li>Developer Friendly: Clean, extensible code following WordPress coding standards</li>
<li>Extensible: Hooks and filters throughout for custom implementations</li>
<li>Admin Interface: Easy-to-use settings and session monitoring dashboard</li>
<li>Database Storage: Efficient session storage with automatic cleanup</li>
</ul>
<h4>REST API Endpoints</h4>
<ol>
<li>POST /wp-json/ucp/v1/session – Create a new session</li>
<li>PUT /wp-json/ucp/v1/update/{session_id} – Update session data</li>
<li>POST /wp-json/ucp/v1/complete/{session_id} – Complete a session</li>
<li>GET /wp-json/ucp/v1/status/{session_id} – Check session status</li>
<li>GET /wp-json/ucp/v1/sessions – List all sessions</li>
<li>GET /wp-json/ucp/v1/product/search – Search for products</li>
</ol>
<h4>Use Cases</h4>
<ul>
<li>E-commerce platform integration</li>
<li>Third-party checkout systems</li>
<li>Payment gateway connections</li>
<li>Order management systems</li>
<li>Multi-platform commerce solutions</li>
</ul>
<h4>Developer Resources</h4>
Build custom UCP adapters for platforms like: 
* Custom e-commerce solutions 
* Membership plugins 
* Digital product handlers 
* MemberPress
<h3>API Documentation</h3>
<h4>Create Session</h4>
Endpoint: <code>POST /wp-json/ucp/v1/session</code>
Headers: 
 <code>Content-Type: application/json 
X-UCP-API-Key: your-api-key</code>
Body: 
 <code>json 
{ 
 "platform": "woocommerce", 
 "user_data": { 
 "user_id": 123, 
 "email": "user@gmail.com" 
 } 
}</code>
Response: 
 <code>json 
{ 
 "success": true, 
 "session_id": "ucp_abc123...", 
 "expires_at": 1234567890, 
 "message": "Session created successfully." 
}</code>
<h4>Update Session</h4>
Endpoint: <code>PUT /wp-json/ucp/v1/update/{session_id}</code>
Body: 
 <code>json 
{ 
 "action": "add_item", 
 "data": { 
 "product_id": 456, 
 "quantity": 2 
 } 
}</code>
<h4>Complete Session</h4>
Endpoint: <code>POST /wp-json/ucp/v1/complete/{session_id}</code>
Body: 
 <code>json 
{ 
 "status": "completed", 
 "metadata": { 
 "order_id": 789 
 } 
}</code>
<h4>List Sessions</h4>
Endpoint: <code>GET /wp-json/ucp/v1/sessions</code>
Parameters: 
* <code>page</code>: Page number (optional, default 1) 
* <code>limit</code>: Results per page (optional, default 10)
Response: 
 <code>json 
{ 
 "success": true, 
 "data": [ 
 { 
 "session_id": "ucp_abc123...", 
 "status": "active", 
 "created_at": "2024-01-01 12:00:00", 
 "expires": 1234567890 
 } 
 ], 
 "meta": { 
 "page": 1, 
 "limit": 10, 
 "total": 5 
 } 
}</code>
<h4>Product Search</h4>
Endpoint: <code>GET /wp-json/ucp/v1/product/search</code>
Parameters: 
* <code>search</code>: Search query (required) 
* <code>page</code>: Page number (optional, default 1) 
* <code>limit</code>: Results per page (optional, default 10)
Response: 
 <code>json 
{ 
 "success": true, 
 "data": [ 
 { 
 "id": 123, 
 "name": "T-Shirt", 
 "price": "20.00", 
 "image": "https://example.com/image.jpg", 
 "permalink": "https://example.com/product/t-shirt" 
 } 
 ], 
 "meta": { 
 "page": 1, 
 "limit": 10, 
 "search": "shirt", 
 "count": 1 
 } 
}</code>
<h4>Actions Available</h4>
<ul>
<li><code>add_item</code> – Add an item to the session</li>
<li><code>update_item</code> – Update an existing item</li>
<li><code>remove_item</code> – Remove an item from the session</li>
<li><code>set_data</code> – Set custom session data</li>
<li>Custom actions via filters</li>
</ul>
<h3>Privacy Policy</h3>
UCP Adapter For WooCommerce stores session data temporarily in your WordPress database. This data is automatically cleaned up based on your configured retention settings. The plugin does not send any data to external services.
Session data may include: 
* User identifiers 
* Platform information 
* Custom data provided via API calls
It is your responsibility to ensure compliance with privacy regulations (GDPR, CCPA, etc.) when using this plugin.
<h3>Credits</h3>
Developed with WordPress coding standards and best practices in mind.
<h3>Support</h3>
Support Forum: https://wordpress.org/support/plugin/ucp-adapter-for-woocommerce

UCP Adapter For WooCommerce

Universal Commerce Platform REST API adapter providing Session, Update, and Complete endpoints for seamless e-commerce integration.

shan

SDX AI Readiness Toolkit makes any WooCommerce store auto-discoverable, readable, and purchasable by AI shopping agents — ChatGPT plugins, Perplexity Shopping, Google’s commerce AI, custom Claude tools, and any agent that speaks the open protocols of the agentic commerce ecosystem.
<h4>Why this matters</h4>
In 2026 Google launched the Universal Commerce Protocol (UCP) with Shopify, Walmart, Target, Wayfair, and Etsy. WooCommerce was absent. This plugin closes that gap.
<h4>What this plugin does</h4>
<ul>
<li>UCP discovery at <code>/.well-known/ucp</code> — agents auto-find your store</li>
<li>MCP server at <code>/wp-json/agtc/v1/mcp</code> — JWT-authenticated tools for product listing, search, and order lookup</li>
<li>ACP checkout at <code>/wp-json/agtc/v1/acp/checkouts</code> — agentic checkout sessions with Stripe <code>payment_intent</code> support</li>
<li>OAuth 2.0 server — dynamic client registration + <code>client_credentials</code> grant</li>
<li>WC native ACP coexistence — auto-detects WooCommerce 10.7+ native ACP and defers when active</li>
<li>Web discovery — HTML <code><link></code> tags, HTTP Link headers, <code>robots.txt</code> advisory, <code>/llms.txt</code></li>
<li>Google Merchant Center feed at <code>/merchant-feed/google.xml</code> — a self-hosted, Google-spec product feed you register as a scheduled fetch</li>
<li>AI readiness dashboard — scores your store, shows what’s missing, offers one-click fixes</li>
<li>Production-grade engineering — 260+ unit tests, integration-tested on live WordPress 7.0 + WooCommerce, WordPress Coding Standards compliant, PHP 7.4+ compatible</li>
</ul>
<h4>How agents use your store</h4>
<ol>
<li>Agent fetches <code>/.well-known/ucp</code></li>
<li>Agent registers via <code>/oauth/register</code> → receives client ID + secret</li>
<li>Agent exchanges credentials for JWT at <code>/oauth/token</code></li>
<li>Agent calls MCP tools under <code>/mcp</code> (search, list)</li>
<li>Agent creates an ACP checkout session at <code>/acp/checkouts</code></li>
<li>Agent completes the session → real WooCommerce order in your admin</li>
</ol>
All standard payment gateways work. UCP creates standard WC orders.
<h4>How this actually helps your store</h4>
AI shopping assistants — ChatGPT, Perplexity, Gemini, Claude — now help millions of people find products every day. When a shopper asks “find me a waterproof backpack under $80”, the assistant doesn’t open Google and click around. It queries machine-readable storefronts directly. The way it finds those storefronts is by fetching <code>/.well-known/ucp</code> on each domain it knows about. If that file doesn’t exist, your store is invisible to the agent — not low-ranked, invisible.
This plugin publishes that file automatically, along with the MCP tools the agent uses to actually browse your catalog. You don’t have to write a single line of integration code; activating the plugin is enough to put your store on the map for every agent that speaks UCP, MCP, or ACP.
A few complementary moves we recommend alongside this plugin: register your products in Google Merchant Center so the Google Shopping feed picks them up, keep product titles and descriptions clear and well-structured (the same SEO discipline that helps humans also helps AI parsing), and make sure your site runs on HTTPS end-to-end so agents trust the responses.
Once your store is published, agents can do three things that previously required a human: discover that you exist, browse your catalog in real time, and — with ACP enabled — create a real WooCommerce order on behalf of their user, with the same checkout, tax, shipping, and fulfillment plumbing your human customers go through today.
<h4>Google Merchant Center</h4>
The plugin publishes a Google-spec product feed at <code>https://yourstore.com/merchant-feed/google.xml</code>. It is fully self-hosted — the plugin contacts no external service. Instead, you register that URL in Google Merchant Center → Products → Feeds as a scheduled fetch, and Google pulls the feed on its own schedule. Once Google has the feed, your products become eligible for Google Shopping and Google’s shopping AI.
The feed is built from your published, catalog-visible WooCommerce products and includes each product’s title, description, price, availability, image, and — when set — brand and GTIN. Filling in brand and GTIN (Products → product → Inventory → Global Unique ID, on WooCommerce 9.2+) materially improves listing quality and how often Google can match your products. Variable products are expanded to their purchasable variations. The generated XML is cached for one hour to keep the endpoint fast.
<h4>Privacy & Data Handling</h4>
This plugin is built to be conservative about data:
<ul>
<li>The plugin only exposes publicly available product data — name, price, image, description — through its UCP and MCP discovery endpoints. Anything you already display on a public product page is fair game; nothing else is.</li>
<li>Order data is gated behind a valid OAuth 2.0 access token AND is scoped to the agent’s own orders. An agent (OAuth client) can only read orders it created itself through the ACP checkout flow; it can never read other agents’ orders or orders placed by human customers through normal checkout. An agent without the <code>read:orders</code> scope cannot read any orders at all, and <code>read:orders</code> is never granted by open client registration unless it is explicitly requested.</li>
<li>No customer personally identifiable information (PII) is collected, transmitted to third parties, or stored beyond standard WooCommerce order records that WooCommerce itself already manages.</li>
<li>All admin actions — including the audit dashboard and one-click auto-fix buttons — require the <code>manage_woocommerce</code> capability and a verified WordPress CSRF nonce.</li>
<li>No outbound telemetry. No analytics calls. No external “phone home” requests. The plugin does not contact the author, an analytics vendor, or any third party at install time, on activation, or during normal operation.</li>
</ul>
<h4>External Services</h4>
WordPress.org guideline #6 requires that we disclose any external services this plugin contacts. The list is short:
<ul>
<li>Stripe (optional, opt-in): Stripe is only contacted when the ACP module’s <code>payment_intent</code> flow is explicitly enabled by defining the <code>AGTC_STRIPE_SECRET_KEY</code> constant in <code>wp-config.php</code>. When an agent completes a checkout session under that flow, the plugin makes a server-to-server POST to <code>https://api.stripe.com/v1/payment_intents</code> to authorize the payment. No data is sent to Stripe unless this flow is activated. Stripe service terms: https://stripe.com/legal — Stripe privacy policy: https://stripe.com/privacy.</li>
<li>No other external services are contacted by default. UCP, MCP, and ACP discovery endpoints are served from your own WordPress installation. The agent pulls data from you; you do not push data to the agent or to any intermediary.</li>
</ul>
<h4>Disclaimer</h4>
This plugin is an independent, community-driven implementation of open commerce protocols. It is not affiliated with, endorsed by, or sponsored by Stripe, Inc., OpenAI, Google, Anthropic, Automattic, or the WooCommerce trademark holders. “WooCommerce” is a trademark of Automattic Inc. and is referenced solely for descriptive interoperability purposes.

SDX AI Readiness Toolkit for WooCommerce

Make your WooCommerce store first-class compatible with AI shopping agents: UCP discovery, MCP tools, OAuth 2.0, ACP checkout, audit dashboard.

UCP Adapter For WooCommerce vs SDX AI Readiness Toolkit for WooCommerce