within · luxury boutiques
Server Details
Live stock at independent luxury boutiques: pieces, sizes, prices and the page to buy each one.
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
TDQS
Score is being calculated.
Available Tools
9 toolsboutique_shelfOne boutique's shelfRead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Default 12. | |
| query | No | Search inside this boutique only. | |
| offset | No | ||
| boutique_domain | Yes | The boutique's domain, as shown on boutiques and pieces (e.g. 'utopia-kicks.myshopify.com'). |
Output Schema
| Name | Required | Description |
|---|---|---|
| pieces | Yes | |
| boutique | Yes | |
| view_url | Yes | |
| next_offset | Yes |
convert_sizeConvert a sizeRead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Optional: one system key to lead the answer with. | |
| from | No | The system the size is written in, as a key this tool lists, e.g. 'us', 'uk', 'eu'. | |
| kind | No | What is being sized: rings, shoes, clothing, suits, belts or hats. | |
| size | No | The size as printed, e.g. '7', 'N 1/2', '42', 'M'. | |
| table | No | Optional: one table or chart id this tool lists. | |
| designer | No | A designer's slug, as in shopwithin.co/designers/<slug>, to read that designer's own charts instead of a kind. | |
| department | No | Optional: only women's or men's tables. |
Output Schema
| Name | Required | Description |
|---|---|---|
| note | Yes | |
| kinds | Yes | |
| scope | Yes | |
| status | Yes | |
| tables | Yes | |
| matches | Yes | |
| sources | Yes | |
| systems | Yes | |
| page_url | Yes | |
| designers | Yes | |
| size_page_url | No |
estimate_dutyEstimate import dutyRead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | Where the piece is shipped to. | |
| kind | Yes | 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. | |
| price | Yes | The price, without shipping. | |
| usmca | No | US only: true if a piece made in Canada or Mexico qualifies under USMCA. | |
| region | No | Canada only: the province code, e.g. ON, QC, BC. | |
| made_in | Yes | Two letter country code of where it was made, e.g. IT, FR, CA, US, JP. | |
| ship_by | No | us: fedex, courier or post. canada: fedex, courier or post. uk: royalmail, parcelforce or courier. australia: courier or post. | |
| currency | Yes | The currency of the price. | |
| shipping | No | Optional shipping cost, in the price's currency. | |
| weight_kg | No | Optional weight; a few US lines add a charge per kilogram. | |
| department | No | Women's or men's; some duty rates differ. | |
| ships_from | Yes | Two letter country code of where it ships from. |
Output Schema
| Name | Required | Description |
|---|---|---|
| to | No | |
| note | No | |
| page | No | |
| found | No | |
| lines | No | |
| notes | No | |
| total | No | |
| value | No | |
| status | No | |
| currency | No | |
| estimate_note | No | |
| tax_at_checkout | No | |
| what_changes_it | No | |
| exchange_rate_date | No | |
| owed_before_delivery | No |
get_pieceRead one pieceRead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | The piece's id from a previous result. | |
| url | No | A shopwithin.co piece link, e.g. https://shopwithin.co/product/<boutique>/<id>. | |
| boutique_domain | No | The piece's boutique_domain from a previous result. |
Output Schema
| Name | Required | Description |
|---|---|---|
| found | Yes | |
| piece | Yes | |
| similar | Yes |
list_boutiquesThe boutiques on withinRead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | Only boutiques in this city, e.g. 'Toronto'. |
Output Schema
| Name | Required | Description |
|---|---|---|
| cities | Yes | |
| boutiques | Yes |
search_piecesSearch the boutiques' shelvesRead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | Only boutiques in this city, e.g. 'Toronto'. If within has no boutiques there yet, the answer says so and names the live cities. | |
| lens | No | 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. | |
| sort | No | ||
| limit | No | Pieces per page, default 12. | |
| query | No | What the shopper wants, in plain words: 'black leather loafers', 'Lemaire', 'a birthday gift for my dad under $300'. | |
| sizes | No | Sizes that must be in stock, as labelled on the shelf: 'M', '42', 'US 9', 'IT 38'. | |
| brands | No | Designer or house names to restrict to, exactly as they appear in results. | |
| offset | No | Pieces to skip; use next_offset from the previous page. | |
| boutiques | No | Boutique domains to restrict to, as shown on boutiques and pieces (e.g. 'wdlt117.myshopify.com'). | |
| price_max | No | Highest price to include, in the boutique's currency. | |
| price_min | No | Lowest price to include, in the boutique's currency. | |
| categories | No | Product types to restrict to, e.g. 'Sneakers', 'Bags'; take values from a previous result's facets. |
Output Schema
| Name | Required | Description |
|---|---|---|
| note | Yes | |
| total | Yes | |
| facets | Yes | |
| pieces | Yes | |
| view_url | Yes | |
| next_offset | Yes | |
| total_is_floor | Yes | |
| related_searches | Yes |
similar_piecesPieces in the same veinRead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ||
| url | No | A shopwithin.co piece link. | |
| limit | No | Default 8. | |
| boutique_domain | No |
Output Schema
| Name | Required | Description |
|---|---|---|
| anchor | Yes | |
| pieces | Yes |
trending_nowWhat is trending this weekRead-onlyIdempotentInspect
within's chart of the designer pieces trending at independent boutiques this week, updated daily: the first 20 places 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.
| Name | Required | Description | Default |
|---|---|---|---|
| dept | No | The women's or the men's chart; leave out for everyone's. | |
| kind | No | One kind of piece, e.g. 'sneakers', 'bags', 'jackets', 'boots', 'jewelry', 'dresses'. | |
| limit | No | How many places to return, default 10. |
Output Schema
| Name | Required | Description |
|---|---|---|
| url | Yes | |
| json | Yes | |
| week | Yes | |
| as_of | Yes | |
| items | Yes | |
| kinds | Yes | |
| title | Yes | |
| designers | Yes | |
| past_weeks | Yes |
visual_searchFind it from a photographRead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| post_url | No | A TikTok or Pinterest post link; the photograph is read from the post. | |
| image_url | No | A direct, publicly reachable JPEG, PNG or WebP URL (under 1.5 MB). | |
| image_file | No | A photograph the shopper uploaded in the chat; the host passes the file here. | |
| media_type | No | Required with image_base64. | |
| image_base64 | No | The image bytes, base64 encoded (under 1.5 MB decoded). |
Output Schema
| Name | Required | Description |
|---|---|---|
| note | Yes | |
| close | Yes | |
| in_spirit | Yes |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
9 tool updates
- First observed
boutique_shelf - First observed
convert_size - First observed
estimate_duty - First observed
get_piece - First observed
list_boutiques - First observed
search_pieces - First observed
similar_pieces - First observed
trending_now - First observed
visual_search
Related MCP Connectors
Live sneaker & streetwear prices and in-stock sizes across 600+ US stores, by style code.
41Search fashion across 1,000+ retailers; compare prices, sizes and stock by country.
Search 10,209 products for sale in euros and return buyable links with live prices.
Find fresh, source-backed rare and one-of-one products at independent retailers.
Related MCP Servers
- AlicenseAqualityAmaintenanceThe premier fashion & apparel Model Context Protocol server. AI bounding box outfit deconstruction, 100% in-stock occasion looks, live size stock, and 1-click checkout.810109 npmMIT
- FlicenseNot gradedqualityCmaintenanceDTC competitor intelligence: catalog snapshots, price history, cross-brand product comparison, and drop/restock detection for 84 Shopify-powered brands. Pay-per-call via Apify.-
- AlicenseAqualityDmaintenanceLive access to 2,766+ women's fashion products from Livostyle.com via 6 tools — search products, get product details, list 158 collections, generate outfit recommendations by occasion/budget/season, and view catalog stats. Weekly-synced from Shopify; MIT-licensed open dataset.64 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables real-time multi-merchant price comparison, coupon stacking, delivery-speed trade-offs, stock volatility tracking, and optimal purchase routing for cross-platform commerce inventory arbitrage.7MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.