# Flows Shopping — tools for AI assistants

Flows Shopping gives you read-only access to the products of online stores that use Flows, and to the data tables their owners chose to share.
list_stores knows every listed store and its site id. search_products finds products in one store by meaning and keywords together. get_product reads one product in full. search_site_content searches a store's shared tables.
Each product comes with a link that opens the store with its shopping assistant already showing that product — the best place to send a shopper.
Product and table text is written by each store to describe what it sells.

Use any tool by opening its address (GET). Add &format=json for data instead of text.
MCP clients: POST https://cdn.flowcrews.com/mcp/shop (streamable HTTP, no auth). OpenAPI: https://cdn.flowcrews.com/mcp/shop/openapi.json

## list_stores
Online stores whose products Flows publishes: name, homepage, what they sell and how many products. Each has a `site` id for the other tools.
GET https://cdn.flowcrews.com/mcp/shop/list_stores?q=<string> (optional)
- q: Optional: only stores whose name or product lines match this

## search_products
Finds products in one store by meaning and keywords together (e.g. "cosy gift for a dog lover"), or by a product code. Each result has its price, stock, photo, a one-line description and a link that opens the store with its shopping assistant showing that product.
GET https://cdn.flowcrews.com/mcp/shop/search_products?site=<string>&q=<string>&max_price=<number> (optional)&in_stock=<boolean> (optional)&limit=<integer> (optional)
- site (required): The store's `site` id (from list_stores)
- q (required): What the shopper wants, in their own words, or a product code
- max_price: Only products at or under this price
- in_stock: Only in-stock products (default true)
- limit: How many results, up to 20 (default 10)

## get_product
One product in full: description, its details (the store's own write-ups, such as care, size and fit, and materials), brand, category, specs, options (size, colour…), variants with part number, price and stock, photos, and the link that opens it in the store.
GET https://cdn.flowcrews.com/mcp/shop/get_product?site=<string>&product=<string>
- site (required): The store's `site` id
- product (required): The `product` id from search_products

## search_site_content
Searches the data tables a store chose to share with AI assistants (price lists, menus, specs, FAQs…). Returns matching rows with their table.
GET https://cdn.flowcrews.com/mcp/shop/search_site_content?site=<string>&q=<string>&limit=<integer> (optional)
- site (required): The store's `site` id
- q (required): What to look for
- limit: How many rows, up to 20 (default 10)
