
MCP server for shopping independent luxury boutiques: live stock, sizes, prices, where to buy and
MCP server for shopping independent luxury boutiques: live stock, sizes, prices, where to buy and what it costs delivered. Remote, free, no key. 26 read only tools.
·
within is a marketplace of independent luxury boutiques. Its MCP server gives an assistant, an agent or your own code 26 read only tools for shopping them.
Each answer is what a real shop has in stock right now: designer clothes, shoes, sneakers, bags, jewellery and watches, new and pre-owned. It comes with the sizes left, the price in the shop's own currency and the page to buy.
| Address | https://shopwithin.co/mcp (remote, Streamable HTTP) |
| Cost | Free. No account, no key, no login |
| What it does | Reads only. 26 tools and 6 starter prompts. Nothing is bought, held or charged through the tools |
| Registry name | co.shopwithin/within in the official MCP registry |
| Docs | https://shopwithin.co/agents |
| Every tool in full | docs/TOOLS.md |
Most apps take a remote MCP server by its address. Open the app's settings, add a custom connector or a remote MCP server, and paste:
https://shopwithin.co/mcpName it within if the app asks, and choose no login.
Apps and code editors with an MCP settings file read this shape:
{
"mcpServers": {
"within": { "url": "https://shopwithin.co/mcp" }
}
}Some also want "type": "http" beside the url. The server answers the same way.
Most command line agents take one line of this shape:
<your-agent> mcp add --transport http within https://shopwithin.co/mcpSome apps only start an MCP server as a local command. This repo is a small bridge for them.
The bridge runs on your computer and passes each request to the hosted server. It needs Node 18 or newer, and nothing else.
{
"mcpServers": {
"within": {
"command": "npx",
"args": ["-y", "github:startupbuilders777/within-mcp"]
}
}
}You get the same 26 tools either way. The bridge holds no data and needs no key.
Any MCP client library connects to the address. You can also send JSON-RPC yourself. To list the tools:
curl -s https://shopwithin.co/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'To call one:
curl -s https://shopwithin.co/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_pieces","arguments":{"query":"black leather loafers","sizes":["42"],"price_max":600}}}'More examples are in examples/.
Ask in plain words. These all return real answers today.
| Someone asks | The tool that answers |
|---|---|
| "Jordan 4s in a size 10 under 500 dollars in Toronto" | search_pieces |
| "Where can I buy Chrome Hearts?" | where_to_buy |
| "How much is a Chrome Hearts hoodie right now?" | price_check |
| "What just came in from Rick Owens?" | new_arrivals |
| "What does Canada Goose have on sale?" | on_sale |
| "What is trending this week?" | trending_now |
| "Find something like the bag in this photo" | visual_search |
| "Does this run small? I usually wear a medium" | piece_fit |
| "What would this cost delivered to the US, with duty and tax?" | delivered_price |
| "I wear a UK 8 shoe. What is that in EU and US sizes?" | convert_size |
| "What duty will I pay on a 1,295 dollar coat shipped to the US?" | estimate_duty |
| "Which vintage shops are in Paris?" | boutique_directory |
| "Tell me about Rick Owens: who owns it, where it is made, who stocks it" | designer_guide |
| "Gift ideas for him under 200 dollars" | gift_ideas |
| "What can I pick up in a shop in Toronto today?" | pickup_today |
| "What do I wear with these boots?" | wear_with |
Every tool only reads. The names say pieces where the answers say items; they are the same thing. Inputs and full descriptions are in docs/TOOLS.md.
Finding things in stock
| Tool | What it returns |
|---|---|
search_pieces | Items in stock now, from a plain sentence or by designer, category, size, boutique, city and price |
new_arrivals | The newest items to arrive, newest first |
on_sale | Items marked down now, with the old price, the new price and how much is off |
trending_now | within's chart of the designer items trending this week, with the reason for each |
visual_search | Items that look like a photo, a screenshot or a social post |
similar_pieces | Items like one item, at every boutique |
pickup_today | Items a shopper can buy online and pick up in the shop |
One item
| Tool | What it returns |
|---|---|
get_piece | One item in full: every size with live stock, photographs, the price and the page to buy |
piece_fit | How an item fits: its measurements, the designer's chart, whether it runs small or large |
wear_with | What goes with one item, from stock |
delivered_price | What one item costs delivered to a country, with delivery, duty and tax |
compare_pieces | Two to four items side by side |
Designers
| Tool | What it returns |
|---|---|
designer_guide | A designer's facts with sources, what is in stock, the price range and who stocks it |
where_to_buy | Where to buy a designer, a named item or a style code, in stock and by city |
price_check | What a designer's item costs right now: lowest, middle and highest price |
brands_like | Designers like a given one, counted from what the same boutiques stock |
Boutiques
| Tool | What it returns |
|---|---|
list_boutiques | The boutiques that sell on within, with city, hours and how much each has in stock |
boutique_shelf | One boutique's stock, newest first, or a search inside that shop |
boutique_directory | Independent boutiques in a city, from a directory of about 8,700 shops in more than 140 cities |
boutique_details | One boutique's address, hours, website and the designers it lists |
delivery_and_returns | A boutique's delivery prices, pickup and return terms |
Sizes and customs
| Tool | What it returns |
|---|---|
convert_size | A ring, shoe, clothing, suit, belt or hat size in every other system, from named charts |
estimate_duty | The duty, tax and fees on an order shipped to the US, Canada, the UK or Australia |
Ideas
| Tool | What it returns |
|---|---|
gift_ideas | Gift ideas in stock, for her, for him or for anyone, under a budget |
outfit_ideas | Whole outfits within has put together, for a question or an occasion |
find_notes | within's own guides: how a designer's sizes run, where to shop in a city, how to tell real from fake |
The server also has six starter prompts: find it in my size, where to buy, gift ideas, boutiques in a city, what is my size, and price at my door.
Every answer comes twice: a short text a person could read whole, and structured data with the same facts in fields. This is the text for "Jordan 4s in a size 10 under 500 dollars in Toronto", asked on 10 November 2026 and shortened here (since 11 November the first line says "items"):
3 items in Toronto, on the shelves right now:
1. Air Jordan 4 Retro OG "White Cement 2025", CAD 450, sizes in stock: US M 8 / W 9.5 · EU 41,
... US M 10 / W 11.5 · EU 44, ... US M 13 / W 14.5 · EU 47.5, at Outlined (Etobicoke).
https://shopwithin.co/product/outlined/air-jordan-4-retro-og-white-cement-2025/8206119796936What to count on in every answer:
As of 10 November 2026:
Ask list_boutiques for the live list. More boutiques are joining, and the numbers above will age.
No tool adds to a bag, holds an item, takes a payment or places an order. This is the finding half of shopping through an agent. The paying stays between the shopper and the boutique.
visual_search matches a photo in memory and drops it. Nothing is saved.If your platform takes an API and not an MCP server, the same tools answer at https://shopwithin.co/api/v1. The OpenAPI document is at https://shopwithin.co/openapi.json.
curl -s "https://shopwithin.co/api/v1/pieces?query=black+leather+loafers&price_max=600&limit=3"The server card is at https://shopwithin.co/mcp/server-card.
Yes. There is no account, no key and no charge. The only limit is the rate: a burst of 60 requests from one address, then one a second.
It is an MCP server you reach at a web address, not one you install. You give your assistant or app the address, https://shopwithin.co/mcp, and it can call the tools. Nothing has to run on your own computer.
No. The tools only read. Every answer carries the item's page on shopwithin.co, and you buy there, through the boutique's own checkout.
Each item carries stock_checked_at, the time within last read the boutique's own stock. Stock moves by the hour, so the product page, read fresh when you open it, is the final word.
Items you can buy come from the boutiques that sell on within, which today are in and around Toronto. The directory of independent shops covers more than 140 cities.
Designer clothes, shoes, sneakers, bags, jewellery, watches and home objects, new and pre-owned, from independent boutiques. It does not cover department stores or mass market shops.
No. visual_search matches the photo in memory and drops it.
No.
No. This repo holds the docs, the local bridge, the registry file and the plugin. The server itself runs at shopwithin.co, and its code is not published.
| Path | What it is |
|---|---|
bin/within-mcp.mjs | The local bridge: MCP over stdio on your computer, passed to the hosted server |
docs/TOOLS.md | Every tool with its full description and inputs, written from the live server |
examples/ | Settings files and curl calls to copy |
server.json | The file published to the official MCP registry |
plugins/within/ | The within plugin: the server's address and one skill on how to shop the boutiques well |
.mcp.json, skills/ | The same server address and skill at the root, for plugin directories that read a repo's root |
scripts/check.mjs | An end to end check of the bridge against the live server: npm run check |
scripts/build-tools-doc.mjs | Rewrites docs/TOOLS.md from the live server: npm run tools-doc |
It is in the official MCP registry as co.shopwithin/within, and on these lists:
Questions, a problem with an answer, or a boutique that wants to be listed: [email protected] or https://shopwithin.co/contact.
MIT, for everything in this repo. See LICENSE.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add within --transport http https://shopwithin.co/mcp{
"mcpServers": {
"within": {
"url": "https://shopwithin.co/mcp"
}
}
}code --add-mcp '{"name":"within","url":"https://shopwithin.co/mcp"}'Runs as a hosted service. Your client connects over the network and nothing is installed locally.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/within-mcp to learn what the "Within Mcp" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
| Name | What it does |
|---|---|
search_pieces | Search what is in stock right now at independent luxury boutiques: clothes, shoes, bags, jewellery, watches and home objects, new and pre-owned. Each result has the price in the boutique's currency, t |
get_piece | One item in full: its description, every size with live stock, photographs, the price and any markdown, whether it can be picked up in the shop or delivered, the boutique, the page to buy it, and a fe |
piece_fit | How one item fits: its own measurements (the boutique's, or the designer's chart for this style), the designer's body chart, fit notes and whether it runs small or large, the model's size and height, |
find_notes | within's own guides for a question: journal notes (how a designer's sizes run, where to shop in a city, what to wear to an occasion, how to tell real from fake) and edits (items picked around one idea |
trending_now | within's chart of the designer items trending at independent boutiques this week, updated daily: the ten leading items in order, each with its reason (Google searches, Pinterest searches, what boutiqu |
similar_pieces | Items like one item: the same look, the same department, across every boutique, in stock now. Use this when someone likes an item but wants alternatives, a lower price, another size, or another shop. |
list_boutiques | The independent luxury boutiques whose stock within sells, with neighbourhood, city, how many items each has live, opening hours, and whether a shopper can pick up in the shop or have items delivered. |
boutique_shelf | One boutique's stock right now, newest first, with sizes and prices; a query searches inside that shop only. Use this when someone names a boutique ('what does WDLT117 have', 'show me Utopia's sneaker |
visual_search | Items in the boutiques' stock that look like a photo: a screenshot, a street style shot, a product photo, or a TikTok or Pinterest link. It answers in two groups: items close enough to be the same or |
convert_size | 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 table |
estimate_duty | Work out what clothing, 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 m |
new_arrivals | The newest clothes, shoes, bags and jewellery to arrive at independent luxury boutiques, newest first, each with its price, the sizes in stock, the shop that has it and the shopwithin.co page to buy i |
on_sale | Designer clothes, shoes and bags marked down right now at independent luxury boutiques, each with its old price, the price now, how much is off, the sizes in stock, the shop and the shopwithin.co page |
gift_ideas | Gift ideas in stock at independent luxury boutiques: designer gifts for her, for him or for anyone, under a budget, each with its price, the shop and the shopwithin.co page to buy it, plus within's gi |
outfit_ideas | Outfit ideas within has already put together, for a question or an occasion in plain words: its edits ("Christmas outfits", "What to Wear to the Ballet"), its outfit pages ("Guidi outfits", "Winter ou |
wear_with | The clothes, shoes, bags and accessories in stock at independent luxury boutiques that go with one item: the same ones its shopwithin.co page shows in its "Wear with" row. Each comes with the part of |
boutique_directory | Independent boutiques and clothing stores in a city, from within's directory of about 8,700 shops in more than 140 cities. Each shop comes with the kind of shop it is, its street and neighbourhood, a |
boutique_details | One boutique from within's directory of independent shops in more than 140 cities: what kind of shop it is, its address and neighbourhood, its opening hours with the day they were read, its website an |
delivery_and_returns | Delivery, pickup and returns at the independent boutiques that sell on within. For one boutique: what delivery to a country costs and how long it takes, the price an item ships free from, the countrie |
delivered_price | What one item on within costs delivered to a country: the item's price, the boutique's own delivery price, and an estimate of the duty, tariffs, tax and fees, added up to the landed cost at the door. |
pickup_today | Clothes, shoes, bags and jewellery a shopper can buy on shopwithin.co and pick up in the shop: in stock now at independent boutiques that offer pickup, each with its price, the sizes in stock, the sho |
designer_guide | One designer or brand in one answer: who founded it, when, where it is from, who owns it and where it is made, each fact with its source; how many items independent luxury boutiques have in stock righ |
where_to_buy | Where to buy a designer, a named item or a style code. First the items in stock right now at independent luxury boutiques, each with the shop, the price, the sizes and the shopwithin.co page to buy it |
price_check | What a designer's item costs right now at independent luxury boutiques: how many are in stock, the lowest, middle and highest price, the used, second hand or pre-owned ones against the rest, the cheap |
brands_like | Designers like a given one, counted from live stock at independent luxury boutiques: the brands that the same boutiques stock and whose items are the same kinds (sneakers, jackets, bags, jewellery), m |
compare_pieces | Two to four items from independent luxury boutiques, side by side. For each: its name and designer, price and currency, condition, sizes in stock, the shop and its city, pickup and delivery, a line fr |
| Name | What it does |
|---|---|
find_in_my_size | Find an item that is in stock in your size at independent boutiques, under a price if you give one. |
where_to_buy | Who has a designer or an item in stock right now, and which boutiques stock it in a city. |
gift_ideas | Gift ideas that are in stock at independent boutiques, for the person and the budget you give. |
shop_a_city | The independent boutiques in a city, by kind, and which of them sell on within. |
what_is_my_size | Your size in another country's system, or in one designer's own chart. |
price_at_my_door | What one item on within costs delivered to your country, with delivery, duty and tax. |
| Name | What it does |
|---|---|
within-shelf | Renders a tool result as a photo-first shelf of pieces with the page to buy each one. |
guides | The journal: city boutique guides and field guides, one per line with its slug. |
about | One paragraph on within and how to use its tools. |
Read live from the server on November 15, 2026.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/within-mcp)Nothing comparable is listed yet.
v0.3.10.3.1Release notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "within-mcp" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.