# Big Gay Guide — MCP API (full reference)

Extended documentation for AI agents. Summary: https://biggay.guide/llms.txt

## Connection

- Endpoint: https://api.biggay.guide/mcp
- Transport: MCP Streamable HTTP (JSON-RPC 2.0 over POST)
- Protocol version: 2025-03-26
- Auth: none

### Required headers

```
Content-Type: application/json
Accept: application/json, text/event-stream
Mcp-Protocol-Version: 2025-03-26
```

## Tool examples

### list_cities

List active cities with events. Use before search_events when city or country is unknown.

```json
{}
```

### list_tags

List available event tags for a city, optionally scoped by relativeTime. Use before search_events when filtering by tag.

```json
{
  "city": "Melbourne",
  "countryCode": "AU",
  "relativeTime": "tonight"
}
```

### list_festivals

List available festivals for a city, optionally scoped by relativeTime. Use before search_events when filtering by festival.

```json
{
  "city": "Melbourne",
  "countryCode": "AU",
  "relativeTime": "upcoming"
}
```

### search_events

Search published gay events in a city by relative time or calendar date range. Optional filters: tags, festivals, featured, search.

```json
{
  "city": "Melbourne",
  "countryCode": "AU",
  "relativeTime": "this-weekend",
  "limit": 10
}
```

### search_events (date range)

Search published gay events in a city by relative time or calendar date range. Optional filters: tags, festivals, featured, search.

```json
{
  "city": "Sydney",
  "countryCode": "AU",
  "startDate": "2026-06-15",
  "endDate": "2026-06-15"
}
```

### search_events (featured)

Search published gay events in a city by relative time or calendar date range. Optional filters: tags, festivals, featured, search.

```json
{
  "city": "Melbourne",
  "countryCode": "AU",
  "relativeTime": "this-weekend",
  "featured": true
}
```

### search_events (festival)

Search published gay events in a city by relative time or calendar date range. Optional filters: tags, festivals, featured, search.

```json
{
  "city": "Melbourne",
  "countryCode": "AU",
  "relativeTime": "upcoming",
  "festivals": [
    "Midsumma 2026"
  ]
}
```

### get_event

Get full public detail for one event by eventId. Pass city and countryCode when known.

```json
{
  "eventId": "thick-n-juicy-underwear-party-2025-08-22",
  "city": "Melbourne",
  "countryCode": "AU"
}
```

### search_organisations (gay bars)

Search published organisations in a city by category. Use category "gay-bar" for gay bars. Other categories: promoter, venue, festival, city.

```json
{
  "city": "Melbourne",
  "countryCode": "AU",
  "category": "gay-bar"
}
```

### get_organisation

Get full public detail for one organisation by orgId. Pass city and countryCode when known.

```json
{
  "orgId": "sircuit-bar-melbourne",
  "city": "Melbourne",
  "countryCode": "AU"
}
```

## relativeTime values

now, today, tonight, tomorrow, this-weekend, this-week, next-week, future, upcoming, latest, monday, tuesday, wednesday, thursday, friday, saturday, sunday

## Organisation categories

gay-bar, promoter, venue, festival, city

## Example workflows

**Gay bars:** list_cities → search_organisations (category gay-bar) → get_organisation

**Events:** list_cities → list_tags or list_festivals → search_events → get_event

## Canonical URLs

- Events: https://biggay.guide/{countryCode}/{city-slug}/gay-events/{eventId}
- Gay bars: https://biggay.guide/{countryCode}/{city-slug}/gay-bars/{orgId}

## Discovery files

- https://biggay.guide/.well-known/mcp/server.json
- https://biggay.guide/.well-known/openapi.yaml
- https://biggay.guide/.well-known/ai-plugin.json
- https://biggay.guide/mcp