within · luxury boutiques
Live stock at independent luxury boutiques: pieces, sizes, prices and the page to buy each one.
Should I use this
Quality & Safety
A
Findings (3)
- HIGHTool description contains system tag or markerin convert_size
- HIGHTool poisoning patterns detected
- LOWTool 'similar_pieces' description lacks action verbin similar_pieces
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~9,111Tokens (tool definitions)
~10.1 KBTypical response size
Significant attention impact (7.12% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"within": {
"url": "https://shopwithin.co/mcp"
}
}
}Remote endpoints
https://shopwithin.co/mcpstreamable-httpWhat it can do
Tool inventory
Tools (9)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢search_pieces(query, brands, categories, sizes, boutiques, ...)
Search pieces (clothing, shoes, bags, jewellery, watches, objects) in stock right now at independent luxury boutiques, with live sizes, price in the boutique's currency, the shop that holds each piece, and the shopwithin.co page to buy it. Use this when someone wants to find or compare a kind of piece, a designer's pieces at boutiques, a gift, or what is in stock in a city. A plain sentence works as the query (prices like 'under $400' and 'cheapest' are understood); brands, categories, sizes, boutiques, or city narrow it. With no arguments it returns the current front shelf; lens browses new arrivals, most saved, or marked down. Do not use for general style advice or for mass market retailers.
Input Schema
{
"type": "object",
"properties": {
"query": {
"description": "What the shopper wants, in plain words: 'black leather loafers', 'Lemaire', 'a birthday gift for my dad under $300'.",
"type": "string",
"maxLength": 200
},
"brands": {
"description": "Designer or house names to restrict to, exactly as they appear in results.",
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"maxLength": 80
}
},
"categories": {
"description": "Product types to restrict to, e.g. 'Sneakers', 'Bags'; take values from a previous result's facets.",
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"maxLength": 60
}
},
"sizes": {
"description": "Sizes that must be in stock, as labelled on the shelf: 'M', '42', 'US 9', 'IT 38'.",
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"maxLength": 30
}
},
"boutiques": {
"description": "Boutique domains to restrict to, as shown on boutiques and pieces (e.g. 'wdlt117.myshopify.com').",
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"maxLength": 120
}
},
"city": {
"description": "Only boutiques in this city, e.g. 'Toronto'. If within has no boutiques there yet, the answer says so and names the live cities.",
"type": "string",
"maxLength": 60
},
"price_min": {
"description": "Lowest price to include, in the boutique's currency.",
"type": "number",
"minimum": 0
},
"price_max": {
"description": "Highest price to include, in the boutique's currency.",
"type": "number",
"exclusiveMinimum": 0
},
"sort": {
"type": "string",
"enum": [
"relevance",
"newest",
"price_low_to_high",
"price_high_to_low"
]
},
"lens": {
"description": "Browse a shelf instead of searching: 'new' = just arrived, 'trending' = what people are saving, 'sale' = marked down. Ignored when a query or filters are given.",
"type": "string",
"enum": [
"new",
"trending",
"sale"
]
},
"limit": {
"description": "Pieces per page, default 12.",
"type": "integer",
"minimum": 1,
"maximum": 24
},
"offset": {
"description": "Pieces to skip; use next_offset from the previous page.",
"type": "integer",
"minimum": 0,
"maximum": 480
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"pieces": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"boutique_domain": {
"type": "string"
},
"title": {
"type": "string"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"price": {
"type": "number"
},
"price_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"price_label": {
"type": "string"
},
"sizes_in_stock": {
"type": "array",
"items": {
"type": "string"
}
},
"units_in_stock": {
"type": "number"
},
"boutique": {
"type": "object",
"properties": {
"domain": {
"type": "string"
},
"name": {
"type": "string"
},
"neighbourhood": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
}
},
"required": [
"domain",
"name",
"neighbourhood",
"city",
"url"
],
"additionalProperties": false
},
"collect_in_store": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"delivery": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
},
"price_drop": {
"anyOf": [
{
"type": "object",
"properties": {
"from": {
"type": "number"
},
"at": {
"type": "string"
}
},
"required": [
"from",
"at"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"condition": {
"anyOf": [
{
"type": "string",
"enum": [
"pre-owned",
"lightly-used",
"worn-once",
"vintage",
"new"
]
},
{
"type": "null"
}
]
},
"stock_checked_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"boutique_domain",
"title",
"brand",
"category",
"price",
"price_max",
"currency",
"price_label",
"sizes_in_stock",
"units_in_stock",
"boutique",
"collect_in_store",
"delivery",
"image",
"url",
"price_drop",
"condition",
"stock_checked_at"
],
"additionalProperties": false
}
},
"total": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"total_is_floor": {
"type": "boolean"
},
"next_offset": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"facets": {
"anyOf": [
{
"type": "object",
"properties": {
"brands": {
"type": "array",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string"
},
"count": {
"type": "number"
}
},
"required": [
"value",
"count"
],
"additionalProperties": false
}
},
"categories": {
"type": "array",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string"
},
"count": {
"type": "number"
}
},
"required": [
"value",
"count"
],
"additionalProperties": false
}
},
"sizes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string"
},
"count": {
"type": "number"
}
},
"required": [
"value",
"count"
],
"additionalProperties": false
}
},
"boutiques": {
"type": "array",
"items": {
"type": "object",
"properties": {
"domain": {
"type": "string"
},
"name": {
"type": "string"
},
"count": {
"type": "number"
}
},
"required": [
"domain",
"name",
"count"
],
"additionalProperties": false
}
}
},
"required": [
"brands",
"categories",
"sizes",
"boutiques"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"related_searches": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"query": {
"type": "string"
},
"count": {
"type": "number"
}
},
"required": [
"label",
"query",
"count"
],
"additionalProperties": false
}
},
"view_url": {
"type": "string"
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"pieces",
"total",
"total_is_floor",
"next_offset",
"facets",
"related_searches",
"view_url",
"note"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_piece(url, boutique_domain, id)
One piece in full: description, every size or variant with live stock, photographs, price and any markdown, whether it is collected in the shop or delivered, the boutique, the page to buy it, and a few pieces in the same vein. Use this when a shopper asks about a specific piece from a result, pastes a shopwithin.co link, or wants to know whether a size is in stock before buying. Identify the piece by url, or by boutique_domain and id from a previous result.
Input Schema
{
"type": "object",
"properties": {
"url": {
"description": "A shopwithin.co piece link, e.g. https://shopwithin.co/product/<boutique>/<id>.",
"type": "string",
"maxLength": 400
},
"boutique_domain": {
"description": "The piece's boutique_domain from a previous result.",
"type": "string",
"maxLength": 120
},
"id": {
"description": "The piece's id from a previous result.",
"type": "string",
"maxLength": 80
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"found": {
"type": "boolean"
},
"piece": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"boutique_domain": {
"type": "string"
},
"title": {
"type": "string"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"price": {
"type": "number"
},
"price_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"price_label": {
"type": "string"
},
"sizes_in_stock": {
"type": "array",
"items": {
"type": "string"
}
},
"units_in_stock": {
"type": "number"
},
"boutique": {
"type": "object",
"properties": {
"domain": {
"type": "string"
},
"name": {
"type": "string"
},
"neighbourhood": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
}
},
"required": [
"domain",
"name",
"neighbourhood",
"city",
"url"
],
"additionalProperties": false
},
"collect_in_store": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"delivery": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
},
"price_drop": {
"anyOf": [
{
"type": "object",
"properties": {
"from": {
"type": "number"
},
"at": {
"type": "string"
}
},
"required": [
"from",
"at"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"condition": {
"anyOf": [
{
"type": "string",
"enum": [
"pre-owned",
"lightly-used",
"worn-once",
"vintage",
"new"
]
},
{
"type": "null"
}
]
},
"stock_checked_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"images": {
"type": "array",
"items": {
"type": "string"
}
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"variants": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"price": {
"type": "number"
},
"compare_at_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"in_stock": {
"type": "boolean"
},
"units": {
"type": "number"
}
},
"required": [
"label",
"price",
"compare_at_price",
"in_stock",
"units"
],
"additionalProperties": false
}
},
"collect_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"rating": {
"anyOf": [
{
"type": "object",
"properties": {
"average": {
"type": "number"
},
"count": {
"type": "number"
}
},
"required": [
"average",
"count"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"boutique_domain",
"title",
"brand",
"category",
"price",
"price_max",
"currency",
"price_label",
"sizes_in_stock",
"units_in_stock",
"boutique",
"collect_in_store",
"delivery",
"image",
"url",
"price_drop",
"condition",
"stock_checked_at",
"description",
"images",
"tags",
"variants",
"collect_at",
"rating"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"similar": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"boutique_domain": {
"type": "string"
},
"title": {
"type": "string"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"price": {
"type": "number"
},
"price_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"price_label": {
"type": "string"
},
"sizes_in_stock": {
"type": "array",
"items": {
"type": "string"
}
},
"units_in_stock": {
"type": "number"
},
"boutique": {
"type": "object",
"properties": {
"domain": {
"type": "string"
},
"name": {
"type": "string"
},
"neighbourhood": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
}
},
"required": [
"domain",
"name",
"neighbourhood",
"city",
"url"
],
"additionalProperties": false
},
"collect_in_store": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"delivery": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
},
"price_drop": {
"anyOf": [
{
"type": "object",
"properties": {
"from": {
"type": "number"
},
"at": {
"type": "string"
}
},
"required": [
"from",
"at"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"condition": {
"anyOf": [
{
"type": "string",
"enum": [
"pre-owned",
"lightly-used",
"worn-once",
"vintage",
"new"
]
},
{
"type": "null"
}
]
},
"stock_checked_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"boutique_domain",
"title",
"brand",
"category",
"price",
"price_max",
"currency",
"price_label",
"sizes_in_stock",
"units_in_stock",
"boutique",
"collect_in_store",
"delivery",
"image",
"url",
"price_drop",
"condition",
"stock_checked_at"
],
"additionalProperties": false
}
}
},
"required": [
"found",
"piece",
"similar"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢trending_now(dept, kind, limit)
within's chart of the designer pieces trending at independent boutiques this week, updated daily: the top ten in order, each with its reason (Google searches, Pinterest searches, what boutiques worldwide are stocking, what people look at on within), its place last week and its weeks on the list, plus the designers of the week. Use this when someone asks what is trending in designer or luxury fashion right now, which designers or pieces are hot this week, or what is trending in a kind of piece (sneakers, bags, jackets, boots, jewelry…). dept narrows to women or men; kind to one kind of piece. Each piece has a url to buy it. Do not use for mass market retailers or for last year's trends.
Input Schema
{
"type": "object",
"properties": {
"dept": {
"description": "The women's or the men's chart; leave out for everyone's.",
"type": "string",
"enum": [
"women",
"men"
]
},
"kind": {
"description": "One kind of piece, e.g. 'sneakers', 'bags', 'jackets', 'boots', 'jewelry', 'dresses'.",
"type": "string",
"enum": [
"sneakers",
"boots",
"loafers",
"sandals",
"heels",
"jackets",
"hoodies",
"knitwear",
"t-shirts",
"shirts",
"pants",
"jeans",
"shorts",
"dresses",
"skirts",
"suits",
"activewear",
"bags",
"jewelry",
"watches",
"eyewear",
"hats",
"scarves",
"wallets",
"belts"
]
},
"limit": {
"description": "How many places to return, up to ten, default 10.",
"type": "integer",
"minimum": 1,
"maximum": 10
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"week": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"as_of": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"place": {
"type": "number"
},
"title": {
"type": "string"
},
"designer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"price": {
"type": "number"
},
"currency": {
"type": "string"
},
"url": {
"type": "string"
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"last_week": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"weeks_on_list": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"move": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"place",
"title",
"designer",
"price",
"currency",
"url",
"image",
"reason",
"last_week",
"weeks_on_list",
"move"
],
"additionalProperties": false
}
},
"designers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"move": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
}
},
"required": [
"name",
"reason",
"move",
"url"
],
"additionalProperties": false
}
},
"kinds": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"url"
],
"additionalProperties": false
}
},
"past_weeks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"week": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"week",
"url"
],
"additionalProperties": false
}
},
"json": {
"type": "string"
}
},
"required": [
"title",
"url",
"week",
"as_of",
"items",
"designers",
"kinds",
"past_weeks",
"json"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢similar_pieces(url, boutique_domain, id, limit)
Pieces in the same vein as one piece: same spirit, same department, across every boutique, in stock now. Use this when a shopper likes a piece but wants alternatives, another price, or another shop. Identify the anchor piece by url, or by boutique_domain and id.
Input Schema
{
"type": "object",
"properties": {
"url": {
"description": "A shopwithin.co piece link.",
"type": "string",
"maxLength": 400
},
"boutique_domain": {
"type": "string",
"maxLength": 120
},
"id": {
"type": "string",
"maxLength": 80
},
"limit": {
"description": "Default 8.",
"type": "integer",
"minimum": 1,
"maximum": 12
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"anchor": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"boutique_domain": {
"type": "string"
},
"title": {
"type": "string"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"price": {
"type": "number"
},
"price_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"price_label": {
"type": "string"
},
"sizes_in_stock": {
"type": "array",
"items": {
"type": "string"
}
},
"units_in_stock": {
"type": "number"
},
"boutique": {
"type": "object",
"properties": {
"domain": {
"type": "string"
},
"name": {
"type": "string"
},
"neighbourhood": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
}
},
"required": [
"domain",
"name",
"neighbourhood",
"city",
"url"
],
"additionalProperties": false
},
"collect_in_store": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"delivery": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
},
"price_drop": {
"anyOf": [
{
"type": "object",
"properties": {
"from": {
"type": "number"
},
"at": {
"type": "string"
}
},
"required": [
"from",
"at"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"condition": {
"anyOf": [
{
"type": "string",
"enum": [
"pre-owned",
"lightly-used",
"worn-once",
"vintage",
"new"
]
},
{
"type": "null"
}
]
},
"stock_checked_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"boutique_domain",
"title",
"brand",
"category",
"price",
"price_max",
"currency",
"price_label",
"sizes_in_stock",
"units_in_stock",
"boutique",
"collect_in_store",
"delivery",
"image",
"url",
"price_drop",
"condition",
"stock_checked_at"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"pieces": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"boutique_domain": {
"type": "string"
},
"title": {
"type": "string"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"price": {
"type": "number"
},
"price_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"price_label": {
"type": "string"
},
"sizes_in_stock": {
"type": "array",
"items": {
"type": "string"
}
},
"units_in_stock": {
"type": "number"
},
"boutique": {
"type": "object",
"properties": {
"domain": {
"type": "string"
},
"name": {
"type": "string"
},
"neighbourhood": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
}
},
"required": [
"domain",
"name",
"neighbourhood",
"city",
"url"
],
"additionalProperties": false
},
"collect_in_store": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"delivery": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
},
"price_drop": {
"anyOf": [
{
"type": "object",
"properties": {
"from": {
"type": "number"
},
"at": {
"type": "string"
}
},
"required": [
"from",
"at"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"condition": {
"anyOf": [
{
"type": "string",
"enum": [
"pre-owned",
"lightly-used",
"worn-once",
"vintage",
"new"
]
},
{
"type": "null"
}
]
},
"stock_checked_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"boutique_domain",
"title",
"brand",
"category",
"price",
"price_max",
"currency",
"price_label",
"sizes_in_stock",
"units_in_stock",
"boutique",
"collect_in_store",
"delivery",
"image",
"url",
"price_drop",
"condition",
"stock_checked_at"
],
"additionalProperties": false
}
}
},
"required": [
"anchor",
"pieces"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢list_boutiques(city)
The independent luxury boutiques listed on within, with neighbourhood, city, how many pieces each has live, opening hours, and whether a shopper collects in the shop or can have pieces delivered. Use this when someone asks which shops are on within, what is in a city or neighbourhood, or where to visit in person. The returned domain identifies a boutique everywhere else.
Input Schema
{
"type": "object",
"properties": {
"city": {
"description": "Only boutiques in this city, e.g. 'Toronto'.",
"type": "string",
"maxLength": 60
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"boutiques": {
"type": "array",
"items": {
"type": "object",
"properties": {
"domain": {
"type": "string"
},
"name": {
"type": "string"
},
"neighbourhood": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"pieces_live": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"hours": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"collect_in_store": {
"type": "boolean"
},
"delivery": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"collect_ready_in_minutes": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
}
},
"required": [
"domain",
"name",
"neighbourhood",
"city",
"pieces_live",
"currency",
"hours",
"collect_in_store",
"delivery",
"collect_ready_in_minutes",
"url"
],
"additionalProperties": false
}
},
"cities": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"boutiques",
"cities"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢boutique_shelf(boutique_domain, query, limit, offset)
One boutique's shelf right now, newest first, with sizes and prices; a query searches inside that shop only. Use this when a shopper names a specific boutique ('what does WDLT117 have', 'show me Utopia's sneakers') or wants to browse a shop they read about. boutique_domain is the domain shown on any boutique or piece.
Input Schema
{
"type": "object",
"properties": {
"boutique_domain": {
"type": "string",
"maxLength": 120,
"description": "The boutique's domain, as shown on boutiques and pieces (e.g. 'utopia-kicks.myshopify.com')."
},
"query": {
"description": "Search inside this boutique only.",
"type": "string",
"maxLength": 200
},
"limit": {
"description": "Default 12.",
"type": "integer",
"minimum": 1,
"maximum": 24
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 480
}
},
"required": [
"boutique_domain"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"boutique": {
"anyOf": [
{
"type": "object",
"properties": {
"domain": {
"type": "string"
},
"name": {
"type": "string"
},
"neighbourhood": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"pieces_live": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"hours": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"collect_in_store": {
"type": "boolean"
},
"delivery": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"collect_ready_in_minutes": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
}
},
"required": [
"domain",
"name",
"neighbourhood",
"city",
"pieces_live",
"currency",
"hours",
"collect_in_store",
"delivery",
"collect_ready_in_minutes",
"url"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"pieces": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"boutique_domain": {
"type": "string"
},
"title": {
"type": "string"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"price": {
"type": "number"
},
"price_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"price_label": {
"type": "string"
},
"sizes_in_stock": {
"type": "array",
"items": {
"type": "string"
}
},
"units_in_stock": {
"type": "number"
},
"boutique": {
"type": "object",
"properties": {
"domain": {
"type": "string"
},
"name": {
"type": "string"
},
"neighbourhood": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
}
},
"required": [
"domain",
"name",
"neighbourhood",
"city",
"url"
],
"additionalProperties": false
},
"collect_in_store": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"delivery": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
},
"price_drop": {
"anyOf": [
{
"type": "object",
"properties": {
"from": {
"type": "number"
},
"at": {
"type": "string"
}
},
"required": [
"from",
"at"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"condition": {
"anyOf": [
{
"type": "string",
"enum": [
"pre-owned",
"lightly-used",
"worn-once",
"vintage",
"new"
]
},
{
"type": "null"
}
]
},
"stock_checked_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"boutique_domain",
"title",
"brand",
"category",
"price",
"price_max",
"currency",
"price_label",
"sizes_in_stock",
"units_in_stock",
"boutique",
"collect_in_store",
"delivery",
"image",
"url",
"price_drop",
"condition",
"stock_checked_at"
],
"additionalProperties": false
}
},
"next_offset": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"view_url": {
"type": "string"
}
},
"required": [
"boutique",
"pieces",
"next_offset",
"view_url"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢visual_search(image_url, image_base64, media_type, post_url, image_file)
Pieces on the boutiques' shelves that resemble a photograph: a screenshot, a street style shot, a product photo, or a TikTok or Pinterest link. Answers in two tiers: pieces close enough to be the same or a near twin, and pieces in the same spirit. Use this when a shopper shares an image of something they want to find or 'something like this'. Pass image_url for a direct image, image_base64 with media_type for an uploaded file, or post_url for a TikTok or Pinterest link. Photographs are matched in memory and never stored. Do not use for Instagram links; they cannot be read, so ask for a screenshot instead.
Input Schema
{
"type": "object",
"properties": {
"image_url": {
"description": "A direct, publicly reachable JPEG, PNG or WebP URL (under 1.5 MB).",
"type": "string",
"maxLength": 2000
},
"image_base64": {
"description": "The image bytes, base64 encoded (under 1.5 MB decoded).",
"type": "string",
"maxLength": 2000000
},
"media_type": {
"description": "Required with image_base64.",
"type": "string",
"enum": [
"image/jpeg",
"image/png",
"image/webp"
]
},
"post_url": {
"description": "A TikTok or Pinterest post link; the photograph is read from the post.",
"type": "string",
"maxLength": 500
},
"image_file": {
"description": "A photograph the shopper uploaded in the chat; the host passes the file here.",
"type": "object",
"properties": {
"file_id": {
"type": "string"
},
"download_url": {
"type": "string",
"maxLength": 4000
},
"mime_type": {
"type": "string"
},
"file_name": {
"type": "string"
}
},
"required": [
"download_url"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"close": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"boutique_domain": {
"type": "string"
},
"title": {
"type": "string"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"price": {
"type": "number"
},
"price_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"price_label": {
"type": "string"
},
"sizes_in_stock": {
"type": "array",
"items": {
"type": "string"
}
},
"units_in_stock": {
"type": "number"
},
"boutique": {
"type": "object",
"properties": {
"domain": {
"type": "string"
},
"name": {
"type": "string"
},
"neighbourhood": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
}
},
"required": [
"domain",
"name",
"neighbourhood",
"city",
"url"
],
"additionalProperties": false
},
"collect_in_store": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"delivery": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
},
"price_drop": {
"anyOf": [
{
"type": "object",
"properties": {
"from": {
"type": "number"
},
"at": {
"type": "string"
}
},
"required": [
"from",
"at"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"condition": {
"anyOf": [
{
"type": "string",
"enum": [
"pre-owned",
"lightly-used",
"worn-once",
"vintage",
"new"
]
},
{
"type": "null"
}
]
},
"stock_checked_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"score": {
"type": "number"
}
},
"required": [
"id",
"boutique_domain",
"title",
"brand",
"category",
"price",
"price_max",
"currency",
"price_label",
"sizes_in_stock",
"units_in_stock",
"boutique",
"collect_in_store",
"delivery",
"image",
"url",
"price_drop",
"condition",
"stock_checked_at",
"score"
],
"additionalProperties": false
}
},
"in_spirit": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"boutique_domain": {
"type": "string"
},
"title": {
"type": "string"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"price": {
"type": "number"
},
"price_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"price_label": {
"type": "string"
},
"sizes_in_stock": {
"type": "array",
"items": {
"type": "string"
}
},
"units_in_stock": {
"type": "number"
},
"boutique": {
"type": "object",
"properties": {
"domain": {
"type": "string"
},
"name": {
"type": "string"
},
"neighbourhood": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
}
},
"required": [
"domain",
"name",
"neighbourhood",
"city",
"url"
],
"additionalProperties": false
},
"collect_in_store": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"delivery": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
},
"price_drop": {
"anyOf": [
{
"type": "object",
"properties": {
"from": {
"type": "number"
},
"at": {
"type": "string"
}
},
"required": [
"from",
"at"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"condition": {
"anyOf": [
{
"type": "string",
"enum": [
"pre-owned",
"lightly-used",
"worn-once",
"vintage",
"new"
]
},
{
"type": "null"
}
]
},
"stock_checked_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"score": {
"type": "number"
}
},
"required": [
"id",
"boutique_domain",
"title",
"brand",
"category",
"price",
"price_max",
"currency",
"price_label",
"sizes_in_stock",
"units_in_stock",
"boutique",
"collect_in_store",
"delivery",
"image",
"url",
"price_drop",
"condition",
"stock_checked_at",
"score"
],
"additionalProperties": false
}
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"close",
"in_spirit",
"note"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢convert_size(kind, designer, from, size, to, ...)
Turn a size in one system into every other system: rings, shoes, clothing, suits, belts and hats, or one designer's own chart (pass designer as its slug, e.g. 'nike'). Answers only from the size tables on shopwithin.co/sizes, where every row comes from a named source with the day it was read, and returns the page that shows the answer. Use this when a shopper asks what their size is in another country's system, which size to take in a designer, or how a designer's sizes run. Call it without from and size to list the systems and tables a kind or a designer has.
Input Schema
{
"type": "object",
"properties": {
"kind": {
"description": "What is being sized: rings, shoes, clothing, suits, belts or hats.",
"type": "string",
"enum": [
"rings",
"shoes",
"clothing",
"suits",
"belts",
"hats"
]
},
"designer": {
"description": "A designer's slug, as in shopwithin.co/designers/<slug>, to read that designer's own charts instead of a kind.",
"type": "string",
"maxLength": 80
},
"from": {
"description": "The system the size is written in, as a key this tool lists, e.g. 'us', 'uk', 'eu'.",
"type": "string",
"maxLength": 48
},
"size": {
"description": "The size as printed, e.g. '7', 'N 1/2', '42', 'M'.",
"type": "string",
"maxLength": 24
},
"to": {
"description": "Optional: one system key to lead the answer with.",
"type": "string",
"maxLength": 48
},
"department": {
"description": "Optional: only women's or men's tables.",
"type": "string",
"enum": [
"women",
"men"
]
},
"table": {
"description": "Optional: one table or chart id this tool lists.",
"type": "string",
"maxLength": 48
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"status": {
"type": "string"
},
"scope": {
"anyOf": [
{
"type": "object",
"properties": {
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"designer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
}
},
"required": [
"kind",
"designer",
"name"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"systems": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
}
},
"required": [
"key",
"label"
],
"additionalProperties": false
}
},
"tables": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"department": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"title",
"department"
],
"additionalProperties": false
}
},
"matches": {
"type": "array",
"items": {
"type": "object",
"properties": {
"table_id": {
"type": "string"
},
"table_title": {
"type": "string"
},
"match": {
"type": "string"
},
"sizes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"system": {
"type": "string"
},
"label": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"system",
"label",
"value"
],
"additionalProperties": false
}
}
},
"required": [
"table_id",
"table_title",
"match",
"sizes"
],
"additionalProperties": false
}
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"publisher": {
"type": "string"
},
"url": {
"type": "string"
},
"read_on": {
"type": "string"
}
},
"required": [
"publisher",
"url",
"read_on"
],
"additionalProperties": false
}
},
"page_url": {
"type": "string"
},
"size_page_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"kinds": {
"type": "array",
"items": {
"type": "string"
}
},
"designers": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"status",
"scope",
"systems",
"tables",
"matches",
"sources",
"page_url",
"note",
"kinds",
"designers"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢estimate_duty(to, price, currency, kind, department, ...)
Work out what a piece of clothing, a pair of shoes, a bag, jewellery, a watch or an accessory costs at the door when it is shipped to the US, Canada, the UK or Australia: the duty, any extra tariff on the country it was made in, the tax, the government and carrier fees, and the total. Every line names its official source and the day it was read, and the answer links the page on shopwithin.co/duty-calculator that shows it. Use this when a shopper asks about customs, duty, tariffs or import tax on a cross-border order. It is an estimate; the carrier's bill is the final word.
Input Schema
{
"type": "object",
"properties": {
"to": {
"type": "string",
"enum": [
"us",
"canada",
"uk",
"australia"
],
"description": "Where the piece is shipped to."
},
"price": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 10000000,
"description": "The price, without shipping."
},
"currency": {
"type": "string",
"enum": [
"CAD",
"USD",
"GBP",
"EUR",
"AUD"
],
"description": "The currency of the price."
},
"kind": {
"type": "string",
"maxLength": 40,
"description": "What the piece is, one of: coat-wool, coat-cotton, coat-polyester, puffer-down, jacket-wool, jacket-cotton, jacket-polyester, jacket-leather, blazer-wool, blazer-cotton, blazer-polyester, trousers-wool, trousers-cotton, trousers-polyester, dress-wool, dress-cotton, dress-silk, dress-polyester, skirt-wool, skirt-cotton, skirt-polyester, shirt-cotton, shirt-silk, shirt-polyester, tshirt-cotton, tshirt-polyester, sweater-cashmere, sweater-wool, sweater-cotton, sweater-polyester, shoes-leather, sneakers-leather, boots-leather, sneakers-textile, bag-leather, bag-textile, wallet-leather, jewellery-gold, jewellery-silver, jewellery-costume, watch-automatic, watch-gold, belt-leather, scarf-silk, scarf-wool, tie-silk, sunglasses."
},
"department": {
"description": "Women's or men's; some duty rates differ.",
"type": "string",
"enum": [
"women",
"men"
]
},
"made_in": {
"type": "string",
"minLength": 2,
"maxLength": 2,
"description": "Two letter country code of where it was made, e.g. IT, FR, CA, US, JP."
},
"ships_from": {
"type": "string",
"minLength": 2,
"maxLength": 2,
"description": "Two letter country code of where it ships from."
},
"ship_by": {
"description": "us: fedex, courier or post. canada: fedex, courier or post. uk: royalmail, parcelforce or courier. australia: courier or post.",
"type": "string",
"maxLength": 20
},
"region": {
"description": "Canada only: the province code, e.g. ON, QC, BC.",
"type": "string",
"maxLength": 3
},
"shipping": {
"description": "Optional shipping cost, in the price's currency.",
"type": "number",
"minimum": 0,
"maximum": 100000
},
"weight_kg": {
"description": "Optional weight; a few US lines add a charge per kilogram.",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 100
},
"usmca": {
"description": "US only: true if a piece made in Canada or Mexico qualifies under USMCA.",
"type": "boolean"
}
},
"required": [
"to",
"price",
"currency",
"kind",
"made_in",
"ships_from"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"found": {
"type": "boolean"
},
"to": {
"type": "string"
},
"currency": {
"type": "string"
},
"status": {
"type": "string"
},
"value": {
"type": "number"
},
"lines": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"detail": {
"type": "string"
},
"amount": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"sources": {
"type": "array",
"items": {}
}
},
"required": [
"label",
"amount"
],
"additionalProperties": false
}
},
"owed_before_delivery": {},
"tax_at_checkout": {},
"total": {},
"what_changes_it": {},
"notes": {},
"exchange_rate_date": {},
"estimate_note": {
"type": "string"
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"page": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Community
Evidence
Recent observations
verifiedversion not recorded9 tools