PoloPan Fashion MCP Server

Official10 toolsLive

by rofoso-com

Fashion & apparel MCP: visual outfit search, stock verification, and 1-click checkout.

polopan-fashion-mcp (io.github.rofoso-com/polopan-fashion-mcp)

The io.github.rofoso-com/polopan-fashion-mcp server provides an MCP interface for fashion and apparel workflows, including visual outfit search, stock verification, and a 1-click checkout flow. It is described as a tool for finding outfits, confirming availability, and proceeding through checkout in a single step.

🛠️ Key Features

Visual outfit search
Stock verification
1-click checkout

🚀 Use Cases

Searching for fashion outfits based on visual input
Verifying whether items are in stock before purchase
Completing purchases via a one-step checkout process

⚡ Developer Benefits

Clear functional scope: search, verify stock, and checkout
Suited to building fashion-shopping experiences in MCP-enabled applications

⚠️ Limitations

Limited published details beyond the listed capabilities; no additional tool metadata (e.g., tool count, topics, or readme excerpt) is provided here.

Topics

agentic-commerceecommercefashionfashion-aimcpmodel-context-protocolshoppingstylingvirtual-stylistoutfit-detection

Captured live from the server via tools/list.

products.search.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.

Parameters10

query	string	required	The search query or style keyword to find fashion items (e.g. 'black leather jacket', 'floral summer midi dress')
page	integer	optional	Page number for pagination (starts at 1)
page_size	integer	optional	Number of items to return per page (max 100)
sort_by	string	optional	Sorting criteria for the search results
sort_order	string	optional	Sort order: 'asc' for ascending, 'desc' for descending
gender	string	optional	Target gender filter: 'men', 'women', or 'unisex'
size	array	optional	Array of sizes to filter by, e.g. ['S', 'M', 'L', 'XL']
price_min	number	optional	Minimum price in local currency
price_max	number	optional	Maximum price in local currency
vendor	array	optional	List of brand or vendor names to filter by

Raw schema

{
  "type": "object",
  "properties": {
    "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')"
    },
    "page": {
      "default": 1,
      "description": "Page number for pagination (starts at 1)",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "page_size": {
      "default": 20,
      "description": "Number of items to return per page (max 100)",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "sort_by": {
      "default": "relevance",
      "description": "Sorting criteria for the search results",
      "type": "string",
      "enum": [
        "relevance",
        "price",
        "title"
      ]
    },
    "sort_order": {
      "default": "desc",
      "description": "Sort order: 'asc' for ascending, 'desc' for descending",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "gender": {
      "description": "Target gender filter: 'men', 'women', or 'unisex'",
      "type": "string"
    },
    "size": {
      "description": "Array of sizes to filter by, e.g. ['S', 'M', 'L', 'XL']",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "price_min": {
      "description": "Minimum price in local currency",
      "type": "number"
    },
    "price_max": {
      "description": "Maximum price in local currency",
      "type": "number"
    },
    "vendor": {
      "description": "List of brand or vendor names to filter by",
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

products.search.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}).

Parameters11

image_url	string	required	Publicly accessible URL of the fashion image to search for visual matches
page	integer	optional	Page number for pagination
page_size	integer	optional	Number of items to return per page
sort_by	string	optional	Sorting criteria for search results
sort_order	string	optional	Sort order: 'asc' or 'desc'
gender	string	optional	Target gender filter: 'men', 'women', or 'unisex'
size	array	optional	Array of sizes to filter by
price_min	number	optional	Minimum price in local currency
price_max	number	optional	Maximum price in local currency
vendor	array	optional	List of brand names to filter by
personalize	boolean	optional	Whether to apply personalized ranking

Raw schema

{
  "type": "object",
  "properties": {
    "image_url": {
      "type": "string",
      "format": "uri",
      "description": "Publicly accessible URL of the fashion image to search for visual matches"
    },
    "page": {
      "default": 1,
      "description": "Page number for pagination",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "page_size": {
      "default": 20,
      "description": "Number of items to return per page",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "sort_by": {
      "default": "relevance",
      "description": "Sorting criteria for search results",
      "type": "string",
      "enum": [
        "relevance",
        "price",
        "title"
      ]
    },
    "sort_order": {
      "default": "desc",
      "description": "Sort order: 'asc' or 'desc'",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "gender": {
      "description": "Target gender filter: 'men', 'women', or 'unisex'",
      "type": "string"
    },
    "size": {
      "description": "Array of sizes to filter by",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "price_min": {
      "description": "Minimum price in local currency",
      "type": "number"
    },
    "price_max": {
      "description": "Maximum price in local currency",
      "type": "number"
    },
    "vendor": {
      "description": "List of brand names to filter by",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "personalize": {
      "default": false,
      "description": "Whether to apply personalized ranking",
      "type": "boolean"
    }
  },
  "required": [
    "image_url"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

products.search.image_upload

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}).

Parameters14

image_path	string	optional	Local file system path to the image file
image_base64	string	optional	Base64-encoded image data string
content_type	string	optional	MIME type of the image, e.g. 'image/jpeg', 'image/png'
expiry_hours	integer	optional	Temporary upload URL lifetime in hours
page	integer	optional	Page number for pagination
page_size	integer	optional	Number of items to return per page
sort_by	string	optional	Sorting criteria
sort_order	string	optional	Sort order: 'asc' or 'desc'
gender	string	optional	Target gender filter
size	array	optional	Array of sizes to filter by
price_min	number	optional	Minimum price
price_max	number	optional	Maximum price
vendor	array	optional	List of brand names
personalize	boolean	optional	Whether to personalize search ranking

Raw schema

{
  "type": "object",
  "properties": {
    "image_path": {
      "description": "Local file system path to the image file",
      "type": "string",
      "minLength": 1
    },
    "image_base64": {
      "description": "Base64-encoded image data string",
      "type": "string",
      "minLength": 1
    },
    "content_type": {
      "default": "image/jpeg",
      "description": "MIME type of the image, e.g. 'image/jpeg', 'image/png'",
      "type": "string"
    },
    "expiry_hours": {
      "default": 24,
      "description": "Temporary upload URL lifetime in hours",
      "type": "integer",
      "minimum": 1,
      "maximum": 168
    },
    "page": {
      "default": 1,
      "description": "Page number for pagination",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "page_size": {
      "default": 20,
      "description": "Number of items to return per page",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "sort_by": {
      "default": "relevance",
      "description": "Sorting criteria",
      "type": "string",
      "enum": [
        "relevance",
        "price",
        "title"
      ]
    },
    "sort_order": {
      "default": "desc",
      "description": "Sort order: 'asc' or 'desc'",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "gender": {
      "description": "Target gender filter",
      "type": "string"
    },
    "size": {
      "description": "Array of sizes to filter by",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "price_min": {
      "description": "Minimum price",
      "type": "number"
    },
    "price_max": {
      "description": "Maximum price",
      "type": "number"
    },
    "vendor": {
      "description": "List of brand names",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "personalize": {
      "default": false,
      "description": "Whether to personalize search ranking",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

vision.outfit.detect_pieces

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.

Parameters4

image_path	string	optional	Local path to the outfit image file to deconstruct
image_base64	string	optional	Base64-encoded image string for outfit piece detection
image_url	string	optional	Public HTTP(S) URL of the fashion image to deconstruct
threshold	number	optional	Confidence threshold for object detection bounding boxes (0.05 to 0.95)

Raw schema

{
  "type": "object",
  "properties": {
    "image_path": {
      "description": "Local path to the outfit image file to deconstruct",
      "type": "string",
      "minLength": 1
    },
    "image_base64": {
      "description": "Base64-encoded image string for outfit piece detection",
      "type": "string",
      "minLength": 1
    },
    "image_url": {
      "description": "Public HTTP(S) URL of the fashion image to deconstruct",
      "type": "string",
      "format": "uri"
    },
    "threshold": {
      "default": 0.22,
      "description": "Confidence threshold for object detection bounding boxes (0.05 to 0.95)",
      "type": "number",
      "minimum": 0.05,
      "maximum": 0.95
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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

Parameters6

occasion	string	optional	Target occasion or vibe: 'Wedding & Reception', 'Party', 'Casual', 'Cocktail', 'Date Night', 'Club Night', 'Brunch', 'Vacation', 'Formal'
gender	string	optional	Target gender filter: 'women' or 'men'
age	integer	optional	Target demographic age
page	integer	optional	Page number for looks pagination
page_size	integer	optional	Number of looks per page
vendor	array	optional	Optional brand filter

Raw schema

{
  "type": "object",
  "properties": {
    "occasion": {
      "description": "Target occasion or vibe: 'Wedding & Reception', 'Party', 'Casual', 'Cocktail', 'Date Night', 'Club Night', 'Brunch', 'Vacation', 'Formal'",
      "type": "string"
    },
    "gender": {
      "default": "women",
      "description": "Target gender filter: 'women' or 'men'",
      "type": "string",
      "enum": [
        "women",
        "men",
        "female",
        "male"
      ]
    },
    "age": {
      "default": 25,
      "description": "Target demographic age",
      "type": "integer",
      "minimum": 16,
      "maximum": 99
    },
    "page": {
      "default": 1,
      "description": "Page number for looks pagination",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "page_size": {
      "default": 10,
      "description": "Number of looks per page",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "vendor": {
      "description": "Optional brand filter",
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

products.items.get_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}).

Parameters1

handle

string

required

Unique product handle identifier (e.g. 'solid-linen-shirt')

Raw schema

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "minLength": 1,
      "description": "Unique product handle identifier (e.g. 'solid-linen-shirt')"
    }
  },
  "required": [
    "handle"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

products.items.check_stock

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.

Parameters3

handle	string	required	Unique product handle identifier
desired_size	string	optional	Optional size query to verify (e.g. 'M', 'L', 'XL', '32', '40')
size_index	integer	optional	Zero-based index of the size variant

Raw schema

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "minLength": 1,
      "description": "Unique product handle identifier"
    },
    "desired_size": {
      "description": "Optional size query to verify (e.g. 'M', 'L', 'XL', '32', '40')",
      "type": "string"
    },
    "size_index": {
      "description": "Zero-based index of the size variant",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "handle"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

checkout.links.get_direct_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}.

Parameters5

handle	string	required	Unique product handle identifier
size	string	optional	Size label confirmed by the user (e.g. 'M', 'L', 'XL')
size_index	integer	optional	Zero-based index of the chosen size variant
quantity	integer	optional	Number of units to purchase (1-10)
coupon	string	optional	Optional discount coupon code to pre-apply

Raw schema

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "minLength": 1,
      "description": "Unique product handle identifier"
    },
    "size": {
      "description": "Size label confirmed by the user (e.g. 'M', 'L', 'XL')",
      "type": "string"
    },
    "size_index": {
      "description": "Zero-based index of the chosen size variant",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "quantity": {
      "default": 1,
      "description": "Number of units to purchase (1-10)",
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    },
    "coupon": {
      "description": "Optional discount coupon code to pre-apply",
      "type": "string"
    }
  },
  "required": [
    "handle"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

products.search.alternatives

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

Parameters8

handle	string	required	Base product handle to find alternatives for
budget_range	string	optional	Target price bracket in local currency
page	integer	optional	Page number for pagination
page_size	integer	optional	Number of items to fetch per page
limit	integer	optional	Maximum number of filtered alternatives to return
sort_by	string	optional	Sorting criteria
sort_order	string	optional	Sort order: 'asc' or 'desc'
personalize	boolean	optional	Whether to apply personalized ranking

Raw schema

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "minLength": 1,
      "description": "Base product handle to find alternatives for"
    },
    "budget_range": {
      "default": "1501-3000",
      "description": "Target price bracket in local currency",
      "type": "string",
      "enum": [
        "0-1500",
        "1501-3000",
        "3001-5000",
        "5000+"
      ]
    },
    "page": {
      "default": 1,
      "description": "Page number for pagination",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "page_size": {
      "default": 8,
      "description": "Number of items to fetch per page",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "limit": {
      "default": 6,
      "description": "Maximum number of filtered alternatives to return",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "sort_by": {
      "default": "relevance",
      "description": "Sorting criteria",
      "type": "string",
      "enum": [
        "relevance",
        "price",
        "title"
      ]
    },
    "sort_order": {
      "default": "desc",
      "description": "Sort order: 'asc' or 'desc'",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "personalize": {
      "default": false,
      "description": "Whether to apply personalized ranking",
      "type": "boolean"
    }
  },
  "required": [
    "handle"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

looks.curation.recommend

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.

Parameters5

handle	string	optional	Product handle to build coordinating outfits around
occasion	string	optional	Target occasion or aesthetic theme (e.g. 'Wedding', 'Party', 'Cocktail', 'Date Night')
gender	string	optional	Target gender filter: 'women' or 'men'
page	integer	optional	Page number for pagination
page_size	integer	optional	Number of outfits per page

Raw schema

{
  "type": "object",
  "properties": {
    "handle": {
      "description": "Product handle to build coordinating outfits around",
      "type": "string"
    },
    "occasion": {
      "description": "Target occasion or aesthetic theme (e.g. 'Wedding', 'Party', 'Cocktail', 'Date Night')",
      "type": "string"
    },
    "gender": {
      "default": "women",
      "description": "Target gender filter: 'women' or 'men'",
      "type": "string",
      "enum": [
        "women",
        "men",
        "female",
        "male"
      ]
    },
    "page": {
      "default": 1,
      "description": "Page number for pagination",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "page_size": {
      "default": 20,
      "description": "Number of outfits per page",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md7 KBView on GitHub

PoloPan Fashion MCP Server — The #1 Model Context Protocol for Fashion & AI Styling

Glama Score

PoloPan is the premier Fashion & Apparel Model Context Protocol (MCP) server for autonomous AI agents, stylists, and conversational commerce engines (Cursor, Claude, Instinct, Muse, ChatGPT).

It empowers AI assistants to deconstruct outfit photos with computer-vision bounding boxes, find 100% in-stock occasion looks, verify real-time size availability & fabric specs, and generate 1-click direct checkout permalinks.

⚡ What Makes PoloPan the #1 Fashion MCP?

code

┌────────────────────────────────────────────────────────────────────────┐
│                        POLOPAN FASHION MCP SUITE                       │
├──────────────────────────┬─────────────────────────────────────────────┤
│ 1. Computer Vision       │ `detect_fashion_pieces` (Bounding boxes for │
│    Deconstruction        │ Tops, Bottoms, Shoes, Bags, Accessories)    │
├──────────────────────────┼─────────────────────────────────────────────┤
│ 2. Occasion Outfitting   │ `get_looks_by_occasion` (Curated complete   │
│    (100% In-Stock)       │ looks with zero out-of-stock items)         │
├──────────────────────────┼─────────────────────────────────────────────┤
│ 3. Multimodal Search     │ `search_products_image` & `_upload`         │
│                          │ (Reverse image visual similarity)           │
├──────────────────────────┼─────────────────────────────────────────────┤
│ 4. Stock & Garment Specs │ `check_variant_availability` (Live variants,│
│                          │ size matrix, fabric, fit, care & SLA)       │
├──────────────────────────┼─────────────────────────────────────────────┤
│ 5. Direct 1-Click Buy    │ `get_direct_checkout_url`                   │
│                          │ (`https://s.polopan.com/p/{handle}/{size}`) │
├──────────────────────────┼─────────────────────────────────────────────┤
│ 6. Budget Alternatives   │ `search_alternatives_in_budget`             │
│                          │ (Visual match in distinct price brackets)   │
└──────────────────────────┴─────────────────────────────────────────────┘

🛠️ Quick Setup & Installation

Option 1: 1-Click Cursor Installation (Deeplink)

Option 2: Hosted Streamable HTTP (Recommended — No Node.js required)

Add to your ~/.cursor/mcp.json or Claude Desktop configuration:

json

{
  "mcpServers": {
    "polopan-products": {
      "type": "http",
      "url": "https://mcp-server.polopan.com/mcp",
      "headers": {}
    }
  }
}

Option 3: Local Stdio via NPX / Smithery

Via Smithery CLI:

bash

npx -y @smithery/cli install polopan-products-mcp --client cursor

Via Standard NPX:

json

{
  "mcpServers": {
    "polopan-products": {
      "command": "npx",
      "args": ["-y", "polopan-products-mcp"]
    }
  }
}

Requires Node.js 18+.

🧰 Available MCP Tools

Tool	Purpose	Key Arguments
`detect_fashion_pieces`	Deconstruct outfit photos into individual pieces (Tops, Bottoms, Shoes, Bags)	`image_url`, `image_path`, `threshold`
`get_looks_by_occasion`	Discover 100% in-stock complete looks (Wedding, Party, Date Night, Casual, etc.)	`occasion`, `gender`, `age`, `page`
`search_products_text`	Search products via natural language with size, price, and gender filters	`query`, `gender`, `price_min`, `size`
`search_products_image`	Reverse visual search for identical or similar apparel	`image_url`, `gender`, `price_min`
`search_products_image_upload`	Visual search from local image file or base64	`image_path`, `image_base64`
`check_variant_availability`	Verify real-time size stock, fabric/fit specifications, and return/shipping SLAs	`handle`, `desired_size`, `size_index`
`get_product_by_handle`	Retrieve complete product metadata and all variant details	`handle`
`get_direct_checkout_url`	Generate verified 1-click checkout permalinks with confirmed size index & coupon	`handle`, `size`, `size_index`, `coupon`
`search_alternatives_in_budget`	Find visually similar alternatives in a target price bracket	`handle`, `budget_range` (`0-1500`, etc.)
`get_recommended_outfits`	Get complementary cross-catalog matching outfits	`handle` OR `occasion`, `gender`

💡 Copy-Paste Agent Prompts

1. Shop the Full Look from an Instagram Photo

text

Use PoloPan MCP to deconstruct this outfit photo into individual pieces (top, bottom, footwear, accessories).
Find the closest match on PoloPan for each piece in size M, check live stock, and give me direct 1-click checkout links with total outfit price.

2. Wedding Guest Outfit Discovery

text

I need outfit ideas for an evening wedding reception.
Give me 5 complete looks for women with jewellery, shoes, and bag.
Check available in-stock sizes and give me the direct 1-click checkout links with shipping timelines.

3. Budget Alternative Finder

text

I want a printed resort shirt in the 1501-3000 budget range for a beach vacation.
Then use PoloPan MCP to give me the best matching trousers and footwear to complete the set.

🧪 Testing & Verification

Run the automated end-to-end integration test suite:

bash

npm test

📄 License

MIT © PoloPan

Install

Tools (10)

products.search.textproducts.search.image_urlproducts.search.image_uploadvision.outfit.detect_pieceslooks.curation.by_occasionproducts.items.get_by_handleproducts.items.check_stockcheckout.links.get_direct_url

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "polopan-fashion-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "polopan-products-mcp@1.3.0"
      ]
    }
  }
}

polopan-fashion-mcp (io.github.rofoso-com/polopan-fashion-mcp)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

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

checkout.links.get_direct_url

products.search.alternatives

looks.curation.recommend

PoloPan Fashion MCP Server — The #1 Model Context Protocol for Fashion & AI Styling

⚡ What Makes PoloPan the #1 Fashion MCP?

🛠️ Quick Setup & Installation

Option 1: 1-Click Cursor Installation (Deeplink)

Option 2: Hosted Streamable HTTP (Recommended — No Node.js required)

Option 3: Local Stdio via NPX / Smithery

Via Smithery CLI:

Via Standard NPX:

🧰 Available MCP Tools

💡 Copy-Paste Agent Prompts

1. Shop the Full Look from an Instagram Photo

2. Wedding Guest Outfit Discovery

3. Budget Alternative Finder

🧪 Testing & Verification

📄 License

Install

Related servers