NA Drink Finder

Compare two to four returned drink IDs using recorded ABV, nutrition, styles, tasting notes and community ratings. Does not invent missing values or make health claims. Return data first. When a map, cards or comparison would help, call render_results with the returned IDs and exact search context.

compare_drinks

Render drink cards, a venue map or a comparison after calling ChillMaps search, detail or comparison data tools. Pass only exact returned IDs in the desired order, at most 20 (comparisons 2 to 4), and copy the exact returned search context to preserve filters and pagination. Records are refreshed from the catalog. Never invent IDs or pass full records, names, ratings, URLs or coordinates. Empty venue IDs without a destination open the city picker. Rendering a chosen subset or different order omits pagination to avoid adding unselected results.

render_results

Resolve a public city or neighborhood named by the user, or entered in the ChillMaps city picker, into public area candidates. Returns data only and does not open a map. Use the id of a clearly matching result as area_id in search_venues, preserving any supplied region or country. If matches are missing or ambiguous, ask the user to choose the intended public area instead of guessing or using the host current city. Do not send a personal address or device GPS coordinates.

search_areas

Search the ChillMaps non-alcoholic drink catalog by name, brand, style, ingredients or taste words. Use for NA stouts, fruity mocktails, zero-alcohol beer or other drink recommendations. Ratings are recorded community scores, not universal rankings. No purchasing or account access. Return data first. When a map, cards or comparison would help, call render_results with the returned IDs and exact search context.

search_drinks

Legacy compatibility venue search for existing NA Drink Finder clients without the modern search tools. Opens its retained map immediately and supports category and venue-type filters, but not exact drink or brand filters. When search_areas and search_venues are available, use those data tools and then render_results instead. Do not use this legacy tool as a preliminary city lookup for a modern search. An unresolved or ambiguous destination requires the city picker; never substitute the host current city for a named destination. For drink recommendations use search_drinks. Do not send a home address or device GPS.

find_na_beverages

Find bars, restaurants or stores in a public destination area, optionally matching an exact drink or brand. For an explicitly named destination, obtain area_id from a clearly matching search_areas result unless a matching ChillMaps area ID is already known. If unresolved or ambiguous, open the city picker with render_results and preserve filters. Do not call this tool without area_id for a named destination: absent IDs use the host current area and must not replace the requested place. Apply every requested drink, brand, category and venue-type filter before rendering the results. Include the recorded category when the resolved drink or brand establishes one; do not invent a category for an unknown or mixed brand. Do not call find_na_beverages to resolve a city; it opens a preliminary compatibility map. Without a named destination, nearby requests may use host-shared coarse location or return needs_location. Exact products require listed product matches; brand stockists do not prove every product. No live stock guarantee. Return data first. When a map, cards or comparison would help, call render_results with the returned IDs and exact search context.

search_venues

Read a non-alcoholic drink by a returned catalog ID, including recorded ingredients, nutrition, tasting notes and ratings when available. Unknown values stay unknown. Return data first. When a map, cards or comparison would help, call render_results with the returned IDs and exact search context.

get_drink

Read a public venue and its listed non-alcoholic drinks by a returned venue ID. Listings are not a guarantee of current stock. Closed or inactive venues are excluded. Return data first. When a map, cards or comparison would help, call render_results with the returned IDs and exact search context.

get_venue

After the user pans or zooms the map and chooses Search this area, read matching non-alcoholic venues within that public viewport. Bounds describe the displayed map, not the user's GPS location or home address. Zoom in to a view at most 1.5 degrees across. No live inventory guarantee.

browse_map

Find matching non-alcoholic venues after the user selects a public city in the widget.

select_area