list_events_by_place
List upcoming and ongoing Zindies events held at a specific place (shop/venue), identified by its public token. Same semantics and response shape as list_events, but scoped to one place. Default range: today through 60 days ahead.
The response also carries calendar: a subscribable iCal feed of this
place's upcoming events (ics_url, plus webcal_url for Apple
Calendar / Outlook and google_calendar_url to add it to Google
Calendar). When the user wants to import, subscribe to, or sync a
place's events into their calendar app, hand them these URLs instead
of copying events one by one — the feed stays up to date as the place
adds events. Note this is distinct from the place's opening-days
calendar (business_hours.calendar.ics_url on get_place).
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": {
"place_token": "<place_token>"
},
"name": "list_events_by_place"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Last day of the range, inclusive (YYYY-MM-DD, e.g. "2026-12-31"). Default: `from` + 60 days. For one specific day pass the same date as `from`. A value earlier than `from` returns no events. | |
| from | No | First day of the range, as an ISO 8601 calendar date in Japan time (YYYY-MM-DD, e.g. "2026-12-05"; no time or timezone part). Default: today. A multi-day event already under way on this day is included. A past date returns past events. An unparseable value falls back to the default. | |
| kind | No | Return only events of this kind (non_genre = general ZINE event, zine_making = ZINE-making workshop, author = author event (talk, signing), festival_style = fair / market with many booths, zine_cafe = ZINE cafe, book_club = book club, utakai = tanka poetry gathering). Omit for every kind. Combined with `event_type` and the date range by AND. | |
| limit | No | Maximum number of events to return, soonest first. Default 20, max 50. There is no cursor: when `count` equals `limit` there may be more, so call again with `from` set to the start date of the last event returned. | |
| locale | No | Response language for translatable text fields (names, titles, descriptions): ja = Japanese, en = English, ko = Korean, zh-TW = Traditional Chinese. Pass the language the user is conversing in when it is one of these; otherwise omit it. Fields without a translation fall back to their source language (usually Japanese), so one response can mix languages. Tokens, ids, dates and URLs are the same in every locale. Default: ja. | |
| event_type | No | `day` = single-day events (they have `started_at` / `ended_at`), `period` = multi-day exhibitions and fairs (`start_date` / `end_date`), `all` = both (default). Combined with the other filters by AND. | all |
| place_token | Yes | Public token of the place: a short lowercase string such as "fqpi", the `token` field of a place from search, find_places_nearby, get_place or an event's `place.token`. Not the numeric `id` or the shop name. An unknown or non-public token returns an error result with `error: "not_found"` (a place with no matching events returns `events: []`, not an error). |