Every small shop.
One MCP address.
Shelf speaks the Model Context Protocol over streamable HTTP. Add one URL to Claude, ChatGPT, Cursor or your own agent and it can browse and buy from every shop here. No API key.
https://shelf-pinnaclecryptngs-projects.vercel.app/mcpWant to see it first? Watch the demo agent shop →
{
"mcpServers": {
"shelf": {
"url": "https://shelf-pinnaclecryptngs-projects.vercel.app/mcp"
}
}
}or one shop only
https://shelf-pinnaclecryptngs-projects.vercel.app/s/{slug}/mcp
Tools
find_shops
Find shops by what they sell, city or country.
query, city?, country?
search_all_products
Search every shop's products, with an optional price cap and currency.
query, max_price?, currency?
get_shop_info
Name, location, fulfilment and policies for one shop.
shop
search_products
Products, prices and stock for one shop.
shop, query?
create_checkout
Builds a PayPal order from product IDs and quantities. Returns an approval link and a server-side total.
shop, items[], buyer_note?
get_order_status
CREATED → APPROVED → PAID → SHIPPED. Only call it paid when this says PAID.
order_id
The payment rule
Agents never complete a payment. Totals always come from the shop's own prices, so a hidden instruction on a web page can't change what gets charged.
1 · Agent
create_checkout
Shelf prices the basket from the shop's own catalogue and opens a PayPal order.
2 · Buyer
approve_url
A person reviews the order in PayPal and approves it. Agents can't do this step.
3 · Shelf
capture
Shelf captures the payment, decrements stock and notifies the shop.
4 · Agent
get_order_status
Returns PAID. Only now may the agent say the order is paid.
Single-shop endpoints
Every shop also has its own MCP server, plus a feed.json and llms.txt for crawlers.
- Marigold KitchenToronto · Canada
https://shelf-pinnaclecryptngs-projects.vercel.app/s/marigold-kitchen/mcp - Mori Tea WorksKyoto · Japan
https://shelf-pinnaclecryptngs-projects.vercel.app/s/mori-tea-works/mcp - Kiln & TideLisbon · Portugal
https://shelf-pinnaclecryptngs-projects.vercel.app/s/kiln-and-tide/mcp - Fernhill BakehouseBristol · United Kingdom
https://shelf-pinnaclecryptngs-projects.vercel.app/s/fernhill-bakehouse/mcp