Foobos: Boston and Denver concerts and comedy
Concerts and comedy in Boston and Denver: tonight, this weekend, free shows, venues, picks.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"listings": {
"url": "https://foobos.net/api/agent/mcp"
}
}
}Remote endpoints
https://foobos.net/api/agent/mcpstreamable-httpWhat it can do
Tool inventory
Tools (10)
🟢list_picks(collection, city, via, limit, offset)
Staff picks in Boston, Denver, San Francisco, Nashville or New York, each with a one-line reason. Use this for “what should I see?”, “what’s good”, “anything worth going to?”, “featured”, “date night”, “romantic”, or any public curated list. Always cite `url` (app deep link /e/?id=). Do not rewrite to /event/. Omit collection to list every public collection (id + title + counts) plus the default featured+popular pages. Intent → collection: date night / romantic / nice night out → date_night (do NOT use sort=popular alone); what’s good / featured → featured; big names / popular → popular; local / underrated → local_scene (or local_bands / under_the_radar); comedy night → comedy (for “comedy this week?” prefer search_shows event_type=comedy); jazz → jazz (or search genre=jazz); kids / family → tots_picks; older crowd / boomer → senior; foobos / Scott / Tot staff → foobos / scotts_picks / tots_picks; free curated → free_tonight (or shows_free); punk curated → punk (or search genre=punk); weeknight gems → weeknight_gems; St. Patrick’s → st_patricks. Not personalized For You — there is no account on this API. Each pick includes editorial `why` when the curated row has one so you can cite the reason. Each collection is paginated (default 20, max 50) and includes its own total.
Input Schema
{
"type": "object",
"properties": {
"collection": {
"type": "string",
"enum": [
"featured",
"popular",
"date_night",
"local_scene",
"local_bands",
"under_the_radar",
"comedy",
"jazz",
"foobos",
"scotts_picks",
"tots_picks",
"senior",
"free_tonight",
"punk",
"weeknight_gems",
"st_patricks"
],
"description": "One public curated key. Omit for available catalog + featured/popular."
},
"city": {
"type": "string",
"enum": [
"boston",
"denver",
"sanfrancisco",
"nashville",
"newyork"
],
"default": "boston",
"description": "boston (default: Boston, Cambridge, Somerville and the rest of Greater Boston, Massachusetts), denver (Denver, Boulder and the Colorado Front Range), sanfrancisco (San Francisco, Oakland, Berkeley and the rest of the Bay Area), nashville (Nashville, Franklin, Murfreesboro and the rest of Middle Tennessee) or newyork (the five boroughs of New York City and the big rooms just outside them). Set denver for anything in Colorado, sanfrancisco for anything in the Bay Area, nashville for anything in Middle Tennessee and newyork for anything in New York City."
},
"via": {
"type": "string",
"enum": [
"muse",
"chatgpt",
"claude",
"assistant"
],
"description": "Inbound UTM source written onto every Foobos deep link. Default muse."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 20,
"description": "Page size. Default 20, max 50. Do not request the full list — tonight is ~174 shows / ~36k tokens."
},
"offset": {
"type": "integer",
"minimum": 0,
"default": 0,
"description": "Rows to skip. Use with the returned total to page."
}
}
}🟢shows_free(window, venue, event_type, sort, city, ...)
Free shows in Boston, Denver, San Francisco, Nashville or New York. Use this for “what’s free tonight?” or “free shows this weekend”. Returns only free listings (is_free / price 0). Default window is tonight (today + next 2 days). Pass window=weekend for Fri–Sun, window=upcoming for today onward. Paginated: default 20, max 50, always includes total. Default sort=evening. Do not call shows_tonight and filter client-side — tonight is ~174 shows.
Input Schema
{
"type": "object",
"properties": {
"window": {
"type": "string",
"enum": [
"tonight",
"weekend",
"upcoming"
],
"default": "tonight",
"description": "tonight (default, today+2), weekend (Fri–Sun), or upcoming (today onward)."
},
"venue": {
"type": "string",
"description": "Optional venue id, slug, or name substring."
},
"event_type": {
"type": "string",
"enum": [
"music",
"comedy",
"theatre"
],
"description": "comedy, theatre or music. Comedy is public event_type / finder ty=c, theatre (plays and musicals) is ty=t; neither is a genre tag. Use for “comedy this week?” or “what plays are on?”."
},
"sort": {
"type": "string",
"enum": [
"time",
"evening",
"popular"
],
"default": "evening",
"description": "evening (default): evening + upcoming first, not brunch-first chrono. time: raw chronological. popular: editorial picks first, then evening."
},
"city": {
"type": "string",
"enum": [
"boston",
"denver",
"sanfrancisco",
"nashville",
"newyork"
],
"default": "boston",
"description": "boston (default: Boston, Cambridge, Somerville and the rest of Greater Boston, Massachusetts), denver (Denver, Boulder and the Colorado Front Range), sanfrancisco (San Francisco, Oakland, Berkeley and the rest of the Bay Area), nashville (Nashville, Franklin, Murfreesboro and the rest of Middle Tennessee) or newyork (the five boroughs of New York City and the big rooms just outside them). Set denver for anything in Colorado, sanfrancisco for anything in the Bay Area, nashville for anything in Middle Tennessee and newyork for anything in New York City."
},
"via": {
"type": "string",
"enum": [
"muse",
"chatgpt",
"claude",
"assistant"
],
"description": "Inbound UTM source written onto every Foobos deep link. Default muse."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 20,
"description": "Page size. Default 20, max 50. Do not request the full list — tonight is ~174 shows / ~36k tokens."
},
"offset": {
"type": "integer",
"minimum": 0,
"default": 0,
"description": "Rows to skip. Use with the returned total to page."
}
}
}🟢search_shows(artist, q, venue, date, date_from, ...)
Search every upcoming concert and comedy show in Boston, Denver, San Francisco, Nashville or New York. Use this for “is [artist] playing?”, “shows at [venue]”, a date or date range, a genre, or “comedy this week?”. artist / q: case- and accent-insensitive substring of billed names (Peña matches Chance Peña). venue: id, id_variant, slug, or name substring (paradise, paradise_rock_club, Sinclair). date: one YYYY-MM-DD. date_from/date_to: inclusive range. Unset dates default to upcoming (today onward). genre=/genres= is the finder mega-category (latin, jazz, rock…). Example: genre=latin + date=2026-10-15. event_type=comedy uses the public comedy field (finder ty=c / worker event_type), not genre tags. Always cite `url` (`/e/?id=`). Do not rewrite to /event/. free=true for free shows. For “what should I see?” or “date night” use list_picks instead of sort=popular. Paginated: default 20, max 50, always includes total.
Input Schema
{
"type": "object",
"properties": {
"artist": {
"type": "string",
"description": "Artist substring. Alias: q. Example: Peña."
},
"q": {
"type": "string",
"description": "Alias of artist."
},
"venue": {
"type": "string",
"description": "Venue id, variant, slug, or name substring."
},
"date": {
"type": "string",
"description": "Exact YYYY-MM-DD. Overrides date_from/date_to."
},
"date_from": {
"type": "string",
"description": "Inclusive range start YYYY-MM-DD."
},
"date_to": {
"type": "string",
"description": "Inclusive range end YYYY-MM-DD."
},
"free": {
"type": "boolean",
"description": "If true, only free shows (listing flag or price 0). Use for “what’s free tonight?”. Alias: is_free."
},
"is_free": {
"type": "boolean",
"description": "If true, only free shows (listing flag or price 0). Use for “what’s free tonight?”. Alias: is_free."
},
"event_type": {
"type": "string",
"enum": [
"music",
"comedy",
"theatre"
],
"description": "comedy, theatre or music. Comedy is public event_type / finder ty=c, theatre (plays and musicals) is ty=t; neither is a genre tag. Use for “comedy this week?” or “what plays are on?”."
},
"genre": {
"type": "string",
"description": "Finder mega-category (rock, punk, pop, jazz, soul, blues, folk, electronic, hiphop, reggae, classical, latin). Alias: genres. Comedy is event_type, not a genre. Joined from finder.json `g` — do not invent tags."
},
"genres": {
"type": "string",
"description": "Comma-separated megas. Alias of genre."
},
"area": {
"type": "string",
"description": "Finder WHERE pill or neighborhood (Boston: cambridge, allston_brighton, somerville…; Denver: den_downtown, den_colfax, boulder…). Aliases: neighborhood, where."
},
"neighborhood": {
"type": "string",
"description": "Alias of area."
},
"max_price": {
"type": "number",
"description": "Numeric price ceiling. Free passes; unknown price excluded."
},
"all_ages": {
"type": "boolean",
"description": "If true, only all-ages (a/a)."
},
"mbta": {
"type": "boolean",
"description": "Boston only. If true, only MBTA-accessible rooms."
},
"is_new": {
"type": "boolean",
"description": "If true, only just-added (finder new)."
},
"max_capacity": {
"type": "integer",
"description": "Known venues.json capacity ≤ N. intimate=true aliases max_capacity=500 (hint, not a stored flag)."
},
"min_capacity": {
"type": "integer",
"description": "Known venues.json capacity ≥ N. large=true aliases min_capacity=5000."
},
"intimate": {
"type": "boolean",
"description": "Hint alias of max_capacity=500. Unknown capacity excluded."
},
"large": {
"type": "boolean",
"description": "Hint alias of min_capacity=5000."
},
"sort": {
"type": "string",
"enum": [
"time",
"evening",
"popular"
],
"default": "time",
"description": "evening (default): evening + upcoming first, not brunch-first chrono. time: raw chronological. popular: editorial picks first, then evening."
},
"city": {
"type": "string",
"enum": [
"boston",
"denver",
"sanfrancisco",
"nashville",
"newyork"
],
"default": "boston",
"description": "boston (default: Boston, Cambridge, Somerville and the rest of Greater Boston, Massachusetts), denver (Denver, Boulder and the Colorado Front Range), sanfrancisco (San Francisco, Oakland, Berkeley and the rest of the Bay Area), nashville (Nashville, Franklin, Murfreesboro and the rest of Middle Tennessee) or newyork (the five boroughs of New York City and the big rooms just outside them). Set denver for anything in Colorado, sanfrancisco for anything in the Bay Area, nashville for anything in Middle Tennessee and newyork for anything in New York City."
},
"via": {
"type": "string",
"enum": [
"muse",
"chatgpt",
"claude",
"assistant"
],
"description": "Inbound UTM source written onto every Foobos deep link. Default muse."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 20,
"description": "Page size. Default 20, max 50. Do not request the full list — tonight is ~174 shows / ~36k tokens."
},
"offset": {
"type": "integer",
"minimum": 0,
"default": 0,
"description": "Rows to skip. Use with the returned total to page."
}
}
}🟢shows_tonight(free, is_free, event_type, genre, genres, ...)
Concerts and comedy tonight and the next two days in Boston (default), Denver (city=denver), San Francisco (city=sanfrancisco), Nashville (city=nashville) or New York (city=newyork), in the city's own time zone. Use this for “what's on tonight?”, “anything going on?”, “live music near me tonight”. Default sort=evening: evening and upcoming first, not brunch-first chrono. sort=time for raw order; sort=popular bumps editorial picks. For “what’s free tonight?” set free=true or call shows_free. For “what should I see?” or date night call list_picks. Always cite `url` (`/e/?id=`). Do not rewrite to /event/. Returns a page of shows (default 20, max 50) plus total. Page with offset; never ask for the full tonight list (~174 shows / ~36k tokens).
Input Schema
{
"type": "object",
"properties": {
"free": {
"type": "boolean",
"description": "If true, only free shows (listing flag or price 0). Use for “what’s free tonight?”. Alias: is_free."
},
"is_free": {
"type": "boolean",
"description": "If true, only free shows (listing flag or price 0). Use for “what’s free tonight?”. Alias: is_free."
},
"event_type": {
"type": "string",
"enum": [
"music",
"comedy",
"theatre"
],
"description": "comedy, theatre or music. Comedy is public event_type / finder ty=c, theatre (plays and musicals) is ty=t; neither is a genre tag. Use for “comedy this week?” or “what plays are on?”."
},
"genre": {
"type": "string",
"description": "Finder mega-category (rock, punk, pop, jazz, soul, blues, folk, electronic, hiphop, reggae, classical, latin). Alias: genres. Comedy is event_type, not a genre. Joined from finder.json `g` — do not invent tags."
},
"genres": {
"type": "string",
"description": "Comma-separated megas. Alias of genre."
},
"area": {
"type": "string",
"description": "Finder WHERE pill or neighborhood (Boston: cambridge, allston_brighton, somerville…; Denver: den_downtown, den_colfax, boulder…). Aliases: neighborhood, where."
},
"neighborhood": {
"type": "string",
"description": "Alias of area."
},
"max_price": {
"type": "number",
"description": "Numeric price ceiling. Free passes; unknown price excluded."
},
"all_ages": {
"type": "boolean",
"description": "If true, only all-ages (a/a)."
},
"mbta": {
"type": "boolean",
"description": "Boston only. If true, only MBTA-accessible rooms."
},
"is_new": {
"type": "boolean",
"description": "If true, only just-added (finder new)."
},
"max_capacity": {
"type": "integer",
"description": "Known venues.json capacity ≤ N. intimate=true aliases max_capacity=500 (hint, not a stored flag)."
},
"min_capacity": {
"type": "integer",
"description": "Known venues.json capacity ≥ N. large=true aliases min_capacity=5000."
},
"intimate": {
"type": "boolean",
"description": "Hint alias of max_capacity=500. Unknown capacity excluded."
},
"large": {
"type": "boolean",
"description": "Hint alias of min_capacity=5000."
},
"sort": {
"type": "string",
"enum": [
"time",
"evening",
"popular"
],
"default": "evening",
"description": "evening (default): evening + upcoming first, not brunch-first chrono. time: raw chronological. popular: editorial picks first, then evening."
},
"city": {
"type": "string",
"enum": [
"boston",
"denver",
"sanfrancisco",
"nashville",
"newyork"
],
"default": "boston",
"description": "boston (default: Boston, Cambridge, Somerville and the rest of Greater Boston, Massachusetts), denver (Denver, Boulder and the Colorado Front Range), sanfrancisco (San Francisco, Oakland, Berkeley and the rest of the Bay Area), nashville (Nashville, Franklin, Murfreesboro and the rest of Middle Tennessee) or newyork (the five boroughs of New York City and the big rooms just outside them). Set denver for anything in Colorado, sanfrancisco for anything in the Bay Area, nashville for anything in Middle Tennessee and newyork for anything in New York City."
},
"via": {
"type": "string",
"enum": [
"muse",
"chatgpt",
"claude",
"assistant"
],
"description": "Inbound UTM source written onto every Foobos deep link. Default muse."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 20,
"description": "Page size. Default 20, max 50. Do not request the full list — tonight is ~174 shows / ~36k tokens."
},
"offset": {
"type": "integer",
"minimum": 0,
"default": 0,
"description": "Rows to skip. Use with the returned total to page."
}
}
}🟢shows_this_weekend(free, is_free, event_type, genre, genres, ...)
Concerts and comedy this Friday through Sunday (the remaining or upcoming weekend) in Boston (default), Denver (city=denver), San Francisco (city=sanfrancisco), Nashville (city=nashville) or New York (city=newyork). Use this for “what's on this weekend?”. Default sort=evening. free=true, event_type=comedy, and genre= match tonight/search. For “what should I see this weekend?” or date night prefer list_picks. Always cite `url` (`/e/?id=`). Do not rewrite to /event/. Paginated: default 20, max 50, always includes total.
Input Schema
{
"type": "object",
"properties": {
"free": {
"type": "boolean",
"description": "If true, only free shows (listing flag or price 0). Use for “what’s free tonight?”. Alias: is_free."
},
"is_free": {
"type": "boolean",
"description": "If true, only free shows (listing flag or price 0). Use for “what’s free tonight?”. Alias: is_free."
},
"event_type": {
"type": "string",
"enum": [
"music",
"comedy",
"theatre"
],
"description": "comedy, theatre or music. Comedy is public event_type / finder ty=c, theatre (plays and musicals) is ty=t; neither is a genre tag. Use for “comedy this week?” or “what plays are on?”."
},
"genre": {
"type": "string",
"description": "Finder mega-category (rock, punk, pop, jazz, soul, blues, folk, electronic, hiphop, reggae, classical, latin). Alias: genres. Comedy is event_type, not a genre. Joined from finder.json `g` — do not invent tags."
},
"genres": {
"type": "string",
"description": "Comma-separated megas. Alias of genre."
},
"area": {
"type": "string",
"description": "Finder WHERE pill or neighborhood (Boston: cambridge, allston_brighton, somerville…; Denver: den_downtown, den_colfax, boulder…). Aliases: neighborhood, where."
},
"neighborhood": {
"type": "string",
"description": "Alias of area."
},
"max_price": {
"type": "number",
"description": "Numeric price ceiling. Free passes; unknown price excluded."
},
"all_ages": {
"type": "boolean",
"description": "If true, only all-ages (a/a)."
},
"mbta": {
"type": "boolean",
"description": "Boston only. If true, only MBTA-accessible rooms."
},
"is_new": {
"type": "boolean",
"description": "If true, only just-added (finder new)."
},
"max_capacity": {
"type": "integer",
"description": "Known venues.json capacity ≤ N. intimate=true aliases max_capacity=500 (hint, not a stored flag)."
},
"min_capacity": {
"type": "integer",
"description": "Known venues.json capacity ≥ N. large=true aliases min_capacity=5000."
},
"intimate": {
"type": "boolean",
"description": "Hint alias of max_capacity=500. Unknown capacity excluded."
},
"large": {
"type": "boolean",
"description": "Hint alias of min_capacity=5000."
},
"sort": {
"type": "string",
"enum": [
"time",
"evening",
"popular"
],
"default": "evening",
"description": "evening (default): evening + upcoming first, not brunch-first chrono. time: raw chronological. popular: editorial picks first, then evening."
},
"city": {
"type": "string",
"enum": [
"boston",
"denver",
"sanfrancisco",
"nashville",
"newyork"
],
"default": "boston",
"description": "boston (default: Boston, Cambridge, Somerville and the rest of Greater Boston, Massachusetts), denver (Denver, Boulder and the Colorado Front Range), sanfrancisco (San Francisco, Oakland, Berkeley and the rest of the Bay Area), nashville (Nashville, Franklin, Murfreesboro and the rest of Middle Tennessee) or newyork (the five boroughs of New York City and the big rooms just outside them). Set denver for anything in Colorado, sanfrancisco for anything in the Bay Area, nashville for anything in Middle Tennessee and newyork for anything in New York City."
},
"via": {
"type": "string",
"enum": [
"muse",
"chatgpt",
"claude",
"assistant"
],
"description": "Inbound UTM source written onto every Foobos deep link. Default muse."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 20,
"description": "Page size. Default 20, max 50. Do not request the full list — tonight is ~174 shows / ~36k tokens."
},
"offset": {
"type": "integer",
"minimum": 0,
"default": 0,
"description": "Rows to skip. Use with the returned total to page."
}
}
}🟢list_venues(city, via, limit, offset)
Venues in Boston, Denver, San Francisco, Nashville or New York that have upcoming shows, with show_count and public facts (address, capacity, bag_policy, MBTA in Boston). Paginated: default 20, max 50, always includes total. Use get_venue or search_shows with venue= for one room and its upcoming shows.
Input Schema
{
"type": "object",
"properties": {
"city": {
"type": "string",
"enum": [
"boston",
"denver",
"sanfrancisco",
"nashville",
"newyork"
],
"default": "boston",
"description": "boston (default: Boston, Cambridge, Somerville and the rest of Greater Boston, Massachusetts), denver (Denver, Boulder and the Colorado Front Range), sanfrancisco (San Francisco, Oakland, Berkeley and the rest of the Bay Area), nashville (Nashville, Franklin, Murfreesboro and the rest of Middle Tennessee) or newyork (the five boroughs of New York City and the big rooms just outside them). Set denver for anything in Colorado, sanfrancisco for anything in the Bay Area, nashville for anything in Middle Tennessee and newyork for anything in New York City."
},
"via": {
"type": "string",
"enum": [
"muse",
"chatgpt",
"claude",
"assistant"
],
"description": "Inbound UTM source written onto every Foobos deep link. Default muse."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 20,
"description": "Page size. Default 20, max 50. Do not request the full list — tonight is ~174 shows / ~36k tokens."
},
"offset": {
"type": "integer",
"minimum": 0,
"default": 0,
"description": "Rows to skip. Use with the returned total to page."
}
}
}🟢get_venue(id, city, via, limit, offset)
One venue in Boston, Denver, San Francisco, Nashville or New York (id, id_variant, or slug) and a page of its upcoming shows. With no city it looks in every city. Use for “shows at Paradise” when you already have the venue id/slug; otherwise search_shows with venue=. Paginated: default 20, max 50, always includes total. id is required. For the directory of rooms, use list_venues.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Venue id, id_variant, or slug (e.g. paradise, paradise_rock_club)."
},
"city": {
"type": "string",
"enum": [
"boston",
"denver",
"sanfrancisco",
"nashville",
"newyork"
],
"default": "boston",
"description": "boston (default: Boston, Cambridge, Somerville and the rest of Greater Boston, Massachusetts), denver (Denver, Boulder and the Colorado Front Range), sanfrancisco (San Francisco, Oakland, Berkeley and the rest of the Bay Area), nashville (Nashville, Franklin, Murfreesboro and the rest of Middle Tennessee) or newyork (the five boroughs of New York City and the big rooms just outside them). Set denver for anything in Colorado, sanfrancisco for anything in the Bay Area, nashville for anything in Middle Tennessee and newyork for anything in New York City."
},
"via": {
"type": "string",
"enum": [
"muse",
"chatgpt",
"claude",
"assistant"
],
"description": "Inbound UTM source written onto every Foobos deep link. Default muse."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 20,
"description": "Page size. Default 20, max 50. Do not request the full list — tonight is ~174 shows / ~36k tokens."
},
"offset": {
"type": "integer",
"minimum": 0,
"default": 0,
"description": "Rows to skip. Use with the returned total to page."
}
},
"required": [
"id"
]
}🟢get_show(id, via)
One show by its id (from any list here, or the id= in a foobos.net/e/ link), in either city. Use for “tell me more about that one”: the full bill, time, price, ages, sold out, the note on what is special about the night, and the room's facts (address, capacity, bag policy, transit). Always cite `url`.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Show id, e.g. b994eef4946a."
},
"via": {
"type": "string",
"enum": [
"muse",
"chatgpt",
"claude",
"assistant"
],
"description": "Inbound UTM source written onto every Foobos deep link. Default muse."
}
},
"required": [
"id"
]
}🟢list_guides(city, via, limit, offset)
Hand-made foobos guides in Boston, Denver, San Francisco, Nashville or New York: themed lists like “Rare Shows”, “Cool New Shows”, “Top Shows This Weekend”, “On The Green Line” or “Altitude Adjustment”, each with a curator and a short intro. Use when someone wants ideas, a theme, or “what's special”. Then call get_guide with an id. Paginated: default 20, max 50, always includes total.
Input Schema
{
"type": "object",
"properties": {
"city": {
"type": "string",
"enum": [
"boston",
"denver",
"sanfrancisco",
"nashville",
"newyork"
],
"default": "boston",
"description": "boston (default: Boston, Cambridge, Somerville and the rest of Greater Boston, Massachusetts), denver (Denver, Boulder and the Colorado Front Range), sanfrancisco (San Francisco, Oakland, Berkeley and the rest of the Bay Area), nashville (Nashville, Franklin, Murfreesboro and the rest of Middle Tennessee) or newyork (the five boroughs of New York City and the big rooms just outside them). Set denver for anything in Colorado, sanfrancisco for anything in the Bay Area, nashville for anything in Middle Tennessee and newyork for anything in New York City."
},
"via": {
"type": "string",
"enum": [
"muse",
"chatgpt",
"claude",
"assistant"
],
"description": "Inbound UTM source written onto every Foobos deep link. Default muse."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 20,
"description": "Page size. Default 20, max 50. Do not request the full list — tonight is ~174 shows / ~36k tokens."
},
"offset": {
"type": "integer",
"minimum": 0,
"default": 0,
"description": "Rows to skip. Use with the returned total to page."
}
}
}🟢get_guide(id, city, via, limit, offset)
One guide's upcoming shows in the curator's order, each with the curator's note as `why` when there is one. With no city it uses the city where the guide has the most shows. Always cite each show's `url`. Paginated: default 20, max 50, always includes total.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Guide id from list_guides, e.g. rare-shows."
},
"city": {
"type": "string",
"enum": [
"boston",
"denver",
"sanfrancisco",
"nashville",
"newyork"
],
"description": "boston (default: Boston, Cambridge, Somerville and the rest of Greater Boston, Massachusetts), denver (Denver, Boulder and the Colorado Front Range), sanfrancisco (San Francisco, Oakland, Berkeley and the rest of the Bay Area), nashville (Nashville, Franklin, Murfreesboro and the rest of Middle Tennessee) or newyork (the five boroughs of New York City and the big rooms just outside them). Set denver for anything in Colorado, sanfrancisco for anything in the Bay Area, nashville for anything in Middle Tennessee and newyork for anything in New York City."
},
"via": {
"type": "string",
"enum": [
"muse",
"chatgpt",
"claude",
"assistant"
],
"description": "Inbound UTM source written onto every Foobos deep link. Default muse."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 20,
"description": "Page size. Default 20, max 50. Do not request the full list — tonight is ~174 shows / ~36k tokens."
},
"offset": {
"type": "integer",
"minimum": 0,
"default": 0,
"description": "Rows to skip. Use with the returned total to page."
}
},
"required": [
"id"
]
}Community
Evidence