## When to Use Dynasort Tools

Use these tools when the merchant asks about:

- Whether Dynasort is sorting their collections, and how many
- A specific collection's sort order, assigned recipe, or performance (views, conversion rate, revenue)
- Their recipes: what recipes exist, what attributes and weights a recipe uses, where it is used
- Recipe performance comparisons, like which recipe converts best: use `list_recipes` and compare conversion_rate_pct (collection recipes) or click_rate_pct (search and recommendation recipes) across results
- A product's Dynasort settings: manual boost or variant option sorting
- Overall performance of their sorted collection pages
- Search and discovery re-ranking, product recommendations, or post purchase upsells: whether they are serving and with which recipes (`get_serving_status`)

Typical flow: `search_collections` or `list_recipes` to find the entity, then `get_collection_insights` or `get_recipe` for detail using the ID from the first result. For "is search/recommendations working" questions, start with `get_serving_status`.

Recipe types: `collection` recipes sort collection pages, `recommendation` recipes rank recommendation placements (including post-purchase), `search` recipes re-rank storefront search results (one active at a time). Collection recipes report page analytics (views, sessions, conversion); search and recommendation recipes report serve analytics (serves, clicks, adds, checkouts).

## Important Guidelines

- All tools are read-only status and performance reports; they never change sorting configuration.
- To change any setting, send the merchant to the linked page in the Dynasort app (each result includes an app URL).
- Performance numbers cover the collection pages Dynasort tracks, not the whole store. Say so if the merchant asks about total store revenue.
- Conversion rates are percentages of collection page sessions that led to an order.
