Search menus
search_menusFind dishes and drinks by name on the menus Dim Hour has verified from venues' own sites, in one city. Each result names the venue, the dish, its printed price (null when the menu prints none), the menu and section, and source_line, the same source and check date the venue page prints. Only verified menus are searched: a venue whose menu nobody has verified never appears, so zero results means no verified menu lists the dish, not that no venue serves it. Terms match at word starts, in the dish name first and then its description (matched_in says which). Optional filters: max_price keeps rows whose ONE printed price is at or under it (a row with no printed price, or several, never matches and is counted in unpriced_excluded); kind is food or drink; menu matches the printed menu name, e.g. 'happy hour'. total_matches counts the filtered rows. Past 90 days a menu is stale and its rows say so. At most 50 results per call; truncated says how many more matched. Prices and dishes change: confirm with the venue before relying on them.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"city": "<city>",
"query": "<query>"
},
"name": "search_menus"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | Yes | City name or key | |
| kind | No | Only food or only drink sections | |
| menu | No | Printed menu name, e.g. 'happy hour', 'brunch' | |
| limit | No | Results to return (default 20) | |
| query | Yes | A dish or drink, e.g. 'guacamole', 'espresso martini' | |
| max_price | No | Highest printed price, in the menu's currency, e.g. 12 |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | Yes | ||
| query | Yes | ||
| terms | Yes | ||
| status | Yes | ||
| filters | No | ||
| reasons | Yes | ||
| receipt | Yes | ||
| results | Yes | ||
| skipped | Yes | ||
| city_name | Yes | ||
| truncated | No | ||
| snapshot_id | Yes | ||
| total_matches | Yes | ||
| policy_version | Yes | ||
| venues_matched | Yes | ||
| venues_searched | Yes | ||
| stale_after_days | Yes | ||
| unpriced_excluded | No |