Skip to main content
Glama
rofoso-com

PoloPan Fashion MCP Server

by rofoso-com

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

Glama Score npm version npm downloads License: MIT Model Context Protocol Node.js Version

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)   │
└──────────────────────────┴─────────────────────────────────────────────┘

Related MCP server: dentro MCP

🛠️ Quick Setup & Installation

Install in Cursor


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

Tool

Purpose

Key Arguments

region.get_current

Inspect active shopping destination, localized currency, and config path

(none)

region.set_current

Set active region from natural names ("Dubai", "London", "USA", "France"), currency, or ISO-2. Saved to ~/.polopan/region.json.

country, mode (global/local)

region.list_supported

Search 240+ supported destination countries & price groups

query, limit

products.search.text

Search products via natural language with size, price, and gender filters

query, gender, price_min, size, country, mode

products.search.image_url

Reverse visual search for identical or similar apparel

image_url, gender, price_min, country, mode

products.search.image_upload

Visual search from local image file or base64

file_path, country, mode

vision.outfit.detect_pieces

Deconstruct outfit photos into individual pieces (Tops, Bottoms, Shoes, Bags)

image_url, threshold

looks.curation.by_occasion

Discover 100% in-stock complete looks (Wedding, Party, Date Night, Casual, etc.)

occasion, gender, age, country, mode, page

products.items.get_by_handle

Retrieve complete product metadata and all variant details

handle

products.items.get_size_guide

Full garment dimensions table (chest/waist/hip), unit conversion (in/cm), and fit matcher

handle, unit, desired_size, user_chest, user_waist

products.items.check_stock

Verify real-time size stock, fabric/fit specifications, and return/shipping SLAs

handle, desired_size, size_index

checkout.links.get_direct_url

Generate verified 1-click checkout permalinks with confirmed size index & coupon

handle, size, size_index, coupon

products.search.alternatives

Find visually similar alternatives in a target price bracket

handle, budget_range (0-1500, etc.), country, mode

looks.curation.recommend

Get complementary cross-catalog matching outfits

handle OR occasion, gender, country, mode


🌍 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

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    Provides structured commerce data for AI agents, enabling real-time product searches and brand discovery across 22,000+ DTC brands without scraping or hallucination.
    5
    16 npm
    MIT
  • A
    license
    B
    quality
    B
    maintenance
    Enables AI agents to automatically discover, extract, and retrieve verified high-resolution product images and product links from e-commerce sites via a universal extraction pipeline with pluggable search backends, caching, and CDN-aware upscaling.
    4
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI shopping agents to search products, check stock, apply promotions, manage cart sessions, and create cryptographically signed checkout sessions on e-commerce storefronts, while giving merchants analytics into agent intent and catalog demand gaps.
    MIT