Agentic Shelf — Live Catalog Agent

Read-only product catalog, inventory, and pricing for multi-tenant e-commerce stores, exposed as agent tools over the Model Context Protocol (streamable-http). Each merchant connects their store; AI agents query the live catalog via a per-tenant MCP URL (/m/{slug}/mcp). This card describes the shared capability shape; see the per-tenant card at /m/{slug}/.well-known/agent.json for a specific store.

Skills

• List products
  Browse the catalog, paginated. Returns SKU, title, a short description, price, currency, availability, and storefront URL for each product. Use this to DISCOVER products when no SKU is known yet; follow up with get-product-details or check-stock.
  catalogdiscoverybrowseread-only
• Search products
  Keyword search over product titles and tags (storefront-native search semantics — keywords, not full natural-language sentences). Returns the same shape as list-products.
  catalogsearchread-only
• Get product details
  Full catalog record for one SKU: title, description, product type, tags, price, inventory quantity, availability, image. Use when the shopper wants depth on a specific product.
  catalogproductread-only
• Check stock
  Real-time inventory for a SKU: current stock count, price in USD, and a can_ship_today flag. The tool to answer 'is it in stock' / 'how many left'.
  inventoryavailabilityread-only
• Get price
  Current price in USD for a SKU (price and currency only — not shipping or promotional math).
  pricingread-only

How to call

https://api.agenticshelf.ai/mcp