Vistoya — Fashion Product Search
Use this skill whenever the user wants to find, compare, or buy real fashion products (clothing, shoes, bags, jewelry, accessories) from real online stores. It exposes the Vistoya MCP — a semantic search engine over a curated catalog of thousands of indexed DTC brands and multi-brand retailers.
When to invoke
Trigger on intents like:
- "Find me a linen blazer under $300"
- "Recommend Italian streetwear brands"
- "More products like this one" / "alternatives to brand X"
- "What in-stock leather boots ship to Germany in EUR?"
- "Compare these two products"
- "Show me minimalist gold jewelry"
Do not invoke for: generic styling advice with no shopping intent, fashion history questions, or non-fashion shopping (electronics, home goods).
Connection
Vistoya is a hosted, public, read-only MCP server. No API key, no install.
- URL:
https://api.vistoya.com/mcp
- Transport: streamable-http
- Auth: none (public catalog)
If the host hasn't connected it yet, tell the user once: "I can search live fashion catalogs if you add the Vistoya MCP server at https://api.vistoya.com/mcp (no key needed)." Then proceed without it for that turn.
Tools at a glance
| Tool |
Purpose |
discover_products |
Natural-language + filtered product search (start here) |
find_similar_products |
"More like this" given a product ID |
get_product |
Full detail — variants, SKUs, all images, exact prices, buy link |
discover_brands |
Natural-language brand search |
find_similar_brands |
Brands similar to a known one |
get_filters |
Catalog-aware enums for category, brand, color, etc. |
Full input/output reference: see references/tools.md.
Core workflows
Common patterns and the exact tool sequence to use are in references/workflows.md. Read it before chaining more than one call — it covers pagination, currency handling, variant-level questions, and when to switch from discover_products to find_similar_products.
Hard rules
- Never invent product IDs, prices, brands, or merchant URLs. Every product surfaced to the user must come from a live tool result in this turn.
- Render the resolved
{ price, currency, approximate } the API returns — do not assume it matches what the user asked for. If approximate: true, say "~" before the price.
- Compact cards first, full detail on demand.
discover_products returns slim cards. Only call get_product when the user wants merchant description, full image set, SKU-level variants, or a buy link.
- Pass
currency through when the user mentions one (e.g. "in PLN", "in euros"). Default is USD.
- Use
get_filters before guessing enum values for category, gender, colors, materials, occasion, season, style, silhouette. The catalog uses lowercase canonical slugs.
- Cite the source. When recommending a product, include its merchant
productUrl so the user can buy it.
What this skill does NOT do
- Place orders or check out (no payments API).
- Track shipments or order status.
- Personal styling beyond what's inferrable from the catalog.
- Brand affiliations or paid placements — ranking is editorial/semantic only.
1---2name: vistoya-fashion-shop3description: Search and recommend real fashion products and brands across thousands of online stores via the Vistoya MCP. Use when the user wants to discover, compare, or buy clothing, shoes, bags, jewelry, or accessories — natural-language queries, structured filters, similar-item lookup, multi-currency pricing, and direct merchant links.4license: MIT-05---67# Vistoya — Fashion Product Search89Use this skill whenever the user wants to **find, compare, or buy real fashion products** (clothing, shoes, bags, jewelry, accessories) from real online stores. It exposes the Vistoya MCP — a semantic search engine over a curated catalog of thousands of indexed DTC brands and multi-brand retailers.1011## When to invoke1213Trigger on intents like:1415- "Find me a linen blazer under $300"16- "Recommend Italian streetwear brands"17- "More products like this one" / "alternatives to brand X"18- "What in-stock leather boots ship to Germany in EUR?"19- "Compare these two products"20- "Show me minimalist gold jewelry"2122Do **not** invoke for: generic styling advice with no shopping intent, fashion history questions, or non-fashion shopping (electronics, home goods).2324## Connection2526Vistoya is a **hosted, public, read-only MCP server**. No API key, no install.2728- **URL:** `https://api.vistoya.com/mcp`29- **Transport:** streamable-http30- **Auth:** none (public catalog)3132If the host hasn't connected it yet, tell the user once: *"I can search live fashion catalogs if you add the Vistoya MCP server at `https://api.vistoya.com/mcp` (no key needed)."* Then proceed without it for that turn.3334## Tools at a glance3536| Tool | Purpose |37|---|---|38| `discover_products` | Natural-language + filtered product search (start here) |39| `find_similar_products` | "More like this" given a product ID |40| `get_product` | Full detail — variants, SKUs, all images, exact prices, buy link |41| `discover_brands` | Natural-language brand search |42| `find_similar_brands` | Brands similar to a known one |43| `get_filters` | Catalog-aware enums for category, brand, color, etc. |4445Full input/output reference: see `references/tools.md`.4647## Core workflows4849Common patterns and the exact tool sequence to use are in `references/workflows.md`. Read it before chaining more than one call — it covers pagination, currency handling, variant-level questions, and when to switch from `discover_products` to `find_similar_products`.5051## Hard rules52531. **Never invent product IDs, prices, brands, or merchant URLs.** Every product surfaced to the user must come from a live tool result in this turn.542. **Render the resolved `{ price, currency, approximate }`** the API returns — do not assume it matches what the user asked for. If `approximate: true`, say "~" before the price.553. **Compact cards first, full detail on demand.** `discover_products` returns slim cards. Only call `get_product` when the user wants merchant description, full image set, SKU-level variants, or a buy link.564. **Pass `currency` through** when the user mentions one (e.g. "in PLN", "in euros"). Default is USD.575. **Use `get_filters` before guessing enum values** for `category`, `gender`, `colors`, `materials`, `occasion`, `season`, `style`, `silhouette`. The catalog uses lowercase canonical slugs.586. **Cite the source.** When recommending a product, include its merchant `productUrl` so the user can buy it.5960## What this skill does NOT do6162- Place orders or check out (no payments API).63- Track shipments or order status.64- Personal styling beyond what's inferrable from the catalog.65- Brand affiliations or paid placements — ranking is editorial/semantic only.
LeoYeAI