List events and programs
list_eventsFind library events and programs such as storytimes, book clubs, classes, and author talks by branch, date range, audience, and event type; get start/end times and registration requirements.
Instructions
Find events and programs at a library: storytimes, book clubs, classes, author talks. Filter by branch, date range, audience (e.g. kids, teens, adults) and type. Returns typed events with local start and end times and whether registration is required.
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_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Results page, up to 20 events per page. | |
| limit | No | Return at most this many events from the page. Use a small number when you only need the next few. | |
| query | No | Keywords to search event titles and descriptions. | |
| branch | No | Only events at this branch (name or code). | |
| library | No | Library system id such as "tpl" (Toronto), "vpl" (Vancouver), "chipublib" (Chicago). Get it from find_library. A city or library name also works. | |
| audience | No | Audience name, matched loosely, e.g. "school age", "teens", "adults". Valid values are returned in available_filters. | |
| end_date | No | Last day to include (YYYY-MM-DD). | |
| event_type | No | Event type, matched loosely, e.g. "book club", "crafts". Valid values are returned in available_filters. | |
| start_date | No | First day to include (YYYY-MM-DD). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | ||
| pages | Yes | ||
| total | Yes | ||
| events | Yes | ||
| source | Yes | Provenance of the data. | |
| library | Yes | ||
| available_filters | Yes | Valid values for the audience and event_type inputs at this library. |