FindMine Shopping Stylist
About
Integrates with FindMine's product styling API to enable fashion recommendations, outfit creation, product browsing, and style guide access for e-commerce platforms.
Details
- Author
- findmine
- Repository
- findmine/findmine-mcp
- GitHub stars
- 1
- Downloads
- 1,067
- Categories
- AI, Design, Developer Tools, Search, API, Infrastructure, Frontend, Other
Jump to
- Provides product details via product:/// URIs and outfit recommendations via look:/// URIs.
- Offers three tools: get_style_guide, get_complete_the_look, and get_visually_similar.
- Includes three prompts: outfit_completion, styling_guide, and findmine_help.
- Supports configurable caching (enabled by default, 1‑hour TTL).
- Built with MCP SDK 1.24.2, Zod validation, and 100% test coverage on utilities.
- Fully customizable style guide content in src/content/style-guides.ts.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
FindMine Shopping StylistCommand (node, npx, python, etc.)npxArguments-
Argument 1
findmine-mcp
Environment-
NODE_ENV
- -
FINDMINE_APP_ID
DEMO_APP_ID -
FINDMINE_API_URL
https://api.findmine.com -
FINDMINE_API_VERSION
v3 -
FINDMINE_CACHE_TTL_MS
3600000 -
FINDMINE_CACHE_ENABLED
true -
FINDMINE_DEFAULT_REGION
us -
FINDMINE_DEFAULT_LANGUAGE
en
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
npx findmine-mcp
npm install -g findmine-mcp
findmine-mcp
npm install
| Variable | Description | Default |
|----------|-------------|---------|
| FINDMINE_API_URL | FindMine API base URL | https://api.findmine.com |
| FINDMINE_APP_ID | Your FindMine application ID | DEMO_APP_ID |
| FINDMINE_API_VERSION | API version to use | v3 |
| FINDMINE_DEFAULT_REGION | Default region code | us |
| FINDMINE_DEFAULT_LANGUAGE | Default language code | en |
| FINDMINE_CACHE_ENABLED | Enable response caching | true |
| FINDMINE_CACHE_TTL_MS | Cache time-to-live in ms | 3600000 (1 hour) |
| NODE_ENV | Set to "development" for sample data | - |
The server automatically configures Claude Desktop during installation. To verify:
macOS:
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows:
type %APPDATA%\Claude\claude_desktop_config.json
get_style_guide
Access detailed fashion advice and styling guidelines. Parameters: category (string), occasion (string)
get_complete_the_look
Get outfit recommendations for a product. Parameters: product_id (string), product_color_id (string)
get_visually_similar
Find visually similar products. Parameters: product_id (string), product_color_id (string), limit (integer)
- get_style_guide: Access detailed fashion advice and styling guidelines
- get_complete_the_look: Get outfit recommendations for a product
- get_visually_similar: Find visually similar products
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"findmine shopping stylist": {
"env": {
"NODE_ENV": "-",
"FINDMINE_APP_ID": "DEMO_APP_ID",
"FINDMINE_API_URL": "https://api.findmine.com",
"FINDMINE_API_VERSION": "v3",
"FINDMINE_CACHE_TTL_MS": "3600000",
"FINDMINE_CACHE_ENABLED": "true",
"FINDMINE_DEFAULT_REGION": "us",
"FINDMINE_DEFAULT_LANGUAGE": "en"
},
"args": [
"findmine-mcp"
],
"command": "npx"
}
}
}Linux
{
"env": {
"NODE_ENV": "-",
"FINDMINE_APP_ID": "DEMO_APP_ID",
"FINDMINE_API_URL": "https://api.findmine.com",
"FINDMINE_API_VERSION": "v3",
"FINDMINE_CACHE_TTL_MS": "3600000",
"FINDMINE_CACHE_ENABLED": "true",
"FINDMINE_DEFAULT_REGION": "us",
"FINDMINE_DEFAULT_LANGUAGE": "en"
},
"args": [
"findmine-mcp"
],
"command": "npx"
}Macos
{
"env": {
"NODE_ENV": "-",
"FINDMINE_APP_ID": "DEMO_APP_ID",
"FINDMINE_API_URL": "https://api.findmine.com",
"FINDMINE_API_VERSION": "v3",
"FINDMINE_CACHE_TTL_MS": "3600000",
"FINDMINE_CACHE_ENABLED": "true",
"FINDMINE_DEFAULT_REGION": "us",
"FINDMINE_DEFAULT_LANGUAGE": "en"
},
"args": [
"findmine-mcp"
],
"command": "npx"
}Windows
{
"env": {
"NODE_ENV": "-",
"FINDMINE_APP_ID": "DEMO_APP_ID",
"FINDMINE_API_URL": "https://api.findmine.com",
"FINDMINE_API_VERSION": "v3",
"FINDMINE_CACHE_TTL_MS": "3600000",
"FINDMINE_CACHE_ENABLED": "true",
"FINDMINE_DEFAULT_REGION": "us",
"FINDMINE_DEFAULT_LANGUAGE": "en"
},
"args": [
"/c",
"npx",
"findmine-mcp"
],
"command": "cmd"
}FindMine Shopping Stylist
A Model Context Protocol (MCP) server that integrates FindMine's powerful product styling and outfitting recommendations with Claude and other MCP-compatible applications.
Overview
This MCP server connects to FindMine's styling API and exposes its functionality to Large Language Models through the Model Context Protocol. It allows users to:
- Browse product and outfit information
- Get outfit recommendations for specific products
- Find visually similar products
- Access style guidance and fashion advice
Features
Resources
- Products: Detailed product information withproduct:/// URI scheme
- Looks: Complete outfit recommendations with look:/// URI scheme
Tools
- get_style_guide: Access detailed fashion advice and styling guidelines - get_complete_the_look: Get outfit recommendations for a product - get_visually_similar: Find visually similar productsPrompts
- outfit_completion: Get styling advice for complete outfits - styling_guide: Access comprehensive fashion styling guidelines - findmine_help: Learn how to use FindMine's tools and resourcesInstallation
Option 1: Install from npm
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
