PoloPan Fashion MCP Server

Official registry Search and web

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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code
claude mcp add --transport http polopan-fashion-mcp-server 'https://mcp-server.polopan.com/mcp/'
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "polopan-fashion-mcp-server": {
            "type": "http",
            "url": "https://mcp-server.polopan.com/mcp/"
        }
    }
}
NPM package polopan-products-mcp
Claude Code
claude mcp add polopan-fashion-mcp-server -- npx -y polopan-products-mcp@1.7.0
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "polopan-fashion-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "polopan-products-mcp@1.7.0"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. PoloPan Fashion MCP Server — The #1 Model Context Protocol for Fashion & AI Styling
  2. ⚡ What Makes PoloPan the #1 Fashion MCP?
  3. 🛠️ Quick Setup & Installation
  4. 🧰 Available MCP Tools
  5. 🌍 Persistent Multi-Country Shopping Flow
  6. 🧪 Testing & Verification
  7. 📄 License

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


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

ToolPurposeKey Arguments
region.get_currentInspect active shopping destination, localized currency, and config path(none)
region.set_currentSet active region from natural names ("Dubai", "London", "USA", "France"), currency, or ISO-2. Saved to ~/.polopan/region.json.country, mode (global/local)
region.list_supportedSearch 240+ supported destination countries & price groupsquery, limit
products.search.textSearch products via natural language with size, price, and gender filtersquery, gender, price_min, size, country, mode
products.search.image_urlReverse visual search for identical or similar apparelimage_url, gender, price_min, country, mode
products.search.image_uploadVisual search from local image file or base64file_path, country, mode
vision.outfit.detect_piecesDeconstruct outfit photos into individual pieces (Tops, Bottoms, Shoes, Bags)image_url, threshold
looks.curation.by_occasionDiscover 100% in-stock complete looks (Wedding, Party, Date Night, Casual, etc.)occasion, gender, age, country, mode, page
products.items.get_by_handleRetrieve complete product metadata and all variant detailshandle
products.items.get_size_guideFull garment dimensions table (chest/waist/hip), unit conversion (in/cm), and fit matcherhandle, unit, desired_size, user_chest, user_waist
products.items.check_stockVerify real-time size stock, fabric/fit specifications, and return/shipping SLAshandle, desired_size, size_index
checkout.links.get_direct_urlGenerate verified 1-click checkout permalinks with confirmed size index & couponhandle, size, size_index, coupon
products.search.alternativesFind visually similar alternatives in a target price brackethandle, budget_range (0-1500, etc.), country, mode
looks.curation.recommendGet complementary cross-catalog matching outfitshandle 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

Frequently asked questions

What is PoloPan Fashion MCP Server?

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

How do I install PoloPan Fashion MCP Server?

It runs as a remote server. In Claude Code: claude mcp add --transport http polopan-fashion-mcp-server 'https://mcp-server.polopan.com/mcp/'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does PoloPan Fashion MCP Server need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is PoloPan Fashion MCP Server open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains PoloPan Fashion MCP Server?

It is published by rofoso-com. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.