PoloPan Fashion MCP Server

Quality 63 / 100needs work

19 tools, about 12,287 tokens to load them all · tool set 58ce6c5fd21b · tools last changed 2026-10-14 · checked 2026-10-20 07:21 UTC

Tool changes

• 2026-10-14looks.curation.recommendchangeddescription, input schemameaning changed
  before

  Get complete recommended outfits. Pass a product 'handle' to find complementary items that style with it, OR pass an 'occasion' (e.g. 'Wedding', 'Party', 'Cocktail', 'Date Night') and 'gender' to discover full occasion looks. All returned looks are verified 100% in-stock (any look with an out-of-stock item is excluded). MANDATORY AGENT INSTRUCTIONS: 1. Always inform the user of available in-stock sizes, shipping SLA, and return policy for each item. Format negative return days as 'Exchange only |X| days' (e.g. -7 -> 'Exchange only 7 days'). 2. When shortlisting a look, render the product specifications table (Fabric, Pattern, Collar, Sleeves, Fit, Care). 3. Provide the base link (https://s.polopan.com/p/{handle}) during shortlisting. Provide direct 1-click checkout link (https://s.polopan.com/p/{handle}/{size_index}) ONLY after the user's size is finalized.

  after · 43% of words in common

  Get complete recommended outfits. Pass a product 'handle' to find complementary items styled with it, OR pass an 'occasion' (e.g. 'Wedding & Reception', 'Party', 'Cocktail', 'Date Night', 'Formal') and 'gender' to discover full occasion looks. All returned looks are verified 100% in-stock (any 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 each item (Negative return days = 'Exchange only |X| days'). 2. When shortlisting a look, render the product specifications table (Fabric, Pattern, Collar, Sleeves, Fit, Care). 3. Provide the base link (https://s.polopan.com/p/{handle}) during shortlisting. Provide direct 1-click checkout link (https://s.polopan.com/p/{handle}/{size_index}) ONLY after the user's size is finalized.

• 2026-10-14products.search.alternativeschangeddescription, input schemameaning changed
  before

  Find product alternatives within a selected budget range using product image similarity (same logic as extension). Every product url is the PoloPan short purchase link from GET /products/link/{handle} (https://s.polopan.com/p/{handle}; never the raw catalog URL).

  after · 11% of words in common

  Find visual substitute products within a designated price bracket for a given fashion item handle using visual image similarity. 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 same garment category, NOT 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'). WHEN NOT TO USE: - Do NOT use for general keyword discovery without a source product handle (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 the source product's primary image embedding and 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}). PARAMETERS & CONSTRAINTS: - 'handle' (string, required): The unique identifier of the source product to 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.

• 2026-10-14checkout.links.get_direct_urlchangeddescription, input schemameaning changed
  before

  Generate the direct 1-click checkout purchase URL for a specific product and 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 this direct link with /{size_index} after the user has explicitly selected/confirmed their size from the available in-stock options. If there is any confusion regarding sizes or if the user is still browsing, provide ONLY the clean base link (https://s.polopan.com/p/{handle}) without /{size_index}.

  after · 33% of words in common

  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 with the user's selected size index, unit quantity, and pre-applied coupon code. - Distinct from browsing links: General browsing uses base link (https://s.polopan.com/p/{handle}); this tool generates size-specific purchase permalinks (https://s.polopan.com/p/{handle}/{size_index}). WHEN TO USE: - ONLY after the user has explicitly selected and confirmed their size (e.g. 'I want size M' or 'size 40'). WHEN NOT TO USE: - Do NOT provide direct checkout URLs with /{size_index} during initial product browsing, shortlisting, or if size is ambiguous (use base link https://s.polopan.com/p/{handle}). BEHAVIOR & SAFETY: - Read-only link generator with no persistent state modifications or charges. - Automatically resolves variant index if a size string (e.g. 'M', 'L') is provided without size_index. - Encodes optional coupon parameters and quantity parameters into the final URL. PARAMETERS & CONSTRAINTS: - 'handle' (string, required): Unique product handle identifier. - 'size' (string, optional): Size label confirmed by user (e.g. 'M', 'L', 'XL', '42'). - 'size_index' (integer >= 0, optional): Zero-based index of the chosen size variant. - 'quantity' (integer 1-10, default 1): Number of units to purchase. - 'coupon' (string, optional): Optional discount coupon code to pre-apply (e.g. 'SAVE15'). - 'address_id' (string, optional): ID of specific saved address to prefill. - 'address' (object, optional): Delivery address object to prefill directly.

• 2026-10-14products.items.get_size_guideadded

  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 with fit confidence and relaxed vs snug fit advice. - Distinct from 'products.items.check_stock': Use 'products.items.get_size_guide' when the user asks sizing/fit questions (e.g. 'What size fits a 40 chest?' or 'Show me the size chart'); use 'products.items.check_stock' for inventory checking. WHEN TO USE: - When a user asks about sizing, fit, measurements, or how a garment fits (e.g., 'Is M true to size?', 'What are the chest measurements for this shirt in cm?'). - When helping a customer choose between two sizes based on their body dimensions. - When rendering a full size chart matrix. WHEN NOT TO USE: - Do NOT use for products without size variants (e.g., standard accessories, bags). BEHAVIOR & SAFETY: - Read-only and idempotent. - Supports 'in' (inches) and 'cm' (centimeters) with automated dynamic range conversion. - Connects each recommended size to its direct 1-click checkout permalink (https://s.polopan.com/p/{handle}/{size_index}). PARAMETERS & CONSTRAINTS: - 'handle' (string, required): Unique product handle identifier. - 'unit' (enum 'in' | 'cm', default 'in'): Preferred measurement unit system. - 'desired_size' (string, optional): Specific size variant to inspect (e.g. 'M', 'L', '32', '40'). - 'user_chest' (number, optional): User's chest / bust body measurement. - 'user_waist' (number, optional): User's waist body measurement. - 'user_hip' (number, optional): User's hip body measurement. - 'user_unit' (enum 'in' | 'cm', default 'in'): Unit of the user's provided body measurements.

• 2026-10-14products.items.check_stockchangeddescription, input schemameaning changed
  before

  Verify real-time stock availability, live discounted pricing, product specifications table (Fabric, Collar, Sleeves, Fit, Bottom, Care Instructions), shipping/return policies, and available sizes for a product. MANDATORY AGENT INSTRUCTIONS: 1. Always tell the user the available in-stock sizes, and display returning & shipping policies (Negative return days = 'Exchange only |X| days'). 2. When presenting/shortlisting products, display the product specifications table. 3. Return the base link (https://s.polopan.com/p/{handle}) during browsing. Provide the direct checkout link (https://s.polopan.com/p/{handle}/{size_index}) ONLY after the user's size is finalized.

  after · 33% of words in common

  Verify real-time live stock availability, discounted pricing, product specifications table (Fabric, Pattern, Collar, Sleeves, Fit, Care Instructions), shipping/return policies, and available size 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. Always inform the user of available in-stock sizes, fast dispatch SLA, and return policy (Negative return days = 'Exchange only |X| days'). 2. Display the product specifications table (Fabric, Pattern, Collar, Sleeves, Fit, Care). 3. Return the base link (https://s.polopan.com/p/{handle}) during browsing. Provide direct checkout link (https://s.polopan.com/p/{handle}/{size_index}) ONLY after the user's size is finalized.

• 2026-10-14products.items.get_by_handlechangeddescription, input schemameaning changed
  before

  Fetch a single product document by product handle. Returns detailed metadata, variants, in-stock sizes, price details, and the verified short purchase link (https://s.polopan.com/p/{handle}).

  after · 21% of words in common

  Fetch the raw product document and metadata for a single item by unique product handle identifier. Returns catalog metadata, variant details, available in-stock sizes, price details, and verified purchase 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').

• 2026-10-14looks.curation.by_occasionchangeddescription, input schemameaning changed
  before

  Discover complete curated fashion looks styled for specific occasions (e.g., 'Wedding & Reception', 'Party', 'Casual', 'Cocktail', 'Date Night', 'Club Night', 'Brunch', 'Vacation', 'Formal'). All returned looks are verified 100% in-stock (any look with an out-of-stock item is excluded). MANDATORY AGENT INSTRUCTIONS: 1. Always inform the user of available in-stock sizes, shipping SLA, and return policy for each item. Format negative return days as 'Exchange only |X| days' (e.g. -7 -> 'Exchange only 7 days'). 2. When shortlisting a look, render the product specifications table (Fabric, Pattern, Collar, Sleeves, Fit, Care). 3. Provide the clean base link (https://s.polopan.com/p/{handle}) during browsing/shortlisting. Provide direct 1-click checkout link (https://s.polopan.com/p/{handle}/{size_index}) ONLY after the user's size is finalized.

  after · 42% of words in common

  Discover complete curated fashion looks styled for specific occasions (e.g., 'Wedding & Reception', 'Party', 'Casual', 'Cocktail', 'Date Night', 'Club Night', 'Brunch', 'Vacation', 'Formal'). All returned looks are verified 100% in-stock (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 each item (Negative return days = 'Exchange only |X| days'). 2. When shortlisting a look, render the product specifications table (Fabric, Pattern, Collar, Sleeves, Fit, Care). 3. Provide the clean base link (https://s.polopan.com/p/{handle}) during browsing. Provide direct 1-click checkout link (https://s.polopan.com/p/{handle}/{size_index}) ONLY after the user's size is finalized.

• 2026-10-14vision.outfit.detect_pieceschangeddescription, input schemameaning changed
  before

  Deconstruct an outfit image or photo into individual fashion pieces (e.g. Upper-body garment, Lower-body garment, Dress, Footwear, Bag, Headwear) with bounding box coordinates and confidence scores. Use this to break down full-body look photos and search for matching catalog items for each piece individually.

  after · 24% of words in common

  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 to segment a full outfit into pieces before querying, NOT to directly retrieve catalog search results. - Distinct from 'looks.curation.recommend': Use this tool for image-based piece decomposition, 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 piece 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.

• 2026-10-14products.search.image_uploadchangeddescription, input schemameaning changed
  before

  Upload a local image file (or base64 string) and search PoloPan products using the uploaded image URL. Returns products with available in-stock sizes, pricing, and verified purchase URLs (https://s.polopan.com/p/{handle}).

  after · 15% of words in common

  Upload a local image file (or base64 string) and search PoloPan catalog products using visual image 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.

• 2026-10-14products.search.image_urlchangeddescription, input schemameaning changed
  before

  Search PoloPan products using image_url and optional filters. Returns products with available in-stock sizes, pricing, and verified purchase URLs (https://s.polopan.com/p/{handle}).

  after · 12% of words in common

  Search PoloPan catalog products using visual image similarity from a publicly accessible image URL with optional multi-attribute filters. Returns visually similar products with available 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 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.

Showing the latest 10. Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.