# io.github.vistoya/market (remote · api.vistoya.com)

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

- Trust score: 75/100 (medium)
- Change this week: +6
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `api.vistoya.com`: 75/100 (this document), [markdown](https://verifymcp.io/servers/vistoya-market/api.md), [page](https://verifymcp.io/servers/vistoya-market/api)

## Channel facts

- Endpoint: `https://api.vistoya.com/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 74/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one.
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 80/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 3219 tokens (~134/item across 24 items; 6 tools + 18 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 99/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 98% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.
  - Supports UI / widget rendering.

## Install

### Claude

```bash
claude mcp add --transport http vistoya-market https://api.vistoya.com/mcp
```

### Codex

```toml
[mcp_servers.vistoya-market]
url = "https://api.vistoya.com/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "vistoya-market": {
      "type": "remote",
      "url": "https://api.vistoya.com/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add vistoya-market --url https://api.vistoya.com/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  vistoya-market:
    url: "https://api.vistoya.com/mcp"
```

### Other

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

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 75, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-01 (score 74, +1)

No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-31 (score 73, +2)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 71, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-28 (score 70, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-27 (score 69, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 68)

First indexed and scored.

## MCP tools (6)

### `discover_products` (~1406 tokens)

Find fashion products using natural language and/or structured filters. Provide a `query` for semantic ranking via multimodal text+image embeddings ("oversized wool coat", "black leather jacket", "minimalist gold jewelry", "linen shirt for a beach wedding under $200") — best for open-ended discovery. Keep queries concrete: noun-led with up to one or two modifiers works best ("summer linen shirt" beats "breathable linen shirt perfect for summer"). Provide only structured filters (category, brand, colors, gender, price, etc.) for pure browse — results are recency-ranked and paginate cleanly. Combine both for filtered semantic search. At least one of query or a filter must be provided.

Example calls (notice the sparse filter population — descriptive attributes stay in `query`, not in structured fields):
\- "linen wedding guest dress under $200" → {query: "linen wedding guest dress", gender: "women", max_price: 200, materials: ["linen"]}
\- "wool coat under $300" → {query: "wool coat", gender: "women", max_price: 300, materials: ["wool"]}
\- "browse women's black dresses $100-$300" → {gender: "women", category: "clothing/dresses", colors: ["black"], min_price: 100, max_price: 300}
\- "Acne Studios outerwear" → {query: "outerwear", brand: "Acne Studios", gender: "women"}

Returns compact product cards: AI-generated summary, price, images, tags, and compact availability by color/size; variant price differences are nested under the availability dimension that determines price. For merchant description, store info, SKU-level variants, exact variant prices, and all product images, call get_product with a product ID from these results. Multi-currency prices supported (e.g. "under 200 zł" or min_price=200 + currency="PLN"); returned prices render in the requested currency when provided.

Input parameters:

- `available_sizes` (array): Filter by available size labels, e.g. ["s", "m", "38"].
- `brand` (string): Filter by brand name
- `category` (string): Category slug, e.g. "clothing", "clothing/jackets", "clothing/jackets/bomber-jackets". Accepts last-segment shortcuts when unambiguous — e.g. "loafers-and-slip-ons" resolves the same as "shoes/loafer…
- `color_match` (string): Color matching mode. "any" (default): product has at least one of the queried colors. "exact": product has at least one image where the ONLY colors are the queried colors — use for mono-color searche…
- `colors` (array): Filter by lowercase colors: e.g. ["black", "navy", "sage green"]
- `country` (string): Optional shopper location as an ISO-3166-1 alpha-2 country code (e.g. "US", "GB", "DE"). Recorded for analytics and used to improve future offer geo-matching. Omit if unknown — absence preserves curr…
- `currency` (string): ISO 4217 currency code for min_price/max_price (e.g. "PLN", "EUR", "GBP"). Prices are converted to USD for filtering. Omit for USD.
- `exclude_colors` (array): Exclude products with these colors: e.g. ["white", "beige"]
- `exclude_materials` (array): Exclude products with these materials: e.g. ["polyester", "nylon"]
- `gender` (string): Gender filter.
- `is_sustainable` (boolean): True when the user explicitly wants products with sustainability claims.
- `limit` (integer): Page size (1-20, default 12)
- `materials` (array): Filter by lowercase materials: e.g. ["cotton", "silk", "leather"]
- `max_price` (number): Maximum price (in the currency specified by "currency" param, or USD if omitted)
- `min_price` (number): Minimum price (in the currency specified by "currency" param, or USD if omitted)
- `neckline` (string): Neckline filter. Soft descriptor — set ONLY when the user explicitly named the neckline. Do not infer from category or query.
- `occasion` (string): Occasion filter. Soft descriptor — set ONLY when the user explicitly named the occasion. The `query` field already captures occasion semantically; over-specifying is the most common cause of zero-res…
- `page` (integer): Page number.
- `pattern` (string): Pattern filter (e.g. solid, stripe, checked, floral). Soft descriptor — set ONLY when the user explicitly named the pattern. Default for unspecified ("solid") leaks into queries and zeros the candida…
- `query` (string): Natural language search query — be descriptive for best results. Can include price with currency symbols (e.g. "white coat under 200 zł") which will be parsed automatically. Optional: when omitted, r…
- `season` (string): Season filter. Soft descriptor — set ONLY when the user explicitly named the season. The `query` field already captures season semantically; over-specifying is the most common cause of zero-result ca…
- `silhouette` (string): Silhouette/fit filter (e.g. fitted, slim, regular, relaxed, oversized). Soft descriptor — set ONLY when the user explicitly named the fit. The `query` field already captures silhouette semantically;…
- `sleeves` (string): Sleeve style filter. Soft descriptor — set ONLY when the user explicitly named the sleeve style. Do not infer from category or query.
- `store_domain` (string): Filter by store domain (e.g. "thereformation.com"). Accepts forms with protocol, www, locale subdomain, or path — they are normalized to match the registered store.
- `styles` (array): Style filter (OR semantics — a product matches if any of its `styles` values is in this list). Pass a single value to filter by one style ("styles": ["minimalist"]); pass several to span a related se…

Output parameters:

- `hasNextPage` (boolean)
- `marketUrl` (string)
- `page` (integer)
- `products` (array)

### `find_similar_products` (~244 tokens)

Given a product ID, find similar products across the entire catalog. Useful for "more like this" recommendations or finding alternatives. Returns compact product cards, not full variant detail; call get_product for SKU-level variants, exact variant prices, merchant description, store info, and all images. Returns page and hasNextPage. Returns up to 20 results per page, paginated (max 3 pages).

Input parameters:

- `country` (string): Optional shopper location as an ISO-3166-1 alpha-2 country code (e.g. "US", "GB", "DE"). Recorded for analytics and used to improve future offer geo-matching. Omit if unknown — absence preserves curr…
- `currency` (string): ISO 4217 currency code to render prices in (e.g. "GBP", "EUR", "USD"). Defaults to USD. Stored native prices are preferred; falls back to FX conversion when a merchant-set price isn't available.
- `limit` (integer): Page size (1-20)
- `page` (integer): Page number (1-3)
- `product_id` (string, required): The product ID (from a previous search result)

Output parameters:

- `hasNextPage` (boolean)
- `page` (integer)
- `products` (array)

### `discover_brands` (~412 tokens)

Find fashion brands using natural language, structured filters, or both. Best for queries like "Italian streetwear brands", "Scandinavian minimalist brands", "Japanese technical outerwear", "brands with avant-garde tailoring", or "brands like Rick Owens". Country adjectives ("Italian", "Scandinavian", "Nordic", "Japanese", "Iberian", "Benelux") are parsed server-side into shipping-origin filters; you don't need to translate them to ISO codes. `query` is optional — provide a query, structured filters, or both. Brand country/shipping signals are best-effort and separate from product availability.

Input parameters:

- `category_focus` (array): Optional brand category focus filters, e.g. ["clothing", "shoes"].
- `country` (string): Optional shopper location as an ISO-3166-1 alpha-2 country code (e.g. "US", "GB", "DE"). Recorded for analytics and used to improve future offer geo-matching. Omit if unknown — absence preserves curr…
- `gender_focus` (array): Optional brand audience focus filters.
- `limit` (integer): Maximum number of brands to return (1-20, default 8).
- `price_tier` (string): Optional brand price-tier focus filter.
- `query` (string): Natural language brand search query, e.g. "Italian streetwear brands", "Scandinavian minimalist brands", "Japanese technical outerwear", or "brands like Rick Owens". Country adjectives are parsed ser…
- `ships_from_country` (string): Optional ISO-3166 alpha-2 country filter for best-effort store shipping origin, e.g. "IT", "US", "GB". This is not the same as brand origin.
- `style` (string): Optional style filter, e.g. streetwear, minimalist, elegant, avant-garde, techwear.

Output parameters:

- `brands` (array)

### `find_similar_brands` (~120 tokens)

Given a brand name, find similar brands using brand-profile vectors generated during product indexing. Returns up to 20 brands.

Input parameters:

- `brand` (string, required): Brand name (case-insensitive), e.g. "Rick Owens".
- `country` (string): Optional shopper location as an ISO-3166-1 alpha-2 country code (e.g. "US", "GB", "DE"). Recorded for analytics and used to improve future offer geo-matching. Omit if unknown — absence preserves curr…
- `limit` (integer)

Output parameters:

- `brands` (array)

### `get_product` (~180 tokens)

Get the detailed response for a specific product ID. Use this after discover_products or find_similar_products when you need merchant description, store info, all images, SKU-level availability variants, SKU, colorKey/size matrix, exact variant prices/compareAtPrice in the requested currency, and the direct link to purchase.

Input parameters:

- `country` (string): Optional shopper location as an ISO-3166-1 alpha-2 country code (e.g. "US", "GB", "DE"). Recorded for analytics and used to improve future offer geo-matching. Omit if unknown — absence preserves curr…
- `currency` (string): ISO 4217 currency code to render prices in (e.g. "GBP", "EUR", "USD"). Defaults to USD.
- `product_id` (string, required): The product ID (from a previous search result)

Output parameters:

- `availability` (object)
- `brand` (string)
- `category` (string)
- `closures` (array)
- `colors` (array)
- `compareAtPrice` (number|null)
- `currency` (string)
- `gender` (string)
- `id` (string)
- `images` (array)
- `inStock` (boolean)
- `isSustainable` (boolean)
- `materials` (array)
- `merchantDescription` (string)
- `neckline` (string)
- `price` (number|null)
- `productUrl` (string)
- `relevanceScore` (number)
- `silhouette` (string)
- `similarityScore` (number)
- `sleeves` (string)
- `store`
- `summary` (string)
- `tags` (array)
- `title` (string)

### `get_filters` (~324 tokens)

Returns available filter values in the catalog. By default returns categoryTree plus brands, colors, materials, genders, occasions, seasons, styles, silhouettes, currencies, and price range. Use "fields" to request only specific dimensions — faster and less data. "categoryTree" is a flat DFS-ordered list of { value, label } entries; hierarchy is encoded in the value slug (e.g. "clothing/jackets/bomber-jackets"), parents appear before descendants, and every value can be passed directly to discover_products.category. Use "brand_search" to search brands by prefix instead of listing all. Pass "gender" to scope categoryTree to that gender (women/men/girls/boys); omit to see the merged union.

Input parameters:

- `brand_page` (integer): Page number for brands (12 per page). Use with or without brand_search.
- `brand_search` (string): Search brands by name (case-insensitive, prefix matches first). Only affects the brands field.
- `country` (string): Optional shopper location as an ISO-3166-1 alpha-2 country code (e.g. "US", "GB", "DE"). Recorded for analytics and used to improve future offer geo-matching. Omit if unknown — absence preserves curr…
- `fields` (array): Which filter dimensions to return. Omit for all. Example: ["categoryTree", "colors", "priceRange"]
- `gender` (string): Scope categoryTree to this gender. Omit to return the merged union across women/men/girls/boys.

Output parameters:

- `brands` (array)
- `categoryTree` (array)
- `colors` (array)
- `currencies` (array)
- `genders` (array)
- `materials` (array)
- `occasions` (array)
- `patterns` (array)
- `priceRange` (object)
- `seasons` (array)
- `silhouettes` (array)
- `styles` (array)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/vistoya-market/api#diagnostics

## Score history

- 2026-08-03: 75
- 2026-08-02: 74
- 2026-08-01: 74
- 2026-07-31: 73
- 2026-07-30: 71
- 2026-07-29: 70
- 2026-07-28: 70
- 2026-07-27: 69
- 2026-07-26: 68

## Links

- Remote endpoint: https://api.vistoya.com/mcp
- Repository: https://github.com/vistoya/vistoya-mcp
- Changelog RSS feed: https://verifymcp.io/servers/vistoya-market/api/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/vistoya-market/api/changelog.json
- HTML version of this page: https://verifymcp.io/servers/vistoya-market/api