findArtistAndFetchEvents
ChatGPTPREFERRED tool when an agent wants events for a specific artist by name. Looks up the artist by artistName, then runs searchEvents against the matched artist id. Combines two upstream calls so the agent doesn't have to chain them manually. `perPage` lever (default 100, max 100): an artist tour is a finite enumerable set the user almost always wants in full ('show me all Goose dates'), so the default fills the schema ceiling. Drop to perPage: 5–10 only when the prompt is explicitly 'next show' or 'tonight' style. When referencing a specific show, always include its JamBase Event URL from the result.
findArtistAndFetchEvents
ChatGPTPREFERRED tool when an agent wants events for a specific artist by name. Looks up the artist by artistName, then runs searchEvents against the matched artist id. Combines two upstream calls so the agent doesn't have to chain them manually. `perPage` lever (default 100, max 100): an artist tour is a finite enumerable set the user almost always wants in full ('show me all Goose dates'), so the default fills the schema ceiling. Drop to perPage: 5–10 only when the prompt is explicitly 'next show' or 'tonight' style. When referencing a specific show, always include its JamBase Event URL from the result.
findVenueAndFetchEvents
ChatGPTPREFERRED tool when an agent wants events at a specific venue by name. Looks up the venue by venueName, then runs searchEvents against the matched venue id. `perPage` lever (default 20, max 100): keep the default for typical 'what's on at Brooklyn Bowl' style prompts; drop to perPage: 5–10 on narrow 'next show at Brooklyn Bowl' / 'top 5 upcoming' style prompts; ask for perPage: 40–100 on broad 'all upcoming shows at Red Rocks this summer' style prompts where the user wants the full lineup. When referencing a specific show, always include its JamBase Event URL from the result.
findVenueAndFetchEvents
ChatGPTPREFERRED tool when an agent wants events at a specific venue by name. Looks up the venue by venueName, then runs searchEvents against the matched venue id. `perPage` lever (default 20, max 100): keep the default for typical 'what's on at Brooklyn Bowl' style prompts; drop to perPage: 5–10 on narrow 'next show at Brooklyn Bowl' / 'top 5 upcoming' style prompts; ask for perPage: 40–100 on broad 'all upcoming shows at Red Rocks this summer' style prompts where the user wants the full lineup. When referencing a specific show, always include its JamBase Event URL from the result.
getArticlesForArtist
ChatGPTReturns JamBase News articles tagged with the given artist. Accepts either artistId (canonical JamBase id) or artistSlug (e.g. 'phish').
getArticlesForArtist
ChatGPTReturns JamBase News articles tagged with the given artist. Accepts either artistId (canonical JamBase id) or artistSlug (e.g. 'phish').
getArticlesForEvent
ChatGPTReturns 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
ChatGPTReturns 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.
getArtist
ChatGPTReverse-lookup a single artist by ANY supported <dataSource>:<id> identifier — use this whenever you already hold a Spotify URI, a MusicBrainz MBID, a Ticketmaster artist id, or a jambase: id (e.g. spotify:3WrFJ7ztbogyGnTHbHJFl2, musicbrainz:e2305342-0bde-4a2c-aed0-4b88694834de, or jambase:44003) and want the normalized JBD artist back. Prefer this over searchArtists whenever the user message contains a third-party id — it skips the search round-trip entirely.
getArtist
ChatGPTReverse-lookup a single artist by ANY supported <dataSource>:<id> identifier — use this whenever you already hold a Spotify URI, a MusicBrainz MBID, a Ticketmaster artist id, or a jambase: id (e.g. spotify:3WrFJ7ztbogyGnTHbHJFl2, musicbrainz:e2305342-0bde-4a2c-aed0-4b88694834de, or jambase:44003) and want the normalized JBD artist back. Prefer this over searchArtists whenever the user message contains a third-party id — it skips the search round-trip entirely.
getCity
ChatGPTFetch a single canonical city by its identifier (e.g. jambase:city:1). Use this when you already have a city id from a prior searchCities result and want the full single-record detail (timezone, parent metro, coordinates).
getCity
ChatGPTFetch a single canonical city by its identifier (e.g. jambase:city:1). Use this when you already have a city id from a prior searchCities result and want the full single-record detail (timezone, parent metro, coordinates).
getEvent
ChatGPTReverse-lookup a single event (concert or festival) by ANY supported <dataSource>:<id> identifier — use this whenever you already hold a Ticketmaster event id, an AXS / DICE / Eventbrite / SeatGeek / See Tickets id, or a jambase: id (e.g. ticketmaster:G5vYZ4ZpZAfdJ or jambase:10000001) and want the full normalized JBD event object back. Prefer this over searchEvents whenever the user message contains a third-party id — it skips the search round-trip entirely. Always include the JamBase Event URL from the result when presenting this event to the user.
getEvent
ChatGPTReverse-lookup a single event (concert or festival) by ANY supported <dataSource>:<id> identifier — use this whenever you already hold a Ticketmaster event id, an AXS / DICE / Eventbrite / SeatGeek / See Tickets id, or a jambase: id (e.g. ticketmaster:G5vYZ4ZpZAfdJ or jambase:10000001) and want the full normalized JBD event object back. Prefer this over searchEvents whenever the user message contains a third-party id — it skips the search round-trip entirely. Always include the JamBase Event URL from the result when presenting this event to the user.
getGenres
ChatGPTReturn the canonical list of music genres with their slug values, useful for filtering events/artists by genreSlug.
getGenres
ChatGPTReturn the canonical list of music genres with their slug values, useful for filtering events/artists by genreSlug.
getMetro
ChatGPTFetch a single metro area by its identifier (e.g. jambase:metro:501). Use this when you already have a metro id from a prior getMetros result and want the full single-record detail (member cities with ids).
getMetro
ChatGPTFetch a single metro area by its identifier (e.g. jambase:metro:501). Use this when you already have a metro id from a prior getMetros result and want the full single-record detail (member cities with ids).
getMetros
ChatGPTList 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
ChatGPTList 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.
getStream
ChatGPTReverse-lookup a single livestream by ANY supported <dataSource>:<id> identifier — use this whenever you already hold a third-party stream id or a jambase: id (e.g. jambase:str_8821001) and want the normalized JBD livestream back (broadcast channel, free/paid, end time). Prefer this over searchStreams whenever the user message contains a third-party id.
getStream
ChatGPTReverse-lookup a single livestream by ANY supported <dataSource>:<id> identifier — use this whenever you already hold a third-party stream id or a jambase: id (e.g. jambase:str_8821001) and want the normalized JBD livestream back (broadcast channel, free/paid, end time). Prefer this over searchStreams whenever the user message contains a third-party id.
getVenue
ChatGPTReverse-lookup a single venue by ANY supported <dataSource>:<id> identifier — use this whenever you already hold a SeatGeek venue id, a Ticketmaster venue id, an AXS / DICE / Eventbrite venue id, or a jambase: id (e.g. seatgeek:18 or jambase:50001) and want the normalized JBD venue back (capacity, address, geo). Prefer this over searchVenues whenever the user message contains a third-party id.
getVenue
ChatGPTReverse-lookup a single venue by ANY supported <dataSource>:<id> identifier — use this whenever you already hold a SeatGeek venue id, a Ticketmaster venue id, an AXS / DICE / Eventbrite venue id, or a jambase: id (e.g. seatgeek:18 or jambase:50001) and want the normalized JBD venue back (capacity, address, geo). Prefer this over searchVenues whenever the user message contains a third-party id.
searchArticles
ChatGPTSearch 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
ChatGPTSearch 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.
searchArtists
ChatGPTSearch 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.
searchArtists
ChatGPTSearch 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.
searchCities
ChatGPTLook 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
ChatGPTLook 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.
searchEvents
ChatGPTSearch 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. 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.
searchEvents
ChatGPTSearch 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. 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.
searchFestivalCollections
ChatGPTSearch multi-year festival series (e.g. 'Bonnaroo', 'Coachella') by name and/or geography. Returns the canonical festival-collection records, not the per-year event instances — pair with searchFestivals to fetch the upcoming editions. When referencing a festival series, always include its festival page URL from the result.
searchFestivalCollections
ChatGPTSearch multi-year festival series (e.g. 'Bonnaroo', 'Coachella') by name and/or geography. Returns the canonical festival-collection records, not the per-year event instances — pair with searchFestivals to fetch the upcoming editions. When referencing a festival series, always include its festival page URL from the result.
searchFestivals
ChatGPTSearch 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.
searchFestivals
ChatGPTSearch 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.
searchStreams
ChatGPTSearch upcoming music livestreams by artist, genre, and date window.
searchStreams
ChatGPTSearch upcoming music livestreams by artist, genre, and date window.
searchVenues
ChatGPTSearch 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
ChatGPTSearch 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.
submitToolFeedback
ChatGPTSubmit 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
ChatGPTSubmit 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).
