Big GayGuide
The Big Gay Guide MCP server is a public read-only API for AI agents and developers — the same published data shown on biggay.guide.
Available now: LGBTQ+ events and organisations (gay bars, promoters, venues, festivals, cities).
Planned: people (DJs, drag queens, performers, artists).
MCP uses JSON-RPC 2.0 for all messages. Remote agents cannot use stdio over the internet — connect via MCP Streamable HTTP (not a legacy standalone /sse URL).
Endpoint: https://api.biggay.guide/mcp (POST only)
Transport: streamable-http — stateless JSON responses. No API key.
Required headers:
Content-Type: application/json
Accept: application/json, text/event-stream
Mcp-Protocol-Version: 2025-03-26Flow: initialize → tools/list → tools/call
Example initialize (curl):
curl -X POST https://api.biggay.guide/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Mcp-Protocol-Version: 2025-03-26" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"agent","version":"1.0"}}}'Returns active cities with cityName, countryCode, timezone, and event count.
{}Returns available tags for a city, with counts scoped by relativeTime (defaults to upcoming). Use before search_events when filtering by tag.
{
"city": "Melbourne",
"countryCode": "AU",
"relativeTime": "tonight"
}Returns available festivals for a city, with counts scoped by relativeTime (defaults to upcoming). Use exact festival names from this tool in search_events.
{
"city": "Melbourne",
"countryCode": "AU",
"relativeTime": "upcoming"
}Primary event discovery tool. Requires city and countryCode, plus either relativeTime or both startDate and endDate (ISO YYYY-MM-DD).
Optional filters: tags, festivals, featured, search, limit (1–50, default 20).
{
"city": "Melbourne",
"countryCode": "AU",
"relativeTime": "this-weekend",
"limit": 10
}Full event detail including description, tickets, venues, and gallery.
{
"eventId": "thick-n-juicy-underwear-party-2025-08-22",
"city": "Melbourne",
"countryCode": "AU"
}Search published organisations by city and category. Use category: "gay-bar" for gay bars — same filters as the gay bars page.
Categories: gay-bar, promoter, venue, festival, city.
{
"city": "Melbourne",
"countryCode": "AU",
"category": "gay-bar"
}Full organisation detail including description, opening hours, and contact info.
{
"orgId": "sircuit-bar-melbourne",
"city": "Melbourne",
"countryCode": "AU"
}now, today, tonight, tomorrow, this-weekend, this-week, next-week, future, upcoming, latest, monday, tuesday, wednesday, thursday, friday, saturday, sunday
search_organisations with category: "gay-bar", city, and countryCodeget_organisation with the chosen orgId for hours and contactlist_cities → find Melbourne, AUsearch_events with relativeTime: "this-weekend"get_event with the chosen eventIdGay bars:
https://biggay.guide/{countryCode}/{city-slug}/gay-bars/{orgId}Events:
https://biggay.guide/{countryCode}/{city-slug}/gay-events/{eventId}