PoloPan Fashion MCP Server

What PoloPan Fashion MCP Server MCP server does

PoloPan Fashion MCP Server MCP server gives fashion-focused AI assistants access to PoloPan product discovery and purchasing workflows. It can break down an outfit image into categories such as tops, bottoms, shoes, bags, and accessories. Agents can then search the catalog using text, image similarity, or a local image upload.

The server also supports occasion-based outfit discovery for categories such as weddings, parties, date nights, and casual wear. Product tools expose metadata, variants, sizes, fabric and fit information, care details, and shipping or return service-level information where provided by the catalog. Checkout support generates direct links using a product handle, selected size, size index, and optional coupon.

How it works

PoloPan Fashion MCP Server MCP server can run as a hosted Streamable HTTP endpoint at https://mcp-server.polopan.com/mcp, or locally through the polopan-products-mcp npm package. An MCP client sends tool calls with inputs such as an image URL, image path, product handle, occasion, gender, size, or budget range. The server returns catalog results or product-related details for the assistant to use in its response.

Image workflows support both remote images and local or base64-encoded files. An agent can first detect clothing pieces, search for matching products, check a desired variant, and then request a direct checkout URL. Other workflows can start with an occasion, a text query, or an existing product handle to find complete or complementary outfits.

Setup and configuration

The hosted option requires no local Node.js installation. Add the HTTP endpoint to an MCP client configuration, such as Cursor or Claude Desktop:

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

For local stdio use, configure the client to run npx -y polopan-products-mcp. Smithery CLI installation is also documented with npx -y @smithery/cli install polopan-products-mcp --client cursor. A Cursor installation deeplink is available as another setup path.

Tools and capabilities

• detect_fashion_pieces: Identifies individual fashion pieces in an image using bounding-box detection.
• get_looks_by_occasion: Returns complete looks filtered by occasion, gender, age, and page.
• search_products_text: Searches products with natural-language, size, price, and gender filters.
• search_products_image and search_products_image_upload: Find identical or visually similar apparel from remote or local images.
• check_variant_availability: Checks size availability and product specifications for a handle.
• get_product_by_handle: Retrieves product metadata and variant details.
• get_direct_checkout_url: Creates a checkout permalink for a selected product variant.
• search_alternatives_in_budget: Finds visually similar products within a specified price range.
• get_recommended_outfits: Finds complementary outfits from a product handle or occasion and gender.

Limitations and notes

The documented interfaces focus on PoloPan’s fashion catalog and its product handles, variants, and checkout links. Local execution depends on Node.js 18 or newer. Availability and specification results depend on the data returned by the connected PoloPan service.