Tools
get_venue_schedule
Shows what is on at one venue, its sale dates and weather; finds venues and ids; or shows what each section costs.
When to use it
- You have a venue and want its upcoming events, soonest first, with the roof type and the coming week's weather.
- A question names a building, or a place and a size, and you need venue ids: set
viewtovenues. - You want what each section at a venue costs across its next events: set
viewtosections. - To rank a venue's events by price, demand or inventory, use
screen_events.
Inputs
view(string):schedule(the default): one venue's events.venues: find venues by name, state, country or capacity, with their ids.sections: what each section at one venue costs across its next upcoming events. One ofschedule,venues,sections.venue_id(string): Withscheduleorsections, the venue as a Ticker venue id. Leave it out only when you givevenue_name.venue_name(string): The venue's name, or part of it, as its official name:Madison Square Garden, notMSG. Withscheduleorsectionsthe best match is read, so when two venues share a name, find the id first withviewvenues. Up to 80 characters.days(integer): Withschedule, how many days ahead to look when you give neitherdate_fromnordate_to: 30 when you leave it out, at most 365. A larger number reads as 365.date_from(date-time): Withschedule, only events on or after this time, ISO 8601 withZor an offset. Withdate_fromalone, the window runs one year from it.date_to(date-time): Withschedule, only events before this time, ISO 8601 withZor an offset. Withdate_toalone, the window starts now.page(integer, default1): Withschedule, the page of the window to read, soonest first,limitevents a page. The first page when you leave it out.limit(integer): Withschedule, the most events: 200 when you leave it out. Withvenues, the most venues: 5 when you leave it out, at most 25.state(string): Withvenues, only venues in this state or province, by its code, likeTX. A venue with no state on record matches its country code instead. Up to 120 characters.country(string): Withvenues, only venues in this country, by its two-letter code, likeUS. Up to 120 characters.capacity_min(integer): Withvenues, only venues that hold at least this many people. From 0 to 1000000.capacity_max(integer): Withvenues, only venues that hold at most this many people. It cannot be less thancapacity_min. From 0 to 1000000.events(integer): Withsections, how many of the venue's next upcoming events to average over, soonest first: 10 when you leave it out, at most 20.
Examples
What is on at Madison Square Garden in December?
{
"venue_name": "Madison Square Garden",
"date_from": "2026-12-01T00:00:00Z",
"date_to": "2027-01-01T00:00:00Z"
}What is the venue id for Barclays Center?
{ "view": "venues", "venue_name": "Barclays Center" }What does each section at Barclays Center cost across its next five events?
{ "view": "sections", "venue_name": "Barclays Center", "events": 5 }What comes back
schedule:venuewithvenue_id,venue_name,city,stateandroof(open,retractable,fixedor null), andevents, soonest first, withevent_id,event_name,local_date,onsale_date,presale1_dateand the get-in price now, before fees and all-in.forecast: the venue's next 7 local days, today first, with the high and low in Fahrenheit, the sky, rain and wind. On a plan without it, it is left out and named inwithheld.window, the dates read, andhas_moretruewhen the window holds more events than came back: ask for the nextpage.nullwhen no venue matchesvenue_name.venues:data, one row per venue withvenue_id,name,city,state,country_codeandupcoming_events, the best name match first. Passvenue_idback withviewschedule, or toscreen_events.sections: per section, dearest first, the average get-in and median, before fees and all-in, open tickets and listings, andevents, how many events the row stands on.events_readunderevents_consideredmeans some events' listings could not be read.
Limits and quota
- Reads only: it changes nothing.
- Each call spends one MCP request.
- The Pro plan and above include the forecast. Past events, parking passes and other non-admission items are not listed.
- With
venues, give a name or at least one other filter; only venues with an upcoming event are listed, and a capacity bound leaves out venues whose capacity is not known. - It replaces
find_venue, whose name still answers: see Old names.