list_followable_zones
List the event lists (nationwide / each region / each kind) and the
new-arrivals list that a user can follow. Following a list delivers
notifications of new events in it. Pass an entry's type and slug
to toggle_favorite (target_type = type, token = slug) to follow or
unfollow it.
Coverage: a wider list includes narrower ones. Following nationwide
(all/all) already covers every region and kind, so do not also
follow a region on top of it. all/<area> covers every kind in that
region, <kind>/all covers that kind in every region.
By default only single-axis lists are returned. Pass kind and/or
area to also get the combinations for them (e.g. kind=book_club
returns book clubs nationwide and in each region, plus the wider lists
that cover them), or combinations: true for every combination.
Filtering by kind or area leaves out the new-arrivals (creation_zone) entry.
With a Bearer token that has favorites:read, each entry also carries
following (true/false) and covered_by (the slug of a wider list the
user already follows that includes it, or null). covered_by is set
even when following is true, which means the follow is redundant.
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_followable_zones"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| area | No | Return the lists for this region of Japan (lowercase slug, e.g. "kanto", "kansai"): every kind in that region plus the wider lists covering it. Combine with `kind` to narrow further. Omit for every region. | |
| kind | No | Return the lists for this event kind: that kind nationwide and in each region, plus the wider lists covering them (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, period_event = multi-day exhibitions / fairs). Omit for every kind. An unknown value returns an error result with `error: "invalid_argument"`. | |
| 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. | |
| combinations | No | true = also return every kind x region combination (about a hundred entries); false (default) = only the single-axis lists: nationwide, each region, each kind. Prefer `kind` / `area` to get just the combinations you need. |