developers

gigstamp is built to be consumed by AI agents and integrators, not just read by people. Everything below is read-only, needs no key, and covers every gig in each city we list, from grassroots shows at small independent venues to the big touring names (filter by scale to narrow to the local scene).

supported cities

Only these cities currently have data: oxford, brighton. Any other city returns no results. The lists below are always current: the MCP list_cities tool, the API /api/v1/cities, and the machine index at llms.txt.

mcp server (for AI agents)

A remote Model Context Protocol server at https://www.gigstamp.co.uk/api/mcp (stateless Streamable HTTP, no auth). Any MCP client can connect by URL. Tools: list_cities, list_venues, search_gigs_and_events, get_gig.

Claude (CLI):

claude mcp add --transport http gigstamp https://www.gigstamp.co.uk/api/mcp

Cursor / VS Code / Windsurf (mcp config):

{
  "mcpServers": {
    "gigstamp": { "url": "https://www.gigstamp.co.uk/api/mcp" }
  }
}

json api

A read-only REST API. Full description in the OpenAPI spec.

GET /api/v1/cities
GET /api/v1/cities/oxford/gigs?from=YYYY-MM-DD&venue=<slug>&q=<text>&limit=100
GET /api/v1/cities/oxford/gigs/<slug>
GET /api/v1/cities/oxford/venues

feeds

Per-city calendar and feed, for calendar apps and readers:

https://www.gigstamp.co.uk/oxford/calendar.ics
https://www.gigstamp.co.uk/oxford/feed.xml

Every listing and gig page also embeds schema.org MusicEvent structured data (JSON-LD).

using the data (please read)

gigstamp is free and funded by booking referrals. When you use this data, please keep each gig's booking link (it is an affiliate link that supports us) and cite gigstamp by linking to the gig page. Attribution and those links are how the work pays for itself.

Fair use is welcome. Bulk-mirroring the catalogue, stripping the booking links or attribution, or rebuilding a competing listings service from this data is not. Listings are aggregated and may contain errors, so always confirm dates, times, and prices with the venue or ticket seller.