Brighton Underground - Agent & MCP Docs

Public, read-only access to upcoming live music gigs at Brighton (UK) venues.

REST API

OpenAPI 3.1 description: /openapi.json

• GET /api/gigs — every upcoming gig + aggregate stats (CORS-enabled).
• GET /rss — RSS 2.0 feed of upcoming gigs.

MCP Server

Streamable-HTTP endpoint: POST https://brightonunderground.com/mcp

Server card: /.well-known/mcp/server-card.json

Tools:

• list_all_gigs — Return every upcoming live music gig across Brighton venues. Each result includes act, date (YYYY-MM-DD), venue, and optional ticket link.
• search_gigs_by_venue — Return upcoming gigs at a Brighton venue. Match is case-insensitive substring on the venue name. Use list_venues to discover valid names.
• search_gigs_by_date — Return gigs on a specific date or within an inclusive date range. Dates must be ISO YYYY-MM-DD.
• list_venues — Return the canonical list of every Brighton venue tracked by Brighton Underground.

Authenticated write tools (add_gig, edit_gig, sync_to_server) are additionally exposed on internal SCRAPER instances. They require a write key supplied via an Authorization: Bearer <key> header or an auth_key argument and are not available on this public endpoint.

Example JSON-RPC call:

POST https://brightonunderground.com/mcp
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_gigs_by_venue",
    "arguments": { "venue": "Chalk" }
  }
}

WebMCP

Visit any page in a WebMCP-aware browser; gig search tools are registered via navigator.modelContext.registerTool(). See the WebMCP spec.

Discovery

• /.well-known/api-catalog (RFC 9727 linkset)
• /llms.txt
• /sitemap.xml

← Back to brightonunderground.com