PoloPan Products MCP

PoloPan product search and outfits as a Model Context Protocol server.

There are two ways to run it:

| Mode | Use when | |------|-----------| | Hosted (recommended) | You use Cursor (or any MCP client) and want zero local Node setup. | | npm / stdio | You want the CLI binary locally (npx) or are developing the stdio server. |

Server-side implementation for production traffic also lives in the mono-repo at
api/cloudrun/mcp_products_service/ (Google Cloud Run). The npm package polopan-products-mcp is the stdio variant published to the registry.

Hosted MCP (Cursor)

Endpoint: https://mcp-server.polopan.com/mcp

Add to ~/.cursor/mcp.json:

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

Reload MCP in Cursor after saving.

npm package (local stdio)

Published as polopan-products-mcp.

npx -y polopan-products-mcp

Or clone this repo / open the mcp/ package:

npm install
npm start

Cursor can point stdio at the binary:

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

You do not have to publish a new npm version when you only change Cloud Run—only when you change mcp/src or stdio behaviour.

Publishing a new npm version (maintainers)

From this mcp/ directory:

1. Bump "version" in package.json.
2. npm publish (npm login required; package is public).

Requirements

• Node.js 18+
• Network access to https://apiv2.polopan.com (tools call that API)

Tools

• search_products_text — text search
• search_products_image — search by image URL
• search_products_image_upload — upload image then search
• get_product_by_handle — product by handle
• search_alternatives_in_budget — similar items in a budget band
• get_recommended_outfits — /looks style recommendations

GitHub documentation repo

User-facing setup and prompts for github.com/rofoso-com/mcp should stay in sync with the Hosted MCP section above (HTTP URL + Cursor JSON).
Copy the hosted snippet into that repo’s README so manual installers see mcp-server.polopan.com first; keep npx as an optional fallback.