MCPサーバー

PoloPan Fashion MCP Server

io.github.rofoso-com/mcp
コマース・小売 公開・接続可能 MCP 2025-11-25

このMCPでできること

Searches and recommends in-stock fashion products and outfits by text or image, verifies sizes and policies, and provides purchase links.

checkout.links.get_direct_url
Get Direct Checkout URL
Generate the direct 1-click checkout purchase URL for a specific product and size index (https://s.polopan.com/p/{handle}/{size_index}). 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}.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['handle'], 'properties': {'size': {'type': 'string', 'description': "Size label confirmed by the user (e.g. 'M', 'L', 'XL')"}, 'coupon': {'type': 'string', 'description': 'Optional discount coupon code to pre-apply'}, 'handle': {'type': 'string', 'minLength': 1, 'description': 'Unique product handle identifier'}, 'quantity': {'type': 'integer', 'default': 1, 'maximum': 10, 'minimum': 1, 'description': 'Number of units to purchase (1-10)'}, 'size_index': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Zero-based index of the chosen size variant'}}}
出力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['handle', 'size_index', 'checkout_url'], 'properties': {'size': {'type': 'string', 'description': 'Selected size'}, 'handle': {'type': 'string', 'description': 'Product handle'}, 'size_index': {'type': 'number', 'description': 'Selected size index'}, 'checkout_url': {'type': 'string', 'description': 'Direct 1-click purchase permalink (https://s.polopan.com/p/{handle}/{size_index})'}}, 'additionalProperties': False}
looks.curation.by_occasion
Get Looks 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 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.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'age': {'type': 'integer', 'default': 25, 'maximum': 99, 'minimum': 16, 'description': 'Target demographic age'}, 'page': {'type': 'integer', 'default': 1, 'maximum': 1000, 'minimum': 1, 'description': 'Page number for looks pagination'}, 'gender': {'enum': ['women', 'men', 'female', 'male'], 'type': 'string', 'default': 'women', 'description': "Target gender filter: 'women' or 'men'"}, 'vendor': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Optional brand filter'}, 'occasion': {'type': 'string', 'description': "Target occasion or vibe: 'Wedding & Reception', 'Party', 'Casual', 'Cocktail', 'Date Night', 'Club Night', 'Brunch', 'Vacation', 'Formal'"}, 'page_size': {'type': 'integer', 'default': 10, 'maximum': 100, 'minimum': 1, 'description': 'Number of looks per page'}}}
出力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['looks'], 'properties': {'looks': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Unique look ID'}, 'title': {'type': 'string', 'description': 'Look title'}, 'occasion': {'type': 'string', 'description': 'Occasion tag'}, 'products': {'type': 'array', 'items': {'type': 'object', 'required': ['handle', 'title', 'price', 'url'], 'properties': {'url': {'type': 'string', 'description': 'Purchase link'}, 'price': {'type': 'number', 'description': 'Price'}, 'title': {'type': 'string', 'description': 'Product title'}, 'handle': {'type': 'string', 'description': 'Product handle'}}, 'additionalProperties': False}, 'description': '100% in-stock items in this outfit'}, 'image_url': {'type': 'string', 'description': 'Main styled look image'}}, 'additionalProperties': False}, 'description': 'List of verified in-stock occasion looks'}}, 'additionalProperties': False}
looks.curation.recommend
Get Recommended Outfits
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.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'page': {'type': 'integer', 'default': 1, 'maximum': 1000, 'minimum': 1, 'description': 'Page number for pagination'}, 'gender': {'enum': ['women', 'men', 'female', 'male'], 'type': 'string', 'default': 'women', 'description': "Target gender filter: 'women' or 'men'"}, 'handle': {'type': 'string', 'description': 'Product handle to build coordinating outfits around'}, 'occasion': {'type': 'string', 'description': "Target occasion or aesthetic theme (e.g. 'Wedding', 'Party', 'Cocktail', 'Date Night')"}, 'page_size': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Number of outfits per page'}}}
出力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'looks': {'type': 'array', 'items': {'type': 'object', 'properties': {'title': {'type': 'string', 'description': 'Outfit title'}, 'image_url': {'type': 'string', 'description': 'Look image URL'}}, 'additionalProperties': False}, 'description': 'List of recommended outfits'}, 'handle': {'type': 'string', 'description': 'Base product handle'}}, 'additionalProperties': False}
products.items.check_stock
Check Live Variant Stock, Product Details & Sizing
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.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['handle'], 'properties': {'handle': {'type': 'string', 'minLength': 1, 'description': 'Unique product handle identifier'}, 'size_index': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Zero-based index of the size variant'}, 'desired_size': {'type': 'string', 'description': "Optional size query to verify (e.g. 'M', 'L', 'XL', '32', '40')"}}}
出力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['handle', 'title', 'is_in_stock', 'available_sizes', 'out_of_stock_sizes', 'direct_checkout_url'], 'properties': {'title': {'type': 'string', 'description': 'Product title'}, 'handle': {'type': 'string', 'description': 'Product handle'}, 'is_in_stock': {'type': 'boolean', 'description': 'Overall stock status'}, 'available_sizes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'List of currently available in-stock sizes'}, 'out_of_stock_sizes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'List of out-of-stock sizes'}, 'direct_checkout_url': {'type': 'string', 'description': 'Verified 1-click checkout permalink'}}, 'additionalProperties': False}
products.items.get_by_handle
Get Product By Handle
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}).
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['handle'], 'properties': {'handle': {'type': 'string', 'minLength': 1, 'description': "Unique product handle identifier (e.g. 'solid-linen-shirt')"}}}
出力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['handle', 'title', 'price', 'url'], 'properties': {'url': {'type': 'string', 'description': 'Verified purchase link'}, 'price': {'type': 'number', 'description': 'Price'}, 'title': {'type': 'string', 'description': 'Product title'}, 'handle': {'type': 'string', 'description': 'Product handle identifier'}, 'variants': {'type': 'array', 'items': {'type': 'object', 'required': ['size', 'in_stock'], 'properties': {'size': {'type': 'string', 'description': 'Size label'}, 'in_stock': {'type': 'boolean', 'description': 'Stock availability'}}, 'additionalProperties': False}, 'description': 'Variant size list'}}, 'additionalProperties': False}
products.search.alternatives
Search Alternatives In Budget
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).
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['handle'], 'properties': {'page': {'type': 'integer', 'default': 1, 'maximum': 1000, 'minimum': 1, 'description': 'Page number for pagination'}, 'limit': {'type': 'integer', 'default': 6, 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of filtered alternatives to return'}, 'handle': {'type': 'string', 'minLength': 1, 'description': 'Base product handle to find alternatives for'}, 'sort_by': {'enum': ['relevance', 'price', 'title'], 'type': 'string', 'default': 'relevance', 'description': 'Sorting criteria'}, 'page_size': {'type': 'integer', 'default': 8, 'maximum': 100, 'minimum': 1, 'description': 'Number of items to fetch per page'}, 'sort_order': {'enum': ['asc', 'desc'], 'type': 'string', 'default': 'desc', 'description': "Sort order: 'asc' or 'desc'"}, 'personalize': {'type': 'boolean', 'default': False, 'description': 'Whether to apply personalized ranking'}, 'budget_range': {'enum': ['0-1500', '1501-3000', '3001-5000', '5000+'], 'type': 'string', 'default': '1501-3000', 'description': 'Target price bracket in local currency'}}}
出力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['budget_range', 'source_handle', 'products'], 'properties': {'products': {'type': 'array', 'items': {'type': 'object', 'required': ['handle', 'title', 'price', 'url'], 'properties': {'url': {'type': 'string', 'description': 'Purchase link'}, 'price': {'type': 'number', 'description': 'Alternative product price'}, 'title': {'type': 'string', 'description': 'Alternative product title'}, 'handle': {'type': 'string', 'description': 'Alternative product handle'}}, 'additionalProperties': False}, 'description': 'List of visual alternatives within budget'}, 'budget_range': {'type': 'string', 'description': 'Applied budget bracket'}, 'source_handle': {'type': 'string', 'description': 'Source product handle'}}, 'additionalProperties': False}
products.search.image_upload
Search Products By Uploaded Image
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}).
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'page': {'type': 'integer', 'default': 1, 'maximum': 1000, 'minimum': 1, 'description': 'Page number for pagination'}, 'size': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Array of sizes to filter by'}, 'gender': {'type': 'string', 'description': 'Target gender filter'}, 'vendor': {'type': 'array', 'items': {'type': 'string'}, 'description': 'List of brand names'}, 'sort_by': {'enum': ['relevance', 'price', 'title'], 'type': 'string', 'default': 'relevance', 'description': 'Sorting criteria'}, 'page_size': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Number of items to return per page'}, 'price_max': {'type': 'number', 'description': 'Maximum price'}, 'price_min': {'type': 'number', 'description': 'Minimum price'}, 'image_path': {'type': 'string', 'minLength': 1, 'description': 'Local file system path to the image file'}, 'sort_order': {'enum': ['asc', 'desc'], 'type': 'string', 'default': 'desc', 'description': "Sort order: 'asc' or 'desc'"}, 'personalize': {'type': 'boolean', 'default': False, 'description': 'Whether to personalize search ranking'}, 'content_type': {'type': 'string', 'default': 'image/jpeg', 'description': "MIME type of the image, e.g. 'image/jpeg', 'image/png'"}, 'expiry_hours': {'type': 'integer', 'default': 24, 'maximum': 168, 'minimum': 1, 'description': 'Temporary upload URL lifetime in hours'}, 'image_base64': {'type': 'string', 'minLength': 1, 'description': 'Base64-encoded image data string'}}}
出力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['uploaded_image_url', 'products'], 'properties': {'products': {'type': 'array', 'items': {'type': 'object', 'required': ['handle', 'title', 'price', 'url'], 'properties': {'url': {'type': 'string', 'description': 'Purchase link'}, 'price': {'type': 'number', 'description': 'Price'}, 'title': {'type': 'string', 'description': 'Product title'}, 'handle': {'type': 'string', 'description': 'Product handle'}}, 'additionalProperties': False}, 'description': 'Matching products'}, 'uploaded_image_url': {'type': 'string', 'description': 'Temporary URL of the uploaded image'}}, 'additionalProperties': False}
products.search.image_url
Search Products By Image URL
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}).
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['image_url'], 'properties': {'page': {'type': 'integer', 'default': 1, 'maximum': 1000, 'minimum': 1, 'description': 'Page number for pagination'}, 'size': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Array of sizes to filter by'}, 'gender': {'type': 'string', 'description': "Target gender filter: 'men', 'women', or 'unisex'"}, 'vendor': {'type': 'array', 'items': {'type': 'string'}, 'description': 'List of brand names to filter by'}, 'sort_by': {'enum': ['relevance', 'price', 'title'], 'type': 'string', 'default': 'relevance', 'description': 'Sorting criteria for search results'}, 'image_url': {'type': 'string', 'format': 'uri', 'description': 'Publicly accessible URL of the fashion image to search for visual matches'}, 'page_size': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Number of items to return per page'}, 'price_max': {'type': 'number', 'description': 'Maximum price in local currency'}, 'price_min': {'type': 'number', 'description': 'Minimum price in local currency'}, 'sort_order': {'enum': ['asc', 'desc'], 'type': 'string', 'default': 'desc', 'description': "Sort order: 'asc' or 'desc'"}, 'personalize': {'type': 'boolean', 'default': False, 'description': 'Whether to apply personalized ranking'}}}
出力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['products'], 'properties': {'products': {'type': 'array', 'items': {'type': 'object', 'required': ['handle', 'title', 'price', 'url'], 'properties': {'url': {'type': 'string', 'description': 'Verified purchase link'}, 'price': {'type': 'number', 'description': 'Current selling price'}, 'title': {'type': 'string', 'description': 'Product name and title'}, 'handle': {'type': 'string', 'description': 'Unique product handle identifier'}}, 'additionalProperties': False}, 'description': 'List of matching fashion products'}}, 'additionalProperties': False}
products.search.text
Search Products By Text
Search PoloPan products using a text query and optional filters. Returns products with available in-stock sizes, specifications table, shipping/return policies, pricing, and verified purchase URLs (https://s.polopan.com/p/{handle}). MANDATORY AGENT INSTRUCTIONS: 1. Always tell the user the available sizes for items, 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.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'page': {'type': 'integer', 'default': 1, 'maximum': 1000, 'minimum': 1, 'description': 'Page number for pagination (starts at 1)'}, 'size': {'type': 'array', 'items': {'type': 'string'}, 'description': "Array of sizes to filter by, e.g. ['S', 'M', 'L', 'XL']"}, 'query': {'type': 'string', 'minLength': 1, 'description': "The search query or style keyword to find fashion items (e.g. 'black leather jacket', 'floral summer midi dress')"}, 'gender': {'type': 'string', 'description': "Target gender filter: 'men', 'women', or 'unisex'"}, 'vendor': {'type': 'array', 'items': {'type': 'string'}, 'description': 'List of brand or vendor names to filter by'}, 'sort_by': {'enum': ['relevance', 'price', 'title'], 'type': 'string', 'default': 'relevance', 'description': 'Sorting criteria for the search results'}, 'page_size': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Number of items to return per page (max 100)'}, 'price_max': {'type': 'number', 'description': 'Maximum price in local currency'}, 'price_min': {'type': 'number', 'description': 'Minimum price in local currency'}, 'sort_order': {'enum': ['asc', 'desc'], 'type': 'string', 'default': 'desc', 'description': "Sort order: 'asc' for ascending, 'desc' for descending"}}}
出力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['products'], 'properties': {'products': {'type': 'array', 'items': {'type': 'object', 'required': ['handle', 'title', 'price', 'url'], 'properties': {'mrp': {'type': 'number', 'description': 'Original maximum retail price'}, 'url': {'type': 'string', 'description': 'Verified purchase link'}, 'brand': {'type': 'string', 'description': 'Brand or vendor name'}, 'price': {'type': 'number', 'description': 'Current selling price'}, 'sizes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'List of available in-stock sizes'}, 'title': {'type': 'string', 'description': 'Product name and title'}, 'handle': {'type': 'string', 'description': 'Unique product handle identifier'}, 'discount_percent': {'type': 'number', 'description': 'Discount percentage'}}, 'additionalProperties': False}, 'description': 'List of matching fashion products'}, 'pagination': {'type': 'object', 'required': ['page', 'page_size'], 'properties': {'page': {'type': 'number', 'description': 'Current page number'}, 'total': {'type': 'number', 'description': 'Total number of matching products'}, 'page_size': {'type': 'number', 'description': 'Number of items per page'}}, 'description': 'Pagination metadata', 'additionalProperties': False}}, 'additionalProperties': False}
vision.outfit.detect_pieces
Detect Fashion Pieces & Bounding Boxes
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.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'image_url': {'type': 'string', 'format': 'uri', 'description': 'Public HTTP(S) URL of the fashion image to deconstruct'}, 'threshold': {'type': 'number', 'default': 0.22, 'maximum': 0.95, 'minimum': 0.05, 'description': 'Confidence threshold for object detection bounding boxes (0.05 to 0.95)'}, 'image_path': {'type': 'string', 'minLength': 1, 'description': 'Local path to the outfit image file to deconstruct'}, 'image_base64': {'type': 'string', 'minLength': 1, 'description': 'Base64-encoded image string for outfit piece detection'}}}
出力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['pieces'], 'properties': {'pieces': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'confidence', 'box'], 'properties': {'box': {'type': 'array', 'items': {'type': 'number'}, 'description': 'Normalized bounding box coordinates [ymin, xmin, ymax, xmax]'}, 'label': {'type': 'string', 'description': 'Detected clothing category (e.g. Upper-body garment, Lower-body garment, Footwear, Bag)'}, 'confidence': {'type': 'number', 'description': 'Confidence score between 0.0 and 1.0'}}, 'additionalProperties': False}, 'description': 'List of detected fashion pieces'}}, 'additionalProperties': False}
追加
looks.curation.recommend
2026年9月26日2:40
追加
products.search.alternatives
2026年9月26日2:40
追加
checkout.links.get_direct_url
2026年9月26日2:40
追加
products.items.check_stock
2026年9月26日2:40
追加
products.items.get_by_handle
2026年9月26日2:40
追加
looks.curation.by_occasion
2026年9月26日2:40
追加
vision.outfit.detect_pieces
2026年9月26日2:40
追加
products.search.image_upload
2026年9月26日2:40
追加
products.search.image_url
2026年9月26日2:40
追加
products.search.text
2026年9月26日2:40