io.github.vistoya/market
Search and get fashion products recommendations across multiple e-ecom stores
Open source Repository Open in the app JSON README (API)
About
Search and get fashion products recommendations across multiple e-ecom stores
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- vistoya
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Last push
- 2026-06-09T16:48:55Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 04:01:39
- Updated
- 2026-08-29 04:01:39
- Origin id
io.github.vistoya/market
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](./LICENSE).
## Contact
Issues and feature requests: open an issue on this repo.