PoloPan Fashion MCP Server
Fashion & apparel MCP: visual outfit search, stock verification, and 1-click checkout.
| Endpoint | https://mcp-server.polopan.com/mcp (streamable-http) |
|---|---|
| Registry version | 1.2.6 |
| Now | 19 tools · grade F (26) · pin ts_81b3190861f5cc9c23b5011b71758f1f · protocol 2025-06-18 |
| First / last listed | 2026-10-29 01:10 UTC / 2026-10-29 01:10 UTC |
| Grade over time | 2026-10-29: F (26), 19 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: region.get_current region.set_current region.list_supported address.get_current address.save address.list_saved address.set_default address.delete products.search.text products.search.image_url products.search.image_upload vision.outfit.detect_pieces looks.curation.by_occasion products.items.get_by_handle products.items.check_stock products.items.get_size_guide checkout.links.get_direct_url products.search.alternatives looks.curation.recommend
region.get_current | Get the currently active shopping destination country, currency code, symbol, phone code, and catalog scope mode from persistent local configuration (~/.polopan/region.json). params: none |
region.set_current | 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. params: country*, mode |
region.list_supported | Search the 240+ supported destination countries with localized currency codes, symbols, flags, phone codes, and price groups from live platform settings. params: query, limit |
address.get_current | 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 params: country |
address.save | 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. params: firstName*, lastName, address1*, address2, city*, province, zip*, country, phone, email, type, is_default, id, storage_mode |
address.list_saved | List all saved customer delivery addresses stored in ~/.polopan/region.json, optionally filtered by country. params: country |
address.set_default | Set an existing address as the default shipping address for its country in ~/.polopan/region.json. params: address_id* |
address.delete | Delete a saved delivery address by ID from ~/.polopan/region.json. params: address_id* |
products.search.text | 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 params: query*, country, mode, page, page_size, sort_by, sort_order, gender, size, price_min, price_max, vendor |
products.search.image_url | 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 params: image_url*, country, mode, page, page_size, sort_by, sort_order, gender, size, price_min, price_max, vendor, personalize |
products.search.image_upload | 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 params: image_path, image_base64, country, mode, content_type, expiry_hours, page, page_size, sort_by, sort_order, gender, size, price_min, price_max, vendor, personalize |
vision.outfit.detect_pieces | 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 params: image_path, image_base64, image_url, threshold |
looks.curation.by_occasion | 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:
- params: occasion, gender, country, mode, age, page, page_size, vendor |
products.items.get_by_handle | 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. params: handle*, country |
products.items.check_stock | 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 params: handle*, desired_size, size_index, country |
products.items.get_size_guide | 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 params: handle*, unit, desired_size, user_chest, user_waist, user_hip, user_unit |
checkout.links.get_direct_url | 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 params: handle*, size, size_index, quantity, coupon, address_id, address, country |
products.search.alternatives | 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 params: handle*, budget_range, country, mode, page, page_size, limit, sort_by, sort_order, personalize |
looks.curation.recommend | 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 params: handle, occasion, gender, country, mode, page, page_size |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.