Volantini in corso
list_current_flyersUse this when the user asks which store flyers (volantini) are valid right now in Italy, whether a chain has a flyer this week, or until when a flyer is valid, optionally only for chains with a store near a city or near the position of the user. Returns chain, validity dates, number of offers, distance and address of the nearest store and the link to the flyer on prezzinvista.it. Covers Italy only. Products inside the flyers are what search_flyer_offers looks up. In hosts that support MCP Apps the results are also shown to the user as cards with logo, validity and link.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_current_flyers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | Italian municipality (comune) to search around: where the user is, or the place they ask about, e.g. "Milano", "Reggio Emilia", "Sesto San Giovanni". Only flyers valid in stores within radius_km of its centre are returned. Without a place the search covers all of Italy. | |
| limit | No | Flyers to return (default 30). Nearest first with a city or coordinates, largest first otherwise. | |
| store | No | Only the flyers of this chain, by name: e.g. "Lidl". | |
| near_me | No | Whether to search around the approximate position of the user that some clients share with the call (ChatGPT does). When omitted, that position is used if the call names no city and no coordinates. true: the same, and the answer is an error when no position came with the call. false: all of Italy. | |
| latitude | No | Latitude of the position of the user (WGS84, decimal degrees), together with longitude. Distances are then measured from this point, and only flyers valid in stores within radius_km of it are returned. Takes precedence over city. Used for this answer only, never stored. | |
| longitude | No | Longitude of the position of the user, together with latitude. | |
| radius_km | No | How far to look around the city centre or the coordinates, in km (default 15). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | The municipality passed, or the nearest to the coordinates | |
| note | No | ||
| flyers | Yes | ||
| source | No | Who to credit for the data | |
| radius_km | No | The radius searched around the place, in km | |
| source_url | No | The page on prezzinvista.it with these flyers and their offers: the URL to cite | |
| updated_at | No | When the flyers were last read (ISO 8601). They are read again every three hours | |
| total_flyers | Yes | ||
| total_offers | Yes | ||
| place_assumed | No | true when the call named no place and the search was limited to the position shared by the client | |
| distances_from | No | What distance_km is measured from: the coordinates passed, the approximate position shared by the client (near_me), or the centre of the city |