Mcp MCP Server

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

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?

┌────────────────────────────────────────────────────────────────────────┐
│                        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:

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

---

Option 3: Local Stdio via NPX / Smithery

Via Smithery CLI:

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

Via Standard NPX:

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

Requires Node.js 18+.

---

🧰 Available MCP Tools

---

💡 Copy-Paste Agent Prompts

1. Shop the Full Look from an Instagram Photo

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

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

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:

npm test

---

📄 License

MIT © PoloPan