WebMCP Commerce Tools
Before writing code
Fetch live docs:
- Fetch
https://developer.chrome.com/docs/ai/webmcp for commerce-related examples and guidance
- Web-search
webmcp agentic commerce e-commerce tools examples for community implementations
- Web-search
webmcp shopping agent checkout cart tools for commerce workflow patterns
- Web-search
site:github.com webmcp commerce for open-source commerce tool implementations
Conceptual Architecture
Agentic Shopping Flow
A typical agent-driven shopping session using WebMCP:
User: "Find me wireless headphones under $100"
→ Agent navigates to retailer site
→ Site registers tools: [searchProducts, viewDetails, addToCart, checkout]
→ Agent calls searchProducts(query="wireless headphones", maxPrice=100)
→ Site returns structured product list
→ Agent presents results to user
→ User: "Add the Sony ones to my cart"
→ Agent calls addToCart(productId="sony-wh-1000", quantity=1)
→ Agent: "Added! Proceed to checkout?"
→ User: "Yes, use my saved card"
→ Agent calls checkout(useSavedPayment=true)
→ Site: requestUserInteraction → User confirms → Order placed
→ Agent: "Order #1234 confirmed!"
Core Commerce Tool Set
Every e-commerce site should consider these tool categories:
1. Product Discovery
searchProducts(query, filters) — Catalog search with optional filters
getCategories() — List product categories
viewProductDetails(productId) — Full product info, images, reviews
compareProducts(productIds) — Side-by-side comparison
2. Cart Management
addToCart(productId, quantity, variant) — Add item to cart
removeFromCart(itemId) — Remove item from cart
updateCartQuantity(itemId, quantity) — Change quantity
getCartContents() — View current cart
applyCoupon(code) — Apply a discount code
3. Checkout
getShippingOptions(address) — Available shipping methods and costs
checkout(paymentMethod, shippingOption) — Complete purchase
getOrderSummary() — Pre-checkout order review
4. Order Management
getOrderHistory(filters) — Past orders with optional date/status filters
getOrderStatus(orderId) — Track a specific order
initiateReturn(orderId, items, reason) — Start a return
cancelOrder(orderId) — Cancel a pending order
5. Account & Subscriptions
manageSubscription(action, planId) — Upgrade, downgrade, cancel subscriptions
getSubscriptionDetails() — Current subscription info
updateShippingAddress(address) — Update default address
6. Support
createSupportTicket(type, description) — Open a support case
checkTicketStatus(ticketId) — Check on existing ticket
Tool Design Principles for Commerce
- Mirror existing APIs — Tool execute callbacks should call your existing REST/GraphQL APIs
- Reuse session — Tools run in the user's authenticated browser session; no extra auth needed
- Structured returns — Return JSON with consistent structure (items array, totals, status)
- Progressive disclosure — Start with search and browse tools; add checkout only for authenticated users
- Confirmation gates — Require user interaction for anything involving money
Multi-Site Agent Workflows
Agents can navigate across multiple retailer sites:
- Search on Site A using WebMCP → get results
- Search on Site B using WebMCP → get results
- Compare across sites at the agent level
- Purchase from the best option using that site's checkout tool
Each site maintains its own tools; the agent coordinates across them.
Integration with Backend Protocols
WebMCP tools can delegate to backend protocols:
- UCP endpoint —
searchProducts tool calls a UCP product discovery API
- Stripe Checkout —
checkout tool creates a Stripe session server-side
- Inventory service — Tools check real-time stock via internal APIs
Best Practices
- Expose tools progressively: read-only tools for all visitors, transactional tools for logged-in users
- Return pagination info for list results (total, page, hasMore)
- Include product images/thumbnails in results as URLs (agents can display them)
- Handle out-of-stock gracefully — return clear status, not errors
- Test the full purchase flow with an AI agent end-to-end
- Consider mobile/responsive — tools should work regardless of viewport
Fetch the latest WebMCP examples and commerce community patterns before building your tool set.
1---2name: webmcp-commerce-tools3description: Implement commerce-specific WebMCP tools — product search, cart management, checkout, returns, subscriptions, and support. Use when building agentic shopping experiences on e-commerce websites.4allowed-tools: Read, Write, Edit, Bash, Grep, Glob, WebSearch, WebFetch5metadata:6 source: https://skillmd.com/skills/orcaqubits/webmcp-commerce-tools7---89# WebMCP Commerce Tools1011## Before writing code1213**Fetch live docs**:141. Fetch `https://developer.chrome.com/docs/ai/webmcp` for commerce-related examples and guidance152. Web-search `webmcp agentic commerce e-commerce tools examples` for community implementations163. Web-search `webmcp shopping agent checkout cart tools` for commerce workflow patterns174. Web-search `site:github.com webmcp commerce` for open-source commerce tool implementations1819## Conceptual Architecture2021### Agentic Shopping Flow2223A typical agent-driven shopping session using WebMCP:2425```26User: "Find me wireless headphones under $100"27 → Agent navigates to retailer site28 → Site registers tools: [searchProducts, viewDetails, addToCart, checkout]29 → Agent calls searchProducts(query="wireless headphones", maxPrice=100)30 → Site returns structured product list31 → Agent presents results to user32 → User: "Add the Sony ones to my cart"33 → Agent calls addToCart(productId="sony-wh-1000", quantity=1)34 → Agent: "Added! Proceed to checkout?"35 → User: "Yes, use my saved card"36 → Agent calls checkout(useSavedPayment=true)37 → Site: requestUserInteraction → User confirms → Order placed38 → Agent: "Order #1234 confirmed!"39```4041### Core Commerce Tool Set4243Every e-commerce site should consider these tool categories:4445#### 1. Product Discovery46- `searchProducts(query, filters)` — Catalog search with optional filters47- `getCategories()` — List product categories48- `viewProductDetails(productId)` — Full product info, images, reviews49- `compareProducts(productIds)` — Side-by-side comparison5051#### 2. Cart Management52- `addToCart(productId, quantity, variant)` — Add item to cart53- `removeFromCart(itemId)` — Remove item from cart54- `updateCartQuantity(itemId, quantity)` — Change quantity55- `getCartContents()` — View current cart56- `applyCoupon(code)` — Apply a discount code5758#### 3. Checkout59- `getShippingOptions(address)` — Available shipping methods and costs60- `checkout(paymentMethod, shippingOption)` — Complete purchase61- `getOrderSummary()` — Pre-checkout order review6263#### 4. Order Management64- `getOrderHistory(filters)` — Past orders with optional date/status filters65- `getOrderStatus(orderId)` — Track a specific order66- `initiateReturn(orderId, items, reason)` — Start a return67- `cancelOrder(orderId)` — Cancel a pending order6869#### 5. Account & Subscriptions70- `manageSubscription(action, planId)` — Upgrade, downgrade, cancel subscriptions71- `getSubscriptionDetails()` — Current subscription info72- `updateShippingAddress(address)` — Update default address7374#### 6. Support75- `createSupportTicket(type, description)` — Open a support case76- `checkTicketStatus(ticketId)` — Check on existing ticket7778### Tool Design Principles for Commerce79801. **Mirror existing APIs** — Tool execute callbacks should call your existing REST/GraphQL APIs812. **Reuse session** — Tools run in the user's authenticated browser session; no extra auth needed823. **Structured returns** — Return JSON with consistent structure (items array, totals, status)834. **Progressive disclosure** — Start with search and browse tools; add checkout only for authenticated users845. **Confirmation gates** — Require user interaction for anything involving money8586### Multi-Site Agent Workflows8788Agents can navigate across multiple retailer sites:891. Search on Site A using WebMCP → get results902. Search on Site B using WebMCP → get results913. Compare across sites at the agent level924. Purchase from the best option using that site's checkout tool9394Each site maintains its own tools; the agent coordinates across them.9596### Integration with Backend Protocols9798WebMCP tools can delegate to backend protocols:99- **UCP endpoint** — `searchProducts` tool calls a UCP product discovery API100- **Stripe Checkout** — `checkout` tool creates a Stripe session server-side101- **Inventory service** — Tools check real-time stock via internal APIs102103### Best Practices104105- Expose tools progressively: read-only tools for all visitors, transactional tools for logged-in users106- Return pagination info for list results (total, page, hasMore)107- Include product images/thumbnails in results as URLs (agents can display them)108- Handle out-of-stock gracefully — return clear status, not errors109- Test the full purchase flow with an AI agent end-to-end110- Consider mobile/responsive — tools should work regardless of viewport111112Fetch the latest WebMCP examples and commerce community patterns before building your tool set.