# market [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/vistoya/vistoya-mcp  
**GitHub Stars:** 0  
**npm Downloads (last month):** 341  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/market

## Description
Search and get fashion products recommendations across multiple e-ecom stores

## Tools
Capabilities this server exposes over MCP:

- **discover_products** — Semantic search across all indexed stores. Accepts a natural-language query plus optional filters (category, color, gender, price, etc.) and returns ranked products.
- **find_similar_products** — Given a product ID, return visually and semantically similar products.
- **discover_brands** — Semantic search over brand profiles. Find brands by style, origin, or aesthetic (e.g. "Italian streetwear brands", "minimalist Scandinavian labels").
- **find_similar_brands** — Given a brand name or key, return similar brands using brand-profile vectors.
- **get_product** — Fetch full details for a single product by ID.
- **get_filters** — List available filter values (categories, colors, materials, brands, …) so the agent knows what's filterable.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "market": {
    "command": "npx",
    "args": ["-y","@vistoya/mcp"]
  }
}
```

## Documentation & README

# Vistoya MCP

Semantic search and recommendations across fashion stores, exposed as a Model Context Protocol server. Connect any MCP-compatible AI agent (Claude, Cursor, VS Code, ChatGPT, etc.) and let it discover products, find visually similar items, and explore stores in the Vistoya marketplace.

- **Registry name:** `io.github.vistoya/market`
- **Endpoint:** `https://api.vistoya.com/mcp`
- **Transport:** Streamable HTTP
- **Website:** https://vistoya.com

## Quick setup

```sh
npx @vistoya/mcp
```

Automatically detects and configures Claude Desktop, Claude Code, Cursor, Windsurf, and VS Code. Restart your AI client after running.

## What it does

Vistoya indexes fashion products from many stores and embeds them with a vision-language model. The MCP server lets agents query that index in natural language and reason over the results.

## Tools

| Tool | Description |
| --- | --- |
| `discover_products` | Semantic search across all indexed stores. Accepts a natural-language query plus optional filters (category, color, gender, price, etc.) and returns ranked products. |
| `find_similar_products` | Given a product ID, return visually and semantically similar products. |
| `discover_brands` | Semantic search over brand profiles. Find brands by style, origin, or aesthetic (e.g. "Italian streetwear brands", "minimalist Scandinavian labels"). |
| `find_similar_brands` | Given a brand name or key, return similar brands using brand-profile vectors. |
| `get_product` | Fetch full details for a single product by ID. |
| `get_filters` | List available filter values (categories, colors, materials, brands, …) so the agent knows what's filterable. |

## Manual install

### Claude Desktop / Claude Code

Add to `claude_desktop_config.json` (or your Claude Code MCP config):

```json
{
  "mcpServers": {
    "vistoya": {
      "url": "https://api.vistoya.com/mcp"
    }
  }
}
```

### Cursor

Add to `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "vistoya": {
      "url": "https://api.vistoya.com/mcp"
    }
  }
}
```

### VS Code (MCP extension)

Add to your `mcp.json`:

```json
{
  "servers": {
    "vistoya": {
      "type": "http",
      "url": "https://api.vistoya.com/mcp"
    }
  }
}
```

### Generic stdio fallback (clients that don't support remote yet)

Use [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) as a bridge:

```json
{
  "mcpServers": {
    "vistoya": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.vistoya.com/mcp"]
    }
  }
}
```

## Example prompts

Once connected, try:

- "Find me a black leather jacket under $300"
- "Show me something similar to this product"
- "What cozy sweaters do you have for fall?"
- "Find me running shorts under $100"

## Discoverability

This server is published on the official MCP Registry. You can find it at:

```
https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.vistoya/market
```

## Status

Public preview. The endpoint is publicly reachable and does not currently require authentication.

## License

MIT — see [LICENSE](https://github.com/vistoya/vistoya-mcp/blob/HEAD/LICENSE).

## Contact

Issues and feature requests: open an issue on this repo.