search_gigs_and_events
Search a supported city's upcoming live music and events: band gigs, open mics, comedy nights, jam and folk sessions, festivals, and club nights, spanning grassroots gigs at small independent venues through to major shows at the city's big rooms (listed side by side; coverage aims to be complete). Returns them most imminent first, each with a booking link out (gigstamp does not sell tickets) and a gig-page url to cite. Filter by date range, venue, district (on a city that has them, see list_cities), category, scale (grassroots, major or commercial), or free text. Only supported cities return data (see list_cities).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"city": "<city>"
},
"name": "search_gigs_and_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | starts on or before this local day, YYYY-MM-DD | |
| city | Yes | city slug; supported cities: oxford, brighton, sheffield, leeds, glasgow, birmingham, liverpool, nottingham, manchester, edinburgh, london, bristol, southampton, derby, cardiff, newcastle, aberdeen, cambridge, norwich, hull, leicester, preston, belfast | |
| from | No | on or after this local day, YYYY-MM-DD | |
| limit | No | max results (default 100) | |
| query | No | free-text match over act / venue / summary | |
| scale | No | narrow to grassroots (small independent venues), major (large / touring rooms) or commercial (nightclubs, chain bars and restaurants where music is incidental) | |
| venue | No | venue slug | |
| covers | No | include covers bands and covers nights (default true; false hides them) | |
| category | No | ||
| district | No | a named district's slug, e.g. camden, on a city that has districts (list_cities gives each city's list; asking for any other is an error). A venue we cannot place is left out of a district and is in the city's whole list. | |
| tributes | No | include tribute acts (default false) | |
| classical | No | include classical concerts (default true; false hides them) |