Description
StudioMeyer Agent Discovery for WooCommerce publishes the discovery endpoints that AI shopping agents (like Google AI Mode, ChatGPT, Gemini, Claude, and Perplexity) look for when they want to search, browse, or display products from your store.
The Problem
AI shopping agents can only interact with stores that expose a machine-readable catalog and a way to describe their capabilities. Without these endpoints, your products are invisible to agentic commerce.
What This Plugin Does
The plugin adds three discovery documents and a small REST API on top of WooCommerce:
- UCP Manifest at
/.well-known/ucp— Universal Commerce Protocol (Google and Shopify) manifest describing your shop capabilities. - agents.json at
/.well-known/agents.json— Tool catalog so AI agents know which endpoints they can call. - agent-card.json at
/.well-known/agent-card.json— A2A (Agent-to-Agent) discovery document describing your shop as a commerce agent. - UCP REST API at
/wp-json/ucp/v1/— Product search, product details, and category listing with pagination and price filters. - Agent Discovery Score — Admin dashboard widget with a 0 to 7 checklist that helps you verify the shop is ready.
- Rate limiting — 30 requests per minute per IP, with a filter hook for reverse proxy configurations.
- HPOS compatible — works with WooCommerce High-Performance Order Storage.
- No external services — the plugin does not call out to any third-party API.
Features
- UCP Manifest generator for WooCommerce
- agents.json tool catalog with commerce endpoints pre-wired
- A2A agent-card for agent-to-agent discovery
- Product search REST API with text, category, and price filters
- Single product endpoint with variations, attributes, and gallery images
- Category listing endpoint
- IP-based rate limiting with trusted-proxy handling
- Admin score widget and status page
- Internationalization-ready (text domain
studiomeyer-agent-discovery-for-woocommerce)
Who Is This For?
WooCommerce store owners who want their shop to work with AI shopping agents as agentic commerce becomes mainstream. The plugin is free and self-contained: no accounts, no API keys, no external calls.
More free plugins by StudioMeyer
- AI-Ready WP — make your whole WordPress site discoverable by AI agents (agents.json, llms.txt, JSON-LD, SEO).
- SmartBot — add an AI chatbot that answers visitor questions 24/7.
Screenshots
Installation
Quick start (about 1 minute)
- Make sure WooCommerce is installed and active.
- In WordPress, go to Plugins Add New, search for “StudioMeyer Agent Discovery”, then click Install Now and Activate.
- That is it — the discovery endpoints go live immediately. Open WooCommerce Agent Discovery to see your Agent Discovery Score and confirm every endpoint is active.
To verify manually, open https://yourshop.example/.well-known/ucp in a browser — you should see the UCP manifest as JSON.
Manual installation
- Download the plugin ZIP.
- Go to Plugins Add New Upload Plugin, upload the ZIP, then click Install Now and Activate.
Minimum Requirements
- WordPress 6.4+
- WooCommerce 8.0+
- PHP 8.0+
FAQ
-
Which AI agents work with these endpoints?
-
Any agent that implements UCP, A2A, or agents.json. This includes Google AI Mode, Gemini, ChatGPT, Claude, Perplexity, and custom shopping assistants built on top of these specifications.
-
Is this compatible with WooCommerce HPOS?
-
Yes. The plugin declares full HPOS (High-Performance Order Storage) compatibility on load.
-
Does this affect my store’s performance?
-
The plugin only responds when an AI agent or browser explicitly requests one of the discovery URLs or REST endpoints. Regular page loads are not affected. Rate limiting protects the endpoints against abuse.
-
What is the UCP (Universal Commerce Protocol)?
-
UCP is an open specification published in January 2026 by Google and Shopify that describes how AI agents discover, search, and purchase products. The plugin implements the shopping discovery portion of the specification;
/.well-known/ucpreturns the manifest. -
Does this plugin connect to external services?
-
No. All endpoints are served from your own WordPress installation. The plugin does not call any third-party API.
-
Where does rate limiting data live?
-
Per-IP request counts are stored as WordPress transients and expire after 60 seconds. No IP addresses are logged or persisted beyond that window.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“StudioMeyer Agent Discovery for WooCommerce” is open source software. The following people have contributed to this plugin.
Contributors
Translate “StudioMeyer Agent Discovery 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.2.1
- Compatibility: Tested up to WordPress 7.0 and WooCommerce 10.7.
- Fix: /.well-known/ucp is now served directly with 200 instead of a canonical 301 redirect to the trailing-slash URL — minimal agent clients that don’t follow redirects get the manifest on the spec path.
1.2.0
- Renamed plugin to StudioMeyer Agent Discovery for WooCommerce (slug:
studiomeyer-agent-discovery-for-woocommerce) - Updated class prefix and text domain to match the new slug
- Added
Requires Plugins: woocommerceheader for WordPress 6.5 plugin dependencies - Removed external upgrade link from the settings page
- Agent-card
provideris now the shop owner (correct A2A semantics) - Removed self-promotional
powered_byfield from agents.json - Rewrote description to remove unsupported comparative claims
- Regenerated translation template
1.1.0
- Removed Pro/License code for clean WordPress.org compliance
- Simplified to discovery-only plugin (UCP, A2A, agents.json)
- Improved rate limiter with trusted-proxy support
- Added phpcs annotations for Plugin Check compliance
1.0.1
- Security: Fixed rate limiter IP spoofing via X-Forwarded-For header
- Security: Added trusted-proxy filter for X-Forwarded-For
1.0.0
- Initial release
- UCP Manifest at /.well-known/ucp
- UCP Product Search and Categories API
- agents.json at /.well-known/agents.json
- agent-card.json at /.well-known/agent-card.json
- Agent Discovery Score dashboard widget
- Rate limiting (30 requests/minute)
- HPOS compatibility
- Full i18n support