Partymate

Ask

One-shot natural-language nightlife/events discovery. Hand it a whole question — "cool techno this week in hamburg", "where can I see Keinemusik", "venues like Berghain", "something fun in miami this weekend" — and it does the work end to end: picks the right searches, resolves cities, applies date windows (tonight/this weekend/this week), and returns a narrated `answer` plus the real `events` and `pages` it was grounded in (never invented). Pass `user_id` to personalize (taste-bias + re-rank);

Search

[fallback] Global trigram-ranked disambiguator for ONE ambiguous string when you truly don't know whether it's an artist, venue, event, or city (e.g. 'is Scorpios a club or a brand?'). PREFER resolve_taste_references whenever the user is naming things they like (one or many) — it covers pages AND events in one call with confidence scores and feeds straight into build_user_anchor. PREFER search_pages / search_events when you already know the entity type. Only reach for `search` when no other tool

Search Events

Literal event lookup by filters (name, genre, location, date range, artists, collectives, venue, minCoolness). Use ONLY for direct factual queries with NO taste inference: 'events in Berlin this weekend', 'which Keinemusik shows are in July', 'shows at Hï Ibiza in August'. NOT for taste-based recommendation — if the user is describing what they like or asking you to plan based on their taste, route through resolve_taste_references → build_user_anchor → plan_group_trip / score_events_for_users in

Get Event

Get full details for a specific event by numeric ID or slug. Returns hosts, performers, venue, ticketing, crowd, dresscode, weather, and more. Use after search_events to get complete info on a specific result.

List Upcoming Events

List upcoming events from featured hosts, ordered by start date. Use this for operational overviews ('what's coming up?'). For targeted user searches, use search_events. For tonight specifically, use get_tonight_events. Supports pagination via offset.

Get Tonight Events

Get events happening tonight in a city or near a location. Best tool for 'what's happening tonight?', 'events right now', or 'what's on this evening'. Auto-calculates the time window based on timezone (before 6PM: shows from 6PM tonight; after 6PM: shows now until 6AM). Prefer this over search_events with manual date filters for tonight queries.

Get Cities

Get all cities that have venues/pages in the system, with venue counts. Use to discover available cities before searching events or pages by location. No parameters needed.

Get Competitor Events

[niche] Promoter-side market analysis only. Returns upcoming events from competitor/related venues grouped by date with weather data. Use ONLY when a promoter explicitly asks about competition around a specific venue. For a venue's own event calendar use search_events(venue=…); for venue details use get_page.

Get Guest List

Get guest list entries for an event with names and statuses. Use get_guest_list_stats for aggregate numbers instead of fetching the full list.

Get Guest List Stats

Get aggregate guest list statistics (total, approved, checked-in, declined counts). Faster than get_guest_list when you only need numbers, not names.

Get Event Stats

Get comprehensive event engagement metrics: RSVPs, check-ins, impressions, saves, calendar adds, ticket clicks, shares. Use for performance analysis of a specific event.

Search Pages

Search for venues, clubs, organizers, and artist pages by name, genre, location, category, or tags. Returns personalization scores when user profile is available. Use for user-facing queries like 'find techno clubs in Amsterdam'. Supports pagination via offset.

Get Page

Get full details for a venue/organizer/artist page by ID or slug. Returns enriched data including place info, peak times, door strictness, reviews, images. Use after search_pages to get complete info.

List Pages

List pages filtered by genre, location, category, or featured status. Use for browsing ('show me clubs in Berlin') rather than targeted search. Supports pagination via offset.

Get Similar Artists

Find artists similar to a given one by genre + tag profile (cosine similarity, recency-weighted). Use when the user says 'artists like X', 'more like Keinemusik', 'who sounds like Argy'. Takes an artist's page ID (resolve name → ID via search_pages with category='People' first). Score is in [0,1], 1 = identical profile.

Get Similar Venues

Find venues similar to a given one by the genres + tags of their events (cosine similarity, recency-weighted). Use when the user says 'venues like Scorpios', 'clubs with a similar vibe to Hï', 'alternatives to Berghain'. Takes a venue's page ID (resolve name → ID via search_pages first).

Get User Taste Profile

Get a user's top artists, venues, organizers, genres, tags, and budget tier. Use this as the first step when the user asks for personalized recommendations or says 'what should I do this weekend?' / 'plan me a trip' — feed the top_artists and top_venues into search_events (as artists[] / venue) or into find_similar_pages to walk the graph. For group queries, call once per user and aggregate.

Expand Collective

Walk the label/roster bridge. Given a collective name (or slug / alias) — e.g. 'Keinemusik', 'Afterlife', 'Circoloco' — returns the full member roster with page_ids. Feed the member names into search_events(artists=[…]) to find events where any of them are playing. Currently seeded: Keinemusik, Diynamic, Afterlife, Circoloco, Innervisions, Drumcode, Anjunadeep, Hot Creations, No Art, Solomun+1, Paradise.

List Collectives

List every seeded collective with its member_count. Useful to show the user what labels/series are available to query, or to discover a collective when the name isn't remembered.

Score Events For Users

Score a batch of events for a group of users. Returns per-event {group_score (sum), min_score (Rawlsian — worst user's fit), avg_score, per_user map}. Use this after search_events to rank the candidates by group satisfaction when planning a trip for multiple people. The score combines: user-host matches (weighted 2x) > coolness bonus (5x) > genre + tag overlap (1x). To pick the event that leaves no one behind, rank by min_score; to maximize total happiness, rank by group_score.

Plan Group Trip

Super-tool: given a group of members, candidate date windows, and candidate cities, returns a ranked list of window+city plans with nightly picks. Members can be real PartyMate users ({kind:'user', userId}) OR anchors ({kind:'anchor', anchorId, preferences}) — use anchors when the caller is planning a trip for friends who aren't yet registered. Build each anchor's preferences by calling build_user_anchor first, then drop the returned `member` into members[]. Mixed groups (some users, some anchor

Discover For Me

★ ONE-SHOT personalised discovery — the leanest path from taste to recommendations. Input: 2+ artist/venue names + a city + a date window. Output (single payload): (1) inferred taste profile (top genres / tags / scenes / rhythm / budget), (2) top venues in the city ranked against the profile (with prestige tier + scene tags), (3) top artists in the city in the window scored against the profile (with booking tier), (4) top events in the city in the window with personalisation scoring. Internally

Resolve Taste References

★ ALWAYS THE FIRST STEP when the user names things they like. Fuzzy-matches free-text names against pages (artists, venues, organizers, collectives — any category) AND events in one call, returning real page_ids / event_ids with confidence scores. Trigger phrases: 'I like…', 'I love…', 'I'm into…', 'plan me a trip based on…', 'find events for someone who likes…', or any sentence naming specific artists/venues/events as taste signals. Always show the matches to the user and confirm ambiguous ones

Expand References

[advanced] Optional neighbor-expansion step — only use when the user explicitly wants to see similar artists/venues before the anchor is built (e.g. 'show me who else sounds like them before you plan'). For normal discovery flows, discover_for_me already handles resolve → anchor → recommend in one call; do NOT insert this tool between them. For each resolved reference page_id, returns similar pages via recency-weighted cosine similarity over genre + tag profile, with cross_referenced entries tha

Build User Anchor

Builds a taste-profile anchor for a friend who isn't a registered PartyMate user, ready to drop into plan_group_trip.members[]. TWO INPUT PATHS: (1) PREFERRED — pass `referencePages` (artist/venue/collective page_ids) and/or `referenceEvents` (event_ids); the server fetches each reference's recent events, aggregates their tags/genres/hosts/budget/coolness/popularity into a real taste vector. (2) FALLBACK — pass `tagNames`, `genres`, `hostNames`, and coarse buckets (`specialScorePreference`, `pop