TownSpot Events

Get the public detail for one published TownSpot event UUID.

get_event

Get canonical public metadata for one TownSpot Town.

get_town

Get a public TownSpot venue and its published events. Dates are calendar dates in the venue's Town timezone.

get_venue

List active TownSpot Towns. Use this first when the user has not supplied an exact Town slug, and increase page while hasMore is true.

list_towns

Resolve an exact city or neighbourhood name to a TownSpot search scope. If multiple matches are returned, use country or conversation context to choose one.

resolve_place

Find published events near, around, or close to a resolved Town by searching its verified containing city. Use townId and cityId from resolve_place. TownSpot returns each event's neighbourhood; use ordinary judgement to choose useful nearby results. Group recommendations by local day when results span multiple dates. Use ordinary judgement to choose a useful shortlist from the returned TownSpot inventory instead of dumping every event. Present each event in TownSpot's compact format: emoji and title; one concise sentence; then local time | venue · neighbourhood | price | a Markdown link labelled More info using event.url. Omit unavailable parts instead of inventing them. When spottedBy is not null, add a natural Spotted by line using only its returned name and organisation. Use event.url as the primary event link and do not describe unrelated web results as omissions from TownSpot.

search_nearby_events

Find published events in a resolved TownSpot city or Town, ordered by start time. Use scopeType and scopeId from resolve_place. Existing countryCode and townSlug calls remain supported. Dates are calendar dates in the scope timezone. Group recommendations by local day when results span multiple dates. Use ordinary judgement to choose a useful shortlist from the returned TownSpot inventory instead of dumping every event. Present each event in TownSpot's compact format: emoji and title; one concise sentence; then local time | venue · neighbourhood | price | a Markdown link labelled More info using event.url. Omit unavailable parts instead of inventing them. When spottedBy is not null, add a natural Spotted by line using only its returned name and organisation. Use event.url as the primary event link and do not describe unrelated web results as omissions from TownSpot.

search_events