PoloPan Fashion MCP Server

Get the currently active shopping destination country, currency code, symbol, phone code, and catalog scope mode from persistent local configuration (~/.polopan/region.json).

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.

Search the 240+ supported destination countries with localized currency codes, symbols, flags, phone codes, and price groups from live platform settings.

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 t

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.

List all saved customer delivery addresses stored in ~/.polopan/region.json, optionally filtered by country.

Set an existing address as the default shipping address for its country in ~/.polopan/region.json.

Delete a saved delivery address by ID from ~/.polopan/region.json.

Search PoloPan catalog products using a text keyword query with optional multi-attribute filters. Returns matching fashion items with available in-stock sizes, product specifications, shipping/return policies, discounted pricing, and verified purchase URLs (https://s.polopan.com/p/{handle}). Automatically localized to active country / 240+ destination regions. PURPOSE & DISAMBIGUATION: - Primary

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 usin

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 base6

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 c

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: -

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.

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 pri

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 me

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.polopa

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.sear

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