Service pillar
Universal Commerce Protocol: getting WooCommerce ready for AI agents
What I ship
- Audit of the existing WooCommerce or WordPress catalogue for agent-readability, including the current state of REST endpoints at
/wp-json/wc/v3/and any structured data already present. - Schema.org enrichment per product, covering Product, Offer and AggregateOffer with hasMerchantReturnPolicy, ItemAvailability and PriceSpecification. The output is JSON-LD on the page and validated against schema.org.
- Optional Model Context Protocol server exposing catalogue and order intent endpoints to authenticated agent clients, sitting alongside the WordPress REST API rather than replacing it.
- Test harness wired to the Anthropic Claude API that exercises the agent flow end to end, from product lookup through order intent, with recorded transcripts as the regression baseline.
- Observability that separates agent traffic from human traffic at the analytics layer, so attribution, conversion and cost can be reported per audience type.
Why this is not just another schema.org tweak
AI agents are starting to behave like buyers. Browser-resident assistants and agent surfaces inside Claude and ChatGPT increasingly act on behalf of users: filtering, comparing, eventually committing to a transaction. The interface they need is not the visual page; it is a machine-readable surface for the catalogue and the transactional flow on top of it.
Schema.org Product, Offer and AggregateOffer cover the description side. They tell an agent what a product is, what it costs, whether it is in stock and what return policy applies. They do not describe how an agent should authenticate, how it should signal intent to buy, or how the store should respond when many agents query inventory simultaneously. That is the gap converging standards are addressing.
Anthropic's Model Context Protocol, first published in November 2024 as an open specification, is one of the moves toward agent-readable interfaces. Automattic's position post on 2026-04-21, framing WordPress as a candidate operating system for agent-readable websites, points in the same direction from the CMS side. The practical conclusion: a catalogue legible only to humans is being repriced by the market.
Who this is for
- WooCommerce stores where agent-driven traffic is already showing up in logs and the catalogue is not built to answer it.
- B2B catalogues with quote workflows, regional pricing and subscription products, where a typed agent surface beats fragile screen-scraping.
- Content sites with affiliate commerce, where the page is the catalogue and agent-readable Offers determine whether the site is cited or skipped.
- Multi-region brands with one CMS feeding many storefronts, who need a single source of truth that agents can resolve consistently across locales.
Engagement model
Senior B2B contracts on EU jurisdiction. Discovery, scoping, fixed-scope or time-and-materials engagements. Scope and pricing are individual per project; I do not publish standard rate cards because the audit step usually changes the cost of the build.
It can be given tasks that take hours, days, or weeks to complete, and then goes off and does those tasks autonomously.Frequently asked questions
How should WooCommerce expose products to AI shopping agents?
Treat the catalogue as a data layer, not HTML to scrape. On this engagement I ship Schema.org Product/Offer/AggregateOffer enrichment (hasMerchantReturnPolicy, ItemAvailability, PriceSpecification) as validated JSON-LD, an optional MCP server with catalogue and order-intent endpoints beside /wp-json/wc/v3/, Claude API regression tests, and agent-versus-human observability. Add a UCP capability feed at /.well-known/ucp.json. Agent checkout under UCP is native or embedded iframe; WPPoland's public feed currently declares inquiry and quote support, not supportsPayment.
What is the Universal Commerce Protocol?
Universal Commerce Protocol is shorthand for the cluster of work needed so that an AI agent acting on behalf of a buyer can read your catalogue, understand pricing and availability, and signal order intent in a structured way. It combines Schema.org Product, Offer and AggregateOffer markup with an optional Model Context Protocol (MCP) server that exposes a typed surface to authenticated agent clients.
How does this differ from Schema.org Product markup?
Schema.org Product, Offer and AggregateOffer describe the catalogue. They are necessary but not sufficient. They do not describe a transactional flow: how an agent should ask for stock at scale, how it should signal intent to buy, or how authentication and idempotency are handled. Anthropic's open Model Context Protocol, first published 2024-11, is one of the standards converging on that gap. I layer the two so structured data and a typed agent surface stay in sync.
Is MCP required?
No. Many catalogues benefit immediately from disciplined Schema.org enrichment alone, especially adding hasMerchantReturnPolicy, ItemAvailability and PriceSpecification. I add an MCP server when the client wants a typed, authenticated surface for agent clients beyond what crawlable JSON-LD can express, or when WooCommerce custom flows (subscriptions, B2B quotes, regional pricing) need a deterministic interface for agents.
Will this work on a non-WooCommerce WordPress site?
Yes. WordPress 6.7+ exposes content through the REST API at /wp-json/, and WooCommerce extends that at /wp-json/wc/v3/. For non-WooCommerce sites with affiliate commerce, custom post types or a headless setup, I map your existing catalogue model into Schema.org and, where useful, an MCP surface. The pattern is the same; the source of truth changes.
How do I measure ROI on agent-readability?
I split observability between agent traffic and human traffic on the analytics layer, so you can see which sessions originate from AI assistants and how their conversion behaviour compares. Pricing on the engagement is individual; what I track on outcome is agent-attributed revenue, cost-per-agent-session and the share of catalogue surface that is actually legible to agent clients.
Explore other WordPress services and knowledge base
Strengthen your business with professional technical support in key areas of the WordPress ecosystem.
Stores, checkout flow, and sales logic.
Store outage, slow checkout, post-update chaos.
Ongoing WooCommerce care, monitoring, and uptime.
EU store checklist: VAT, accessibility, evidence pack.
White-label WordPress development for agencies.
WooCommerce sync with ERP and wholesale systems.
Related categories
Supporting articles
Google shut off the Content API for Shopping on 18 August 2026, so v2.1 calls now return 410 Gone. If your WooCommerce store feeds Merchant Center through the official plugin you are fine, but custom integrations that never moved to Merchant API are already offline.
Architecture for a WooCommerce catalog on Astro 7. What stays in wp-admin, which plugins die with the theme, Store API versus GraphQL, and why checkout stays on WooCommerce.
The Shopify Plus vs WooCommerce headless decision in 2026 is no longer a binary "platform vs custom" trade-off. Both can run headless, both integrate AI, both ship at the edge. The real axes are control, total cost over five years, and exit strategy. This article walks the matrix with confirmed platform facts.
Internal AI governance before public agent surfaces
Agent-readable commerce needs governance before exposure. The same discipline used for internal AI content operations applies to catalogue tools, MCP surfaces, and agent observability.
Read the anonymised AI content-ops case studyCluster reading
The supporting articles in this cluster, by topic.
Agent-ready commerce and AI integrations
Architecture and edge
Reference
Recommendations and reviews of working with WPPoland
Selected recommendations from WordPress, WordCamp and e-commerce leaders - with a focus on delivery on time, technical depth, and a business-driven approach to WordPress development.
Karolina Czapla
Marketing Strategist, Performance & Digital Strategy
“Working with Mariusz on WordCamp has shown me how rare it is to combine deep technical skill with genuine leadership. He plans, coordinates and delivers with precision, while giving the team space to grow and contribute....”
Co‑organiser, WordCamp Gdynia 2024 & 2025
Anna Kamińska
Talent Acquisition Specialist / HR People Partner
“Mariusz's portfolio speaks for itself. It reflects his precision, versatility and sense of responsibility. You can trust him to guide a project from idea to delivery, keep stakeholders informed and make sure things are d...”
Worked on the same team
Sarah‑Luisa Kwolek
IT Project Management & Product Owner, Web/App
“For over two years I could always rely on Mariusz to handle WordPress tasks calmly and professionally, from styling and templating to third‑party integrations. He brings steadiness to the team and keeps the frontend side...”
Mariusz was her client for WordPress work
Argert Boja
Senior Full‑Stack Developer
“Mariusz is the teammate everyone hopes for: strong full‑stack WordPress skills, clear explanations and a positive attitude even under pressure. He moves easily between custom plugins, performance work and Gutenberg layou...”
Worked alongside Mariusz on WordPress projects
Varun Patil
Growth & CRM Lead
“Beyond development, Mariusz understands SEO, analytics and growth. He talks directly with stakeholders, asks the right questions and ships solutions that move business metrics, from AMP to tracking to performance.”
Managed Mariusz on growth initiatives
Rafał Osiński
Founder @ EasyTrips.pl, Senior WordPress Dev
“I've known Mariusz through the WordPress community for many years. He's reliable, deeply involved and consistently shows up, at meetups, WordCamps and in projects. If you care about long‑term collaboration and someone wh...”
WordPress community co‑organiser
Daniel Blossfeld
Process Optimization & Digitalization Consultant
“I had the pleasure of working with Mariusz for almost three years. During that time, his WordPress development skills proved invaluable across a range of projects, from website builds to online member areas and even Shop...”
Mariusz was his client for WordPress work
Natalie Wiszczor
CRM & E-Mail Marketing Manager
“I had the great pleasure of working with Mariusz for over 4 years in the technical field. During this time, he proved to be a competent and reliable colleague. What stood out in particular was his friendly nature and his...”
Worked with Mariusz on different teams
Mark Chalklen
Head of Design & Build at Itineris Limited
“Mariusz is a great member of the team, always happy to get stuck into any task and happy to learn new things. A great communicator and all round nice guy to work with. Hard to beat on our weekly Strava leader board thoug...”
Managed Mariusz directly
Jessica Di Pasquale
Leading SEO initiatives with data-driven growth strategies.
“Mariusz is a very skilled, patient and expert guy. Always ready to help and to fix errors, I really appreciated working with him. He is such a great colleague!”
Managed Mariusz directly
Biki John
Content Marketing Aficionado & SEO Enthusiast
“It was great to work with Mariusz. I really appreciated his extensive knowledge of WordPress and how that came in handy whenever I needed support navigating the CMS. I commend Mariusz totally for his patience, good natur...”
Worked with Mariusz on different teams
Rafal Borowiec
Software Developer, Consultant, Manager and Lecturer
“I had an opportunity to work with Mariusz for 7 months. He excels in technical optimization for search engines (SEO). Mariusz has also strong expertise in AMP development, GTM, and GA. Mariusz feels very comfortable with...”
Managed Mariusz directly
Belinda Koch
Web-Tracking Analyst at TUI
“Mariusz is a great person to work with. He is extremely motivated to learn new things and share his knowledge, and is very knowledgeable on a wide range of topics. We worked together on digital analytics and tracking top...”
Worked with Mariusz on digital analytics and tracking topics
Ali Nezamolmaleki
Growth, SEO, Analytical thinking, AMP
“Mariusz is an extremely talented person in his field of work. He is always capable of giving a new perspective to solve problems and to think out of the box in situations where everything seems to be locked. Working with...”
Worked with Mariusz on the same team
Karol Jakubcewicz
Front-end / JavaScript Developer
“Mariusz is an incredibly experienced WordPress developer and SEO/SEM specialist I've had the pleasure to work with for almost two years. As a pilot of the team responsible for AirHelp's website development, he's been one...”
Worked with Mariusz on the same team
Paweł Lewczuk
Front-end developer, WordPress developer
“I collaborated with Mariusz on several projects and our cooperation was always exemplary. I believe there are many more joint projects ahead of us. Highly recommended!”
Mariusz was Paweł's client
Przemek Wroblewski
Software Developer with 20+ years of experience
“I found Mariusz as someone with great expertise and profound knowledge of frontend solutions. Powerful, knowledgeable and accountable WordPress developer. Has an easiness to build interpersonal relations with others. He ...”
Worked with Mariusz on different teams
Start a B2B engagement
Tell me the scope and timeline, I reply within one working day.
Contact me