Introduction

Vistoya MCP

The Vistoya MCP server gives AI agents direct access to a curated, multi-brand fashion catalog. Agents can search by structured filters, discover products through natural language, find similar items, and retrieve full product details — all over a single Streamable HTTP connection.

What is MCP?

The Model Context Protocol is an open standard that lets AI applications connect to external data sources and tools. Instead of building custom integrations for every AI platform, you expose a single MCP server and any compatible agent can use it.

Vistoya's MCP server exposes 5 read-only tools that cover the full product discovery workflow:

ToolPurpose
discover_productsNatural language semantic search with AI embeddings
get_productFull product details by ID
find_similar"More like this" recommendations
list_storesBrowse connected stores
get_filtersAvailable filter values and catalog stats

Endpoint

POST https://mcp.vistoya.com/mcp

The server uses Streamable HTTP transport — the current MCP standard for remote servers. No WebSocket upgrade required.

Key features

  • Semantic search — agents can query with natural descriptions like "breathable linen dress for a beach wedding under $200"
  • Rich taxonomy — every product is AI-classified with category, subcategory, colors, materials, gender, occasion, season, style, fit, and silhouette
  • Stateful sessions — the server maintains sessions via the mcp-session-id header with a 30-minute idle timeout
  • Rate limited — 200 requests per 15-minute window per session (mcp-session-id)