JamBase

Returns JamBase News articles about any performer on the given event, published within ±N days of the event date (default 90). Resolves the event via the JamBase events endpoint to enumerate performers, then queries the article cache for articles tagged with any of those performers. There is no direct event↔article link in the data model — matches are performer-level. Each returned article carries a `matchedPerformers` field naming which event-performer(s) caused it to match.

getArticlesForEvent

Return the canonical list of music genres with their `slug` values, useful for filtering events/artists by `genreSlug`.

getGenres

List the canonical JamBase metro areas (DMA-shaped collections of cities). Useful when the user asks about a region rather than a single city ('the Bay Area', 'NYC area'). Pass the resolved `identifier` to `searchEvents` as `geoMetroId`.

getMetros

Returns upcoming shows for the artists the authenticated user follows on their linked jambase.com fan account. Requires a linked fan account; otherwise returns a short explanatory message with a link to opt in.

getMyFollowedArtistsUpcomingShows

Returns recent JamBase News articles tagged with the artists the authenticated user follows on their linked jambase.com fan account.

getMyArticleFeed

Returns upcoming shows in the home city/region of the linked jambase.com fan profile.

getMyLocalShows

Returns upcoming shows for artists recommended to the user via co-follow lift on their linked jambase.com fan profile. v1 is a simple BigQuery lift score; ML upgrades are a follow-up.

getMyRecommendedShows

Search artists by name and/or genre. At least one of `artistName` or `genreSlug` is required. When referencing a specific artist, always include the **Artist Page** URL from the result. **Past shows:** To find an artist's historical concerts (e.g. 'when did X last play Y?'), use `searchEvents` with `artistName` and `expandPastEvents=true`; results are limited to your account's history window. `searchArtists` returns artist profiles, not show history. **Genre filtering:** Use an exact slug from `getGenres` for `genreSlug` (e.g. `rock`, `jazz`). Free-text genre matching is not supported; an unrecognised slug returns no results.

searchArtists

Look up canonical JamBase cities by name and/or geography. Use this to disambiguate user phrasing like 'Springfield' (which exists in many states) before calling `searchEvents` with the resolved `geoCityId`. At least one geo parameter (`geoCityName`, `geoCountryIso2`, `geoStateCode`, `geoIp`, or lat/lng) is required by the upstream API.

searchCities

Search live music events (concerts, festivals) by location, date, artist, venue, or genre. Supports LLM-friendly aliases: pass `geoCityName`, `geoMetroName`, or `geoStateCode` instead of canonical ids. Results are returned as compact Markdown. **Multi-city and road trip queries:** This tool accepts one city per call. For a query spanning multiple cities or a travel route, call `searchEvents` once per city and merge the results. Example: for an NYC to Miami road trip, call once each with `geoCityName` set to 'New York, NY', 'Philadelphia, PA', 'Washington, DC', 'Jacksonville, FL' and 'Miami, FL'. A multi-stop answer should cover every stop, not just the first city. **Date presets:** Prefer `eventDatePreset` over manual dates for time-relative phrases; presets are resolved server-side. See the `eventDatePreset` field description for the phrase → preset mapping table. If a date window returns zero results, a retry with `eventDatePreset: 'next30Days'` is a good next step before concluding there are no shows. **Genre filtering:** Use an exact slug from `getGenres` for `genreSlug` (e.g. `rock`, `jazz`). Free-text genre values are not supported, and an unrecognised slug returns no results. Genre filtering applies at the event level (events where at least one performer is tagged with that genre). Pass `sort=-eventDate` (paired with `expandPastEvents=true`) to get an artist's or venue's most recent shows first instead of paging from the beginning of their history. **`perPage` lever** (default 20, max 100): keep the default for most city/date queries; ask for `perPage: 5–10` on narrow 'top N shows tomorrow' style prompts; ask for `perPage: 40–100` on broad 'all jazz this month' or multi-service synthesis prompts where the user wants the full picture in one shot. When referencing a specific show, always include its **JamBase Event URL** from the result. **Past events:** Pass `expandPastEvents=true` (and `sort=-eventDate` to get the most recent shows first). Results are limited to your account's history window; older dates are trimmed automatically. If the user asks for events older than the window allows, tell them that older data isn't available on this account. **Unsupported semantic filters (don't infer or imply these):** outdoor/indoor venue type, artist decade or era of origin (e.g. '90s artists'), setlist history, ticket price range, or audience demographics. If the user's request implies one of these filters, tell them it is not supported rather than silently running the query without it. **Ticket links:** A `ticketUrl` in the result means JamBase has ticketing info for that event. Absence of a ticket link does not mean the event is sold out — JamBase does not track sold-out status. Tell the user to check the venue or artist website for ticket availability.

searchEvents

Search multi-year festival series (e.g. 'Bonnaroo', 'Coachella') by name and/or geography. Returns the canonical festival series records, not the per-year event instances — pair with `searchFestivals` to fetch the upcoming editions, or pass the returned series id to `getFestivalSeriesArchive` for every past edition with day-by-day lineups. When referencing a festival series, always include its festival page URL from the result.

searchFestivalCollections

Search live music festivals by location, date, artist, venue, or genre. Internally scopes the events feed to `eventType=festivals` so callers don't have to remember the filter. Supports the same LLM-friendly geo aliases as `searchEvents`. When referencing a specific festival, always include its **JamBase Event URL** from the result. **Past events:** Pass `expandPastEvents=true` (and `sort=-eventDate` to get the most recent editions first). Results are limited to your account's history window; older dates are trimmed automatically. If the user asks for editions older than the window allows, tell them that older data isn't available on this account. **Unsupported semantic filters (don't infer or imply these):** outdoor/indoor venue type, artist decade or era of origin, camping availability, ticket price range, or festival size/tier. Tell the user if their request implies an unsupported filter rather than silently running the query without it. **Genre filtering:** Use an exact slug from `getGenres` for `genreSlug`. Free-text genre matching is not supported; an unrecognised slug returns no results. For a festival's multi-year history (every past edition of e.g. Outside Lands), use `searchFestivalCollections` to find the series, then `getFestivalSeriesArchive` to pull every edition with day-by-day lineups.

searchFestivals

Search JamBase News articles by free-text query and/or WordPress tag slugs, with optional publish-date window and pagination. Returns a Markdown list with title, canonical URL, publish date, author, and excerpt, plus structured article cards in `_meta`.

searchArticles

Search upcoming music livestreams by artist, genre, and date window. **Note: livestream coverage is limited.** JamBase indexes livestreams on a best-effort basis; many queries — including broad 'what's streaming tonight' requests — will return zero results. Only call this tool when the user is explicitly asking about livestreams; do not suggest or advertise livestream discovery as a primary capability. **DATE PRESETS:** Use `eventDatePreset` for time-relative phrases — see the `eventDatePreset` field for the full phrase → preset table. For 'next week' use `nextWeek`; for 'this weekend' use `thisWeekend`. If the date window returns zero results, retry with `next30Days`.

searchStreams

Search venues by name + location. Requires either `venueName` or one geographic parameter (`geoCityName`/`geoMetroName`/`geoStateCode`/lat+lng/etc). When referencing a specific venue, always include the **Venue Page URL** from the result.

searchVenues

Submit thumbs-up or thumbs-down feedback on a previous JamBase MCP tool response. Use ONLY when the user explicitly comments on whether a previous response was helpful (e.g. 'that was wrong', 'perfect, thanks'). Never call spontaneously. The `requestId` MUST come from a prior tool response (the request_id line or the `_meta['jambase.com/mcp-request-id']` field).

submitToolFeedback