Every change Wellknown observed on this MCP server, newest first, with what it was before and what it became. Tool-surface changes carry the definition diff. Nothing here is edited after the fact.
Recently observed → Live
Live → Recently observed
Changed the definition of "products.items.get_by_handle", "products.search.image_upload" and "region.list_supported"
⟨150 unchanged words⟩ and idempotent with no persistent state modifications. -ReturnsAutomaticallyHTTPresolves404searcherrorqueries ifhandleadoesdescriptivenotnameexist.is passed instead of an exact handle. - Enriches returned document with verified purchase URLs. ⟨15 unchanged words⟩
⟨104 unchanged words⟩ "minLength":1,"type":"string"},"image_url":{"description":"Optional public HTTP(S) image URL if already hosted","format":"uri","type":"string"},"mode":{"description":"Catalog mode: 'global' ⟨147 unchanged words⟩
⟨40 unchanged words⟩ 'CAD', 'Europe')","type":"string"},"search":{"description":"Alias for query: search filter by country name, ISO code, or currency","type":"string"}},"type":"object"}
Certificate changed, valid to 2027-02-04
Recently observed → Live
Live → Recently observed
Added "address.delete", "address.get_current", "address.list_saved" and 6 more; changed the definition of "checkout.links.get_direct_url", "looks.curation.by_occasion", "looks.curation.recommend" and 7 more (10 tools before, 19 now)
Generate the direct 1-click checkout purchase URL for a specific product handle and size variant index (https://s.polopan.com/p/{handle}/{size_index}). PURPOSE & DISAMBIGUATION: - Produces the final, verified 1-click buy link configured withoptionaltheprefilleduser'sdeliveryselectedaddresssize index, unit quantity, anddiscountpre-applied
Changed the definition of "checkout.links.get_direct_url", "looks.curation.by_occasion", "looks.curation.recommend" and 7 more
⟨12 unchanged words⟩ size index (https://s.polopan.com/p/{handle}/{size_index}).with optional prefilled delivery address and discount coupon. MANDATORY AGENT INSTRUCTION: Only generate or provide ⟨46 unchanged words⟩
{"$schema":"http://json-schema.org/draft-07/schema#","properties":{"address":{"description":"Delivery address object to prefill directly into checkout link","properties":{"address1":{"minLength":1,"type":"string"},"address2":{"type":"string"},"city":{"minLength":1,"type":"string"},"country":{"type":"string"},"email":{"type":"string"},"firstName":{"minLength":1,"type":"string"},"lastName":{"type":"string"},"phone":{"type":"string"},"province":{"type":"string"},"zip":{"type":"string"}},"required":["firstName","address1","city"],"type":"object"},"coupon":{"description":"Optional discount coupon code ⟨63 unchanged words⟩
Verified owner set by github_owner proof on rofoso-com
Certificate recorded, valid to 2026-11-06
Authorization not required
Unknown → Live
First tool surface recorded: 10 tools (server version 1.2.3)
https://mcp-server.polopan.com/mcp (mcp_streamable_http) — from mcp_registry
npm:polopan-products-mcp (package_npm) — from npm, with the record
Showing the latest 15 events. The API returns up to 500 and filters by kind: ?kind=tool_surface_changed
⟨3 unchanged words⟩ ,"properties":{"address":{"description":"DeliveryOptional ad-hoc address object to prefilldirectly into checkout link","properties":{"address1":{"minLength": ⟨29 unchanged words⟩ {"type":"string"},"zip":{"minLength":1,"type":"string"}},"required":["firstName","address1","city","zip"],"type":"object"},"address_id":{"description":"Optional saved address ID to prefill","type":"string"},"country":{"description":"Country name, city, currency, or 2-letter ISO code (e.g. 'US', 'United States', 'UK', 'Dubai', 'CA', 'IN'). Defaults to active saved region.","type":"string"},"coupon":{"description":"Optional discount coupon code to pre-apply in the checkout session","type":"string"},"handle":{"description":"Unique product handle identifier (e.g. 'solid-linen-shirt', 'shopify_11206')","minLength":1,"type":"string"} ⟨3 unchanged words⟩ "description":"Number of units to purchase (1-101 to 10, default 1)","maximum":10,"minimum":1," ⟨7 unchanged words⟩ by the user (e.g. 'M', 'L', 'XL', '40')","type":"string"},"size_index": ⟨18 unchanged words⟩
⟨31 unchanged words⟩ (any look with an out-of-stock item is automatically excluded). Automatically localized to active country / 240+ destination regions. PURPOSE & DISAMBIGUATION: - Curates multi-item aesthetic outfits tailored to specific social events, vibes, and demographics. - Distinct from 'products.search.text': Use this tool to retrieve complete harmonized outfits, NOT individual standalone products. - Distinct from 'looks.curation.recommend': Use this tool to discover outfits by occasion/event theme without a seed product, whereas 'looks.curation.recommend' builds outfits around a specific product handle. WHEN TO USE: - When a user seeks outfit inspiration or complete looks for events (e.g. 'What to wear to a summer cocktail party?', 'Brunch outfit for men', 'Date night dresses'). WHEN NOT TO USE: - Do NOT use when searching for a single product category (use 'products.search.text'). - Do NOT use when coordinating around a specific item the user already picked (use 'looks.curation.recommend'). BEHAVIOR & SAFETY: - Read-only and idempotent with no persistent state modifications. - Strictly filters out any look containing an out-of-stock item (guarantees 100% purchaseable outfits). - Enriches all included products with verified PoloPan purchase links (https://s.polopan.com/p/{handle}) and policy data. PARAMETERS & CONSTRAINTS: - 'occasion' (string, optional): Target occasion or theme ('Wedding & Reception', 'Party', 'Casual', 'Cocktail', 'Date Night', 'Club Night', 'Brunch', 'Vacation', 'Formal'). - 'gender' (enum, default 'women'): Target gender filter ('women', 'men', 'female', 'male'). - 'country' (string, optional): Target country name, city, currency, or ISO-2 code (e.g. 'US', 'United States', 'UK', 'Dubai', 'CA', 'IN'). Defaults to active saved region. - 'mode' (enum, optional): Catalog mode: 'global' (ships to country) or 'local' (domestic only). - 'age' (integer 16-99, default 25): Target demographic age. - 'page' (integer >= 1, default 1): Pagination page number. - 'page_size' (integer 1-100, default 10): Number of looks per page. - 'vendor' (array of strings, optional): Optional brand filter array. MANDATORY AGENT INSTRUCTIONS: 1. Always inform the user of available in-stock sizes, fast shipping SLA, and return policy for eachitem. Formatitemnegative(Negative return daysas= 'Exchange only |X| days'(e.g. -7 -> 'Exchange only 7 days'). 2. When shortlisting a look, render ⟨15 unchanged words⟩ base link (https://s.polopan.com/p/{handle}) duringbrowsing/shortlisting.browsing. Provide direct 1-click checkout link (https://s.polopan.com/p/{ ⟨10 unchanged words⟩
⟨5 unchanged words⟩ "default":25,"description":"Target demographic age (16 to 99, default 25)","maximum":99,"minimum":16,"type":"integer"},"country":{"description":"Country name, city, currency, or 2-letter ISO code (e.g. 'US', 'United States', 'UK', 'Dubai', 'CA', 'IN'). Defaults to active saved region.","type":"string"},"gender":{"default":"women","description":"Target gender filter: 'women' or 'men' (default: 'women')","enum":["women","men","female","male"],"type":"string"},"mode":{"description":"Catalog mode: 'global' (ships to country) or 'local' (domestic only). Defaults to active saved region.","enum":["global","local"],"type":"string"},"occasion":{"description":"Target occasion or vibe ⟨17 unchanged words⟩ 1,"description":"Page number for looks pagination (1-indexed)","maximum":1000,"minimum":1,"type ⟨2 unchanged words⟩ default":10,"description":"Number of looks returned per page (1 to 100, default 10)","maximum":100,"minimum":1,"type":"integer"},"vendor":{"description":"Optional brand or vendor name filter array","items":{"type":"string"}, ⟨4 unchanged words⟩
Get complete recommended outfits. Pass a product 'handle' to find complementary itemsthat stylestyled with it, OR pass an 'occasion' (e.g.'Wedding''Wedding & Reception', 'Party', 'Cocktail', 'Date Night', 'Formal') and 'gender' to discover full occasion looks. ⟨8 unchanged words⟩ look with an out-of-stock item is excluded). Automatically localized to active country / 240+ destination regions. PURPOSE & DISAMBIGUATION: - Generates harmonized outfits coordinated around a seed product handle or occasion theme. - Distinct from 'products.search.alternatives': Use 'looks.curation.recommend' to build coordinating outfits with different garment pieces (e.g. pairing pants and shoes with a shirt); use 'products.search.alternatives' to find visual replacements for the exact same garment. - Distinct from 'looks.curation.by_occasion': 'looks.curation.recommend' supports building outfits around a specific chosen product handle as well as occasion themes. WHEN TO USE: - When a user has selected a product and asks 'How do I style this?' or 'Show me outfits with this shirt'. - When discovering coordinated outfit recommendations for an occasion. WHEN NOT TO USE: - Do NOT use to find substitute alternatives of the same garment (use 'products.search.alternatives'). - Do NOT use for basic keyword search (use 'products.search.text'). BEHAVIOR & SAFETY: - Read-only and idempotent with no persistent state modifications. - Filters out any outfit containing out-of-stock items (guarantees 100% purchaseable looks). - Enriches all included items with verified purchase permalinks and policy strings. PARAMETERS & CONSTRAINTS: - 'handle' (string, optional): Product handle identifier to build coordinating outfits around (e.g. 'solid-linen-shirt'). - 'occasion' (string, optional): Target occasion or theme (e.g. 'Wedding & Reception', 'Party', 'Cocktail', 'Date Night', 'Formal'). - 'gender' (enum, default 'women'): Target gender filter ('women', 'men', 'female', 'male'). - 'country' (string, optional): Target country name, city, currency, or ISO-2 code (e.g. 'US', 'United States', 'UK', 'Dubai', 'CA', 'IN'). Defaults to active saved region. - 'mode' (enum, optional): Catalog mode: 'global' (ships to country) or 'local' (domestic only). - 'page' (integer >= 1, default 1): Pagination page number. - 'page_size' (integer 1-100, default 20): Number of outfit sets per page. MANDATORY AGENT INSTRUCTIONS: 1. Always inform the user of available in-stock sizes, fast shipping SLA, and return policy for eachitem. Formatitemnegative(Negative return daysas= 'Exchange only |X|days' (e.g. -7 -> 'Exchange only 7days'). 2. When shortlisting a look, ⟨39 unchanged words⟩
{"$schema":"http://json-schema.org/draft-07/schema#","properties":{"country":{"description":"Country name, city, currency, or 2-letter ISO code (e.g. 'US', 'United States', 'UK', 'Dubai', 'CA', 'IN'). Defaults to active saved region.","type":"string"},"gender":{"default":"women","description":"Target gender filter: 'women' or 'men' (default: 'women')","enum":["women","men"," ⟨4 unchanged words⟩ },"handle":{"description":"Product handle identifier to build coordinating outfits around (e.g. 'solid-linen-shirt')","type":"string"},"mode":{"description":"Catalog mode: 'global' (ships to country) or 'local' (domestic only). Defaults to active saved region.","enum":["global","local"],"type":"string"},"occasion":{"description":"Target occasion or aesthetic theme (e.g.'Wedding''Wedding & Reception', 'Party', 'Cocktail', 'Date Night', 'Formal')","type":"string"},"page":{"default":1,"description":"Page number for pagination (1-indexed)","maximum":1000,"minimum":1,"type ⟨2 unchanged words⟩ {"default":20,"description":"Number ofoutfitsoutfit sets to return per page (1 to 100, default 20)","maximum":100,"minimum":1,"type ⟨3 unchanged words⟩
Verify real-time live stock availability,livediscounted pricing, product specifications table (Fabric, Pattern, Collar, Sleeves, Fit,Bottom,Care Instructions), shipping/return policies, and availablesizessize variants for a specific fashion product handle. PURPOSE & DISAMBIGUATION: - Real-time inventory and metadata inspection tool for a single product.- Computes the full size-availability matrix, active pricing, discount percentage, specifications dictionary, and resolves the 1-click checkout permalink for a chosen size. - Distinct from 'products.items.get_by_handle': Use this tool to check live stock, available sizes, formatted policies, and get size-specific checkout links; use 'products.items.get_by_handle' for raw catalog document retrieval. - Distinct from 'checkout.links.get_direct_url': Use this tool to verify stock and sizing options; use 'checkout.links.get_direct_url' to generate a final permalink once a size is confirmed. WHEN TO USE: - Before presenting or confirming a product to the user, to verify whether their desired size is in-stock. - When generating the mandatory product specifications table (Fabric, Pattern, Collar, Sleeves, Fit, Care). - When checking return/exchange eligibility and shipping dispatch timelines. WHEN NOT TO USE: - Do NOT use to search across multiple catalog products (use 'products.search.text' or 'products.search.image_url'). BEHAVIOR & SAFETY: - Read-only and idempotent with no persistent state modifications. - Automatically maps numeric and Indian/UK/EU shoe and apparel sizes (e.g. '6' -> EU 39, 'M' -> Medium). - Formats negative return days cleanly as 'Exchange only |X| days' (e.g. -7 -> 'Exchange only 7 days'). - Returns structured JSON with 'is_in_stock', 'available_sizes', 'out_of_stock_sizes', 'product_details', 'shipping_policy_text', and 'return_policy_text'. PARAMETERS & CONSTRAINTS: - 'handle' (string, required): Unique product handle identifier (e.g. 'solid-linen-shirt', 'shopify_11206'). - 'desired_size' (string, optional): Size label to verify against the variant inventory (e.g. 'M', 'L', 'XL', '32', '40'). - 'size_index' (integer >= 0, optional): Zero-based index of the size variant. MANDATORY AGENT INSTRUCTIONS: 1. Alwaystellinform the usertheof available in-stock sizes,andfastdisplaydispatchreturningSLA,&andshippingreturnpoliciespolicy (Negative return days = 'Exchange only |X| days'). 2.WhenDisplaypresenting/shortlistingtheproductsproduct specifications table (Fabric,displayPattern,theCollar,productSleeves,specificationsFit,table.Care). 3. Return the base link (https://s.polopan.com/p/{handle}) during browsing. Providethedirect checkout link (https://s.polopan.com/p/{handle}/{ ⟨8 unchanged words⟩
{"$schema":"http://json-schema.org/draft-07/schema#","properties":{"country":{"description":"Country name, city, currency, or 2-letter ISO code (e.g. 'US', 'United States', 'UK', 'Dubai', 'CA', 'IN'). Defaults to active saved region.","type":"string"},"desired_size":{"description":"Optional size query to verify against variant inventory (e.g. 'M', 'L', 'XL', '32', '40' ⟨2 unchanged words⟩ handle":{"description":"Unique product handle identifier (e.g. 'solid-linen-shirt', 'shopify_11206')","minLength":1,"type":"string"},"size_index":{"description":"Zero-based index of the specific size variant to inspect","maximum":9007199254740991,"minimum":0,"type ⟨5 unchanged words⟩
Fetchathesingleraw product document and metadata for a single item by unique producthandle.handle identifier. Returnsdetailedcatalog metadata,variantsvariant details, available in-stock sizes, price details, andtheverifiedshortpurchase link (https://s.polopan.com/p/{handle}). PURPOSE & DISAMBIGUATION: - Retrieves the full catalog record for a specific product handle. - Distinct from 'products.items.check_stock': Use 'products.items.get_by_handle' to fetch general catalog metadata; use 'products.items.check_stock' to get live variant inventory availability, computed sizing, specifications table, and 1-click checkout permalinks. - Distinct from 'products.search.text': Use this tool when you already have an exact product handle. WHEN TO USE: - When you need the raw product metadata, image list, description, or variant array for a known product handle. WHEN NOT TO USE: - Do NOT use to check real-time variant stock or obtain 1-click checkout URLs (use 'products.items.check_stock'). - Do NOT use for general keyword product searches (use 'products.search.text'). BEHAVIOR & SAFETY: - Read-only and idempotent with no persistent state modifications. - Returns HTTP 404 error if handle does not exist. - Enriches returned document with verified purchase URLs. PARAMETERS & CONSTRAINTS: - 'handle' (string, required): Unique product handle identifier (e.g. 'solid-linen-shirt', 'shopify_11206').
{"$schema":"http://json-schema.org/draft-07/schema#","properties":{"country":{"description":"Country name, city, currency, or 2-letter ISO code (e.g. 'US', 'United States', 'UK', 'Dubai', 'CA', 'IN'). Defaults to active saved region.","type":"string"},"handle":{"description":"Unique product handle identifier (e.g. 'solid-linen-shirt', 'shopify_11206')","minLength":1,"type":"string" ⟨4 unchanged words⟩
Findproductvisualalternativessubstitute products within aselecteddesignatedbudgetpricerangebracket for a given fashion item handle usingproductvisual imagesimilaritysimilarity. Automatically localized to active country / 240+ destination regions. PURPOSE & DISAMBIGUATION: - Retrieves catalog items visually similar to an existing product (e.g. finding similar shirts or jackets) constrained to a target budget tier. - Distinct from 'products.search.text': Use this tool when substituting a specific known item by handle, NOT for free-text search queries. - Distinct from 'products.search.image_url' / 'products.search.image_upload': Use this tool when referencing an existing catalog item handle, NOT for user-uploaded or external images. - Distinct from 'looks.curation.recommend': Use this tool to find replacement substitutes for the samelogicgarmentascategory,extensionNOT for pairing complementary outfit pieces. WHEN TO USE: - When a shopper likes a product but requests cheaper alternatives, higher-end alternatives, or similar styles in a specific price bracket (e.g., 'show cheaper alternatives for this shirt under 1500'). WHENEveryNOT TO USE: - Do NOT use for general keyword discovery without a source producturlhandleis(use 'products.search.text'). - Do NOT use to assemble a full outfit / lookbook (use 'looks.curation.recommend' or 'looks.curation.by_occasion'). BEHAVIOR & SAFETY: - Read-only and idempotent with no persistent side effects. - Automatically fetches thePoloPansourceshortproduct'spurchaseprimarylinkimagefromembeddingGETand/products/link/{queries the catalog for visual matches within the requested price range. - Excludes the source product handle}from returned alternatives. - Returns clean PoloPan purchase permalinks (https://s.polopan.com/p/{handle};). PARAMETERSnever& CONSTRAINTS: - 'handle' (string, required): The unique identifier of therawsourcecatalogproductURLto find alternatives for. - 'budget_range' (enum, default '1501-3000'): Price tier bracket ('0-1500', '1501-3000', '3001-5000', '5000+'). - 'country' (string, optional): Target country name, city, currency, or ISO-2 code (e.g. 'US', 'United States', 'UK', 'Dubai', 'CA', 'IN'). Defaults to active saved region. - 'mode' (enum, optional): Catalog mode: 'global' (ships to country) or 'local' (domestic only). - 'limit' (integer 1-100, default 6): Maximum number of alternative products returned in the final list. - 'page' (integer >= 1, default 1): Pagination page number for the search pool. - 'page_size' (integer 1-100, default 8): Number of candidate items fetched per page before limit filtering. - 'sort_by' (enum, default 'relevance'): Ranking attribute ('relevance', 'price', 'title'). - 'sort_order' (enum, default 'desc'): Sort order direction ('asc' or 'desc'). - 'personalize' (boolean, default false): Whether to apply personalization weights.
⟨6 unchanged words⟩ :"1501-3000","description":"Target price bracket filter in local currency: '0-1500', '1501-3000', '3001-5000', or '5000+'","enum":["0-1500","1501-3000","3001-5000","5000+"],"type":"string"},"country":{"description":"Country name, city, currency, or 2-letter ISO code (e.g. 'US', 'United States', 'UK', 'Dubai', 'CA', 'IN'). Defaults to active saved region.","type":"string"},"handle":{"description":"BaseThe unique product handle identifier to find visual alternatives for (e.g. 'solid-cotton-shirt')","minLength":1,"type":"string"} ⟨2 unchanged words⟩ :6,"description":"Maximum number of filteredalternativesalternative products to return in the result (1-100)","maximum":100,"minimum":1,"type":"integer"},"mode":{"description":"Catalog mode: 'global' (ships to country) or 'local' (domestic only). Defaults to active saved region.","enum":["global","local"],"type":"string"},"page":{"default":1,"description":"PagePaginationnumberpagefor
Upload a local image file (or base64 string) and search PoloPan catalog products usingthe uploadedvisual imageURL.similarity. Returns matching products with available in-stock sizes, pricing, and verified purchase URLs (https://s.polopan.com/p/{handle}). Automatically localized to active country / 240+ destination regions. PURPOSE & DISAMBIGUATION: - Performs reverse visual search by uploading a local or base64-encoded image to secure temporary storage, then querying visual embeddings. - Distinct from 'products.search.image_url': Use this tool when the image file is local on the user's machine or in base64 format, NOT already on a public URL. - Distinct from 'vision.outfit.detect_pieces': Use this tool to search for products matching a single garment, NOT for decomposing full multi-piece outfits into bounding boxes. WHEN TO USE: - When a user uploads a local photo/screenshot or supplies base64 image data to find matching fashion products in the catalog. WHEN NOT TO USE: - Do NOT use when the image is already accessible via a public web URL (use 'products.search.image_url'). - Do NOT use for text-only searches (use 'products.search.text'). BEHAVIOR & SAFETY: - Read-only catalog query with temporary image upload artifact (automatically expires after 'expiry_hours', default 24h). - Resolves MIME types automatically if not explicitly provided. - Enriches all returned items with verified PoloPan purchase links and stock metadata. PARAMETERS & CONSTRAINTS: - 'image_path' (string, optional): Local file system path to the image file (one of image_path or image_base64 is required). - 'image_base64' (string, optional): Base64-encoded image data string. - 'country' (string, optional): Target country name, city, currency, or ISO-2 code (e.g. 'US', 'United States', 'UK', 'Dubai', 'CA', 'IN'). Defaults to active saved region. - 'mode' (enum, optional): Catalog mode: 'global' (ships to country) or 'local' (domestic only). - 'content_type' (string, default 'image/jpeg'): MIME type of the uploaded image (e.g. 'image/jpeg', 'image/png', 'image/webp'). - 'expiry_hours' (integer 1-168, default 24): Temporary upload lifetime in hours before expiration. - 'page' (integer >= 1, default 1): Pagination page number. - 'page_size' (integer 1-100, default 20): Number of items per page. - 'sort_by' (enum, default 'relevance'): Sorting attribute ('relevance', 'price', 'title'). - 'sort_order' (enum, default 'desc'): Sort direction ('asc' or 'desc'). - 'gender' (string, optional): Target gender filter ('men', 'women', or 'unisex'). - 'size' (array of strings, optional): Size filter array. - 'price_min' (number, optional): Minimum price threshold. - 'price_max' (number, optional): Maximum price threshold. - 'vendor' (array of strings, optional): Brand filter array. - 'personalize' (boolean, default false): Whether to personalize search ranking.
⟨9 unchanged words⟩ type of the image, e.g. 'image/jpeg', 'image/png', 'image/webp'","type":"string"},"country":{"description":"Country name, city, currency, or 2-letter ISO code (e.g. 'US', 'United States', 'UK', 'Dubai', 'CA', 'IN'). Defaults to active saved region.","type":"string"},"expiry_hours":{"default":24,"description":"Temporary upload URL lifetime in hours before expiration (1 to 168, default 24)","maximum":168,"minimum":1,"type":"integer"},"gender":{"description":"Target gender filter: 'men', 'women', or 'unisex'","type":"string"},"image_base64":{"description":"Base64-encoded image data string (alternative to image_path)","minLength":1,"type":"string"} ⟨2 unchanged words⟩ "Local file system path to the image file (e.g. '/path/to/dress.jpg')","minLength":1,"type":"string"},"mode":{"description":"Catalog mode: 'global' (ships to country) or 'local' (domestic only). Defaults to active saved region.","enum":["global","local"],"type":"string"},"page":{"default":1,"description":"PagePaginationnumberpagefornumberpagination(1-indexed)","maximum":1000,"minimum":1,"type ⟨5 unchanged words⟩ ":"Number of items to return per page (1 to 100, default 20)
Search PoloPan catalog products usingimage_urlvisualandimage similarity from a publicly accessible image URL with optional multi-attribute filters. Returns visually similar products with availablein-stocksizes, pricing, and verified purchase URLs (https://s.polopan.com/p/{handle}). Automatically localized to active country / 240+ destination regions. PURPOSE & DISAMBIGUATION: - Performs reverse visual search using computer-vision embeddings for a remote image URL. - Distinct from 'products.search.text': Use this tool when you have an image URL, NOT for textual keyword queries. - Distinct from 'products.search.image_upload': Use this tool for publicly hosted HTTP(S) image URLs, NOT for local file paths or base64 data. - Distinct from 'vision.outfit.detect_pieces': Use this tool to search catalog items matching an entire single-garment image, NOT for segmenting multi-garment influencer photos into bounding boxes. WHEN TO USE: - When the user shares a web link to an image (e.g. Pinterest, Instagram, blog post) and wants to find visually matching products in the PoloPan catalog. WHEN NOT TO USE: - Do NOT use when the image is stored on local disk or as base64 data (use 'products.search.image_upload'). - Do NOT use when searching by text descriptions (use 'products.search.text'). - Do NOT use when you need to crop/isolate individual outfit pieces from a full-body model photo (use 'vision.outfit.detect_pieces'). BEHAVIOR & SAFETY: - Read-only and idempotent with no persistent state modifications. - Downloads the image, generates visual embeddings, and retrieves ranked catalog matches. - Enriches all returned items with verified PoloPan purchase links and stock metadata. PARAMETERS & CONSTRAINTS: - 'image_url' (string, required): Publicly accessible HTTP(S) URL of the image to search for visual matches. - 'country' (string, optional): Target country name, city, currency, or ISO-2 code (e.g. 'US', 'United States', 'UK', 'Dubai', 'CA', 'IN'). Defaults to active saved region. - 'mode' (enum, optional): Catalog mode: 'global' (ships to country) or 'local' (domestic only). - 'page' (integer >= 1, default 1): Pagination page number. - 'page_size' (integer 1-100, default 20): Number of candidate items returned per page. - 'sort_by' (enum, default 'relevance'): Ranking attribute ('relevance', 'price', 'title'). - 'sort_order' (enum, default 'desc'): Sort order ('asc' or 'desc'). - 'gender' (string, optional): Target gender filter ('men', 'women', or 'unisex'). - 'size' (array of strings, optional): Filter by available size labels. - 'price_min' (number, optional): Minimum price threshold. - 'price_max' (number, optional): Maximum price threshold. - 'vendor' (array of strings, optional): Brand filter array. - 'personalize' (boolean, default false): Whether to apply personalized ranking weights.
{"$schema":"http://json-schema.org/draft-07/schema#","properties":{"country":{"description":"Country name, city, currency, or 2-letter ISO code (e.g. 'US', 'United States', 'UK', 'Dubai', 'CA', 'IN'). Defaults to active saved region.","type":"string"},"gender":{"description":"Target gender filter: ⟨6 unchanged words⟩ },"image_url":{"description":"Publicly accessible HTTP(S) URL of the fashion image to search for visual matches","format":"uri","type":"string"},"mode":{"description":"Catalog mode: 'global' (ships to country) or 'local' (domestic only). Defaults to active saved region.","enum":["global","local"],"type":"string"},"page":{"default":1,"description":"Page number for pagination (1-indexed)","maximum":1000,"minimum":1,"type ⟨5 unchanged words⟩ ":"Number of items to return per page (1 to 100, default 20)","maximum":100,"minimum":1,"type ⟨3 unchanged words⟩ false,"description":"Whether to apply personalized ranking based on user style profile","type":"boolean"},"price_max":{"description":"Maximum price in local currency","minimum":0,"type":"number"},"price_min":{"description":"Minimum price in local currency","minimum":0,"type":"number"},"size":{"description":"Array of sizes to filter by (e.g. ['S', 'M', 'L'])","items":{"type":"string"}, ⟨5 unchanged words⟩ ","description":"Sorting criteria for search results: 'relevance', 'price', or 'title'","enum":["relevance","price"," ⟨5 unchanged words⟩ "desc","description":"Sort order: 'asc'or
Search PoloPan catalog products using a text keyword queryandwith optional multi-attribute filters. Returnsproductsmatching fashion items with available in-stock sizes,specificationsproducttablespecifications, shipping/return policies, discounted pricing, and verified purchase URLs (https://s.polopan.com/p/{handle}). Automatically localized to active country / 240+ destination regions.MANDATORYPURPOSEAGENT&INSTRUCTIONSDISAMBIGUATION:1.-AlwaysPrimarytelltext-basedthecatalog search tool for fashion discovery across apparel, footwear, and accessories. - Distinct from 'products.search.image_url' / 'products.search.image_upload': Use this tool for textual queries and keyword filters, NOT for visual image search. - Distinct from 'products.search.alternatives': Use this tool for open discovery queries, NOT for finding direct visual substitutes of a known product handle. - Distinct from 'looks.curation.by_occasion': Use this tool to search individual products, NOT complete multi-piece outfit looks. WHEN TO USE: - When a userthesearchesavailablefor clothing or fashion styles using keywords, brand names, colors, or categories (e.g. 'black leather jacket', 'floral summer midi dress', 'men linen shirts'). - When refining catalog searches with structured filters like price ranges, gender, sizes, country regions, or vendor brands. WHEN NOT TO USE: - Do NOT use when the user provides an image URL or image file (use 'products.search.image_url' or 'products.search.image_upload'). - Do NOT use when searching foritemscheaper/higher-end substitutes of a specific known product (use 'products.search.alternatives'). - Do NOT use to find curated complete occasion outfits (use 'looks.curation.by_occasion'). BEHAVIOR & SAFETY: - Read-only and idempotent with no persistent state modifications. - Automatically sanitizes and enriches product records with verified PoloPan short permalinks (https://s.polopan.com/p/{handle}), computed in-stock size lists, anddisplayhuman-readablereturningshipping and return policy strings. - Handles pagination and multi-attribute filtering deterministically. PARAMETERS &shippingCONSTRAINTS: -policies'query' (string, required): Free-text search query or style keyword (e.g. 'black linen shirt', 'oversized hoodie'). - 'country' (string, optional): Target country name, city, currency, or ISO-2 code (e.g. 'US', 'United States', 'UK', 'Dubai', 'CA', 'IN'). Defaults to active saved region. - 'mode' (enum, optional): Catalog mode: 'global' (ships to country) or 'local' (domestic only). - 'page' (integer >= 1, default 1): Pagination page number. - 'page_size' (integer 1-100, default 20): Number of products returned per page. - 'sort_by' (enum, default 'relevance'): Ranking criterion ('relevance', 'price', 'title'). - 'sort_order' (enum, default 'desc'): Sort direction ('asc' for ascending, 'desc' for descending). - 'gender' (string, optional): Target demographic filter ('men', 'women', or 'unisex'). - 'size' (array of strings, optional): Size filter array (e.g. ['S', 'M', 'L', 'XL', '32', '40']). - 'price_min' (number, optional): Minimum price threshold in local currency. - 'price_max' (number, optional): Maximum price threshold in local currency. - 'vendor' (array of strings, optional): List of brand or vendor names to filter by. MANDATORY AGENT INSTRUCTIONS: 1. Always communicate available in-stock sizes, fast dispatch SLA, and return policy for each product (Negative return days = 'Exchange only |X| days'). 2. Whenpresenting/shortlistingpresenting or shortlisting products, display the product specificationstable.table (Fabric, Pattern, Collar, Sleeves, Fit, Care). 3. Return the clean base link (https://s.polopan.com/p/{handle}) during browsing. Providethedirect checkout link (https://s.polopan.com/p/{handle}/{ ⟨8 unchanged words⟩
{"$schema":"http://json-schema.org/draft-07/schema#","properties":{"country":{"description":"Country name, city, currency, or 2-letter ISO code (e.g. 'US', 'United States', 'UK', 'Dubai', 'CA', 'IN'). Defaults to active saved region.","type":"string"},"gender":{"description":"Target gender filter: 'men', 'women', or 'unisex'","type":"string"},"mode":{"description":"Catalog mode: 'global' (ships to country) or 'local' (domestic only). Defaults to active saved region.","enum":["global","local"],"type":"string"},"page":{"default":1,"description":"Page numberPaginationforpagepaginationnumber (1-indexed, starts at 1)","maximum":1000,"minimum ⟨7 unchanged words⟩ "Number of items to return per page (max1 to 100, default 20)","maximum":100,"minimum":1," ⟨3 unchanged words⟩ description":"Maximum price in local currency","minimum":0,"type":"number"},"price_min":{"description":"Minimum price in local currency","minimum":0,"type":"number"},"query":{"description" ⟨22 unchanged words⟩ },"size":{"description":"Array ofsizessize labels
Deconstruct an outfit image or influencer photo into individual fashion pieces (e.g. Upper-body garment, Lower-body garment, Dress, Footwear, Bag, Headwear) with normalized bounding box coordinates and detection confidence scores. PURPOSE & DISAMBIGUATION: - Computer-vision object detection tool designed to analyze multi-item outfit photographs and isolate individual garments with their spatial coordinates. - Distinct from 'products.search.image_url' / 'products.search.image_upload': Use this tool tobreaksegmentdownafull-bodyfulllookoutfitphotosintoandpieces before querying, NOT to directly retrieve catalog search results. - Distinct from 'looks.curation.recommend': Use this tool formatchingimage-basedcatalogpieceitemsdecomposition, NOT text-based styling suggestions. WHEN TO USE: - When the user provides a full-body model photo, street style snapshot, or celebrity outfit and wants to identify each individual clothing piece (jacket, top, pants, shoes, bag) to find matching products for each piece. WHEN NOT TO USE: - Do NOT use when the image contains only a single standalone garment (use 'products.search.image_url' or 'products.search.image_upload' directly). - Do NOT use for text-only searches (use 'products.search.text'). BEHAVIOR & SAFETY: - Read-only and idempotent with no persistent state modifications. - Supports input via local file path ('image_path'), base64 string ('image_base64'), or public URL ('image_url'). Exactly one source must be provided. - Returns an array of detected pieceindividually.objects with 'label', 'confidence' (0.0 to 1.0), and normalized 'box' coordinates [ymin, xmin, ymax, xmax]. PARAMETERS & CONSTRAINTS: - 'image_path' (string, optional): Local file system path to the outfit image (e.g. '/tmp/outfit.jpg'). - 'image_base64' (string, optional): Base64-encoded image data string. - 'image_url' (string, optional): Public HTTP(S) URL of the image. - 'threshold' (number 0.05-0.95, default 0.22): Detection confidence threshold for bounding box filtering.
⟨4 unchanged words⟩ :{"image_base64":{"description":"Base64-encoded image data string for outfit piece detection","minLength":1,"type":"string"},"image_path":{"description":"Local file system path to the outfit image file to deconstruct" ⟨26 unchanged words⟩ for object detection bounding boxes (0.05 to 0.95, default 0.22)","maximum":0.95,"minimum":0.05," ⟨4 unchanged words⟩
Delete Saved Delivery Address — Delete a saved delivery address by ID from ~/.polopan/region.json.
Get Current Delivery Address for Region — Get the default delivery/shipping address saved for the currently active region from local configuration (~/.polopan/region.json). WHEN TO USE (CRITICAL ANTI-SHORTCIRCUIT RULE): - ALWAYS call this BEFORE generating 1-click checkout links to check if the user already has a saved delivery address for their destination country. - If 'has_address' is false, DO NOT emit a naked checkout link. Prompt the user naturally for their shipping address (First Name, Street Address, City, Postal Code, Phone & Email) and save it using 'address.save'. - If 'has_address' is true, inform the user you are prefi…
List Saved Delivery Addresses — List all saved customer delivery addresses stored in ~/.polopan/region.json, optionally filtered by country.
Save or Update Delivery Address — Save a customer delivery shipping address mapped to the active region in ~/.polopan/region.json. Matches Flutter app (newapp) address schema: firstName, lastName, address1, address2, city, province, zip, country, phone, email, type.
Set Default Delivery Address — Set an existing address as the default shipping address for its country in ~/.polopan/region.json.
Get Product Size Guide & Fit Recommendation — Retrieve the complete size guide chart, body measurement matrix (Chest/Bust, Waist, Hip, Length, Shoulders), unit switcher (inches/cm), how-to-measure guidelines, and automatic best-fit size recommendations for a specific product handle. PURPOSE & DISAMBIGUATION: - Dedicated size guide and fit consultancy tool for apparel and footwear. - Computes dimensional measurements across sizes, supports metric (cm) <-> imperial (in) unit conversions, and maps international/brand scales. - If user body measurements are provided (e.g. chest: 40 in, waist: 32 in), computes the best matching size variant …
Get Current Shopping Region & Settings — Get the currently active shopping destination country, currency code, symbol, phone code, and catalog scope mode from persistent local configuration (~/.polopan/region.json).
List & Search Supported Countries — Search the 240+ supported destination countries with localized currency codes, symbols, flags, phone codes, and price groups from live platform settings.
Set Current Shopping Region — Set the active shopping country/region using any natural country name, city (e.g. 'Dubai', 'London', 'California', 'Paris'), 2-letter ISO code ('US', 'GB', 'IN', 'AE', 'CA'), or currency ('USD', 'AED', 'GBP', 'EUR'). Saves to persistent local JSON (~/.polopan/region.json) so the user never needs to be asked again across turns and sessions.
before
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"checkout_url":{"description":"Direct 1-click purchase permalink (https://s.polopan.com/p/{handle}/{size_index})","type":"string"},"handle":{"description":"Product handle","type":"string"},"size":{"description":"Selected size","type":"string"},"size_index":{"description":"Selected size index","type":"number"}},"required":["handle","size_index","checkout_url"],"type":"object"}after
—before
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"looks":{"description":"List of verified in-stock occasion looks","items":{"additionalProperties":false,"properties":{"id":{"description":"Unique look ID","type":"string"},"image_url":{"description":"Main styled look image","type":"string"},"occasion":{"description":"Occasion tag","type":"string"},"products":{"description":"100% in-stock items in this outfit","items":{"additionalProperties":false,"properties":{"handle":{"description":"Product handle","type":"string"},"price":{"description":"Price","type":"number"},"title":{"description":"Product title","type":"string"},"url":{"description":"Purchase link","type":"string"}},"required":["handle","title","price","url"],"type":"object"},"type":"array"},"title":{"description":"Look title","type":"string"}},"type":"object"},"type":"array"}},"required":["looks"],"type":"object"}after
—before
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"handle":{"description":"Base product handle","type":"string"},"looks":{"description":"List of recommended outfits","items":{"additionalProperties":false,"properties":{"image_url":{"description":"Look image URL","type":"string"},"title":{"description":"Outfit title","type":"string"}},"type":"object"},"type":"array"}},"type":"object"}after
—before
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"available_sizes":{"description":"List of currently available in-stock sizes","items":{"type":"string"},"type":"array"},"direct_checkout_url":{"description":"Verified 1-click checkout permalink","type":"string"},"handle":{"description":"Product handle","type":"string"},"is_in_stock":{"description":"Overall stock status","type":"boolean"},"out_of_stock_sizes":{"description":"List of out-of-stock sizes","items":{"type":"string"},"type":"array"},"title":{"description":"Product title","type":"string"}},"required":["handle","title","is_in_stock","available_sizes","out_of_stock_sizes","direct_checkout_url"],"type":"object"}after
—before
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"handle":{"description":"Product handle identifier","type":"string"},"price":{"description":"Price","type":"number"},"title":{"description":"Product title","type":"string"},"url":{"description":"Verified purchase link","type":"string"},"variants":{"description":"Variant size list","items":{"additionalProperties":false,"properties":{"in_stock":{"description":"Stock availability","type":"boolean"},"size":{"description":"Size label","type":"string"}},"required":["size","in_stock"],"type":"object"},"type":"array"}},"required":["handle","title","price","url"],"type":"object"}after
—before
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"budget_range":{"description":"Applied budget bracket","type":"string"},"products":{"description":"List of visual alternatives within budget","items":{"additionalProperties":false,"properties":{"handle":{"description":"Alternative product handle","type":"string"},"price":{"description":"Alternative product price","type":"number"},"title":{"description":"Alternative product title","type":"string"},"url":{"description":"Purchase link","type":"string"}},"required":["handle","title","price","url"],"type":"object"},"type":"array"},"source_handle":{"description":"Source product handle","type":"string"}},"required":["budget_range","source_handle","products"],"type":"object"}after
—before
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"products":{"description":"Matching products","items":{"additionalProperties":false,"properties":{"handle":{"description":"Product handle","type":"string"},"price":{"description":"Price","type":"number"},"title":{"description":"Product title","type":"string"},"url":{"description":"Purchase link","type":"string"}},"required":["handle","title","price","url"],"type":"object"},"type":"array"},"uploaded_image_url":{"description":"Temporary URL of the uploaded image","type":"string"}},"required":["uploaded_image_url","products"],"type":"object"}after
—before
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"products":{"description":"List of matching fashion products","items":{"additionalProperties":false,"properties":{"handle":{"description":"Unique product handle identifier","type":"string"},"price":{"description":"Current selling price","type":"number"},"title":{"description":"Product name and title","type":"string"},"url":{"description":"Verified purchase link","type":"string"}},"required":["handle","title","price","url"],"type":"object"},"type":"array"}},"required":["products"],"type":"object"}after
—before
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"pagination":{"additionalProperties":false,"description":"Pagination metadata","properties":{"page":{"description":"Current page number","type":"number"},"page_size":{"description":"Number of items per page","type":"number"},"total":{"description":"Total number of matching products","type":"number"}},"required":["page","page_size"],"type":"object"},"products":{"description":"List of matching fashion products","items":{"additionalProperties":false,"properties":{"brand":{"description":"Brand or vendor name","type":"string"},"discount_percent":{"description":"Discount percentage","type":"number"},"handle":{"description":"Unique product handle identifier","type":"string"},"mrp":{"description":"Original maximum retail price","type":"number"},"price":{"description":"Current selling price","type":"number"},"sizes":{"description":"List of available in-stock sizes","items":{"type":"string"},"type":"array"},"title":{"description":"Product name and title","type":"string"},"url":{"description":"Verified purchase link","type":"string"}},"required":["handle","title","price","url"],"type":"object"},"type":"array"}},"required":["products"],"type":"object"}after
—before
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"pieces":{"description":"List of detected fashion pieces","items":{"additionalProperties":false,"properties":{"box":{"description":"Normalized bounding box coordinates [ymin, xmin, ymax, xmax]","items":{"type":"number"},"type":"array"},"confidence":{"description":"Confidence score between 0.0 and 1.0","type":"number"},"label":{"description":"Detected clothing category (e.g. Upper-body garment, Lower-body garment, Footwear, Bag)","type":"string"}},"required":["label","confidence","box"],"type":"object"},"type":"array"}},"required":["pieces"],"type":"object"}after
—