MCP Server

Tolstoy Shopper

io.github.GoTolstoy/shopper
Commerce & Retail Public & reachable MCP 2026-07-28

What this MCP does

Searches products, retrieves product and variant details, and opens virtual try-on experiences for supported items.

get_product
Get product details
Load full details for one product by its `productRef` (from search_products or browse_products): description, price, media, the brand's real product videos, size guide, per-variant stock, and buy links. Returns each variant's id and options (size/color). Use it to resolve the exact `variantId` the shopper wants before calling build_cart, and to answer fit/sizing questions from the size guide. The response includes the product image so it can be seen directly.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['productRef'], 'properties': {'productRef': {'type': 'string', 'minLength': 1, 'description': 'Product reference token from search_products.'}}, 'additionalProperties': False}
search_products
Search products across stores
Search the catalog by a specific free-text query (e.g. a product name, material, or occasion the shopper named). In marketplace mode, searches across every brand store on Tolstoy — one catalog, no store selection needed. Use this only when the shopper names something specific to look for. For open-ended browsing, featured, best sellers, or a collection, use browse_products instead. When shopping a single brand, the optional `filters` (category/productType/tag) narrow the results. Each result carries a `productRef`; pass it to get_product for full details.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'default': 12, 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of products to return.'}, 'query': {'type': 'string', 'minLength': 1, 'description': 'What the shopper is looking for.'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor from a previous search result.'}, 'filters': {'type': 'object', 'properties': {'tag': {'type': 'string', 'description': 'Restrict to products carrying this tag.'}, 'category': {'type': 'string', 'description': 'Restrict to a product category.'}, 'productType': {'type': 'string', 'description': 'Restrict to a product type.'}}, 'additionalProperties': False}}, 'additionalProperties': False}
try_on
Virtual try-on
Opens an interactive virtual try-on for a product (by `productRef` from `search_products`): the shopper uploads their photo and gets a photorealistic image of themselves wearing the actual product — true to the real garment. Only available for brands that enabled marketplace try-on; when unavailable, the response says so and the product can still be viewed via its store link.
Input schema
{'type': 'object', 'required': ['productRef'], 'properties': {'productRef': {'type': 'string', 'minLength': 1, 'description': 'Product reference token from search_products.'}}, 'additionalProperties': False}
Added
try_on
Sept. 17, 2026, 12:42 p.m.
Added
get_product
Sept. 17, 2026, 12:42 p.m.
Added
search_products
Sept. 17, 2026, 12:42 p.m.