# Big Gay Guide

> LGBTQ+ events and organisations (gay bars, promoters, venues) — https://biggay.guide

## MCP Server (for AI agents)

Public read-only MCP API. **Do not use stdio** for remote access — use Streamable HTTP.

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

### Required headers

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

### Connection flow

1. POST `initialize` JSON-RPC to https://api.biggay.guide/mcp
2. POST `tools/list` to discover tools
3. POST `tools/call` with tool name and arguments

### Example initialize (curl)

```bash
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"}}}'
```

### Tools

- **list_cities**: List active cities with events. Use before search_events when city or country is unknown.
- **list_tags**: List available event tags for a city, optionally scoped by relativeTime. Use before search_events when filtering by tag.
- **list_festivals**: List available festivals for a city, optionally scoped by relativeTime. Use before search_events when filtering by festival.
- **search_events**: Search published gay events in a city by relative time or calendar date range. Optional filters: tags, festivals, featured, search.
- **get_event**: Get full public detail for one event by eventId. Pass city and countryCode when known.
- **search_organisations**: Search published organisations in a city by category. Use category "gay-bar" for gay bars. Other categories: promoter, venue, festival, city.
- **get_organisation**: Get full public detail for one organisation by orgId. Pass city and countryCode when known.

### 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

- MCP registry: https://biggay.guide/.well-known/mcp/server.json
- OpenAPI tool catalog: https://biggay.guide/.well-known/openapi.yaml
- AI plugin manifest: https://biggay.guide/.well-known/ai-plugin.json
- Full examples: https://biggay.guide/llms-full.txt

## Site

Big Gay Guide MCP server — public read-only API for AI agents querying LGBTQ+ guide data on https://biggay.guide.

Available: events (by city, time, tags, festivals, featured) and organisations (by city, country, category — e.g. gay-bar).