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

Now available across 240+ destination countries and territories with localized pricing, real-time variant stock, persistent regional settings (~/.polopan/region.json), computer-vision outfit deconstruction, and 1-click checkout permalinks.

---

⚡ What Makes PoloPan the #1 Fashion MCP?

┌────────────────────────────────────────────────────────────────────────┐

│ POLOPAN FASHION MCP SUITE │ ├──────────────────────────┬─────────────────────────────────────────────┤ │ 1. 240+ Global Regions │ region.get_current, region.set_current │ │ & Localized Currencies│ (Persistent JSON, natural country lookup) │ ├──────────────────────────┼─────────────────────────────────────────────┤ │ 2. Computer Vision │ vision.outfit.detect_pieces (Bboxes for │ │ Deconstruction │ Tops, Bottoms, Shoes, Bags, Accessories) │ ├──────────────────────────┼─────────────────────────────────────────────┤ │ 3. Occasion Outfitting │ looks.curation.by_occasion (Curated │ │ (100% In-Stock) │ complete looks with zero out-of-stock items)│ ├──────────────────────────┼─────────────────────────────────────────────┤ │ 4. Multimodal Search │ products.search.image_url & _upload │ │ │ (Reverse image visual similarity) │ ├──────────────────────────┼─────────────────────────────────────────────┤ │ 5. Stock & Garment Specs │ products.items.check_stock (Live variants,│ │ │ size matrix, fabric, fit, care & SLA) │ ├──────────────────────────┼─────────────────────────────────────────────┤ │ 6. Size Guide & Fits │ products.items.get_size_guide (Chest, │ │ │ waist, hip matrix, in/cm, best-fit match) │ ├──────────────────────────┼─────────────────────────────────────────────┤ │ 7. Direct 1-Click Buy │ checkout.links.get_direct_url │ │ │ (https://s.polopan.com/p/{handle}/{size}) │ ├──────────────────────────┼─────────────────────────────────────────────┤ │ 8. Budget Alternatives │ products.search.alternatives │ │ │ (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

---

🌍 Persistent Multi-Country Shopping Flow

PoloPan delivers to 240+ countries and territories. To deliver a smooth, natural user experience:

1. Never repeatedly ask the user for their country: The server stores settings in ~/.polopan/region.json.
2. Natural location input: Users can provide country names, cities, currencies, or aliases (e.g. "Dubai", "London", "USA", "AED", "USD").
3. Change anytime: Users can say *"Switch my country to Canada"* or *"Show prices in GBP"* at any point.

---

🧪 Testing & Verification

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

npm test

---

📄 License

MIT © PoloPan