MCP API — Big Gay Guide for AI Agents

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.

Scope

Available now: LGBTQ+ events and organisations (gay bars, promoters, venues, festivals, cities).

Planned: people (DJs, drag queens, performers, artists).

Connecting

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:

Flow: initialize → tools/list → tools/call

Client configuration

No API key. Cursor and other clients send the required MCP headers automatically when using Streamable HTTP.

Cursor (IDE & Cloud Agents)

Add to .cursor/mcp.json in your project, or ~/.cursor/mcp.json for all projects. Reload the window after saving.

Cloud Agents: paste the same JSON in the MCP dropdown at cursor.com/agents, or under Dashboard → Integrations & MCP for team-wide access. Use the url form (HTTP) — Cloud Agents do not support SSE or mcp-remote.

Claude Code / Cursor CLI

Add to ~/.claude/settings.json (or project .claude/settings.json):

Claude Desktop & other stdio-only clients

Claude Desktop does not accept a bare url in claude_desktop_config.json. Use the mcp-remote stdio bridge, or add the endpoint as a custom connector in Claude Desktop settings (Settings → Connectors).

Config file: macOS ~/Library/Application Support/Claude/claude_desktop_config.json; Windows %APPDATA%\Claude\claude_desktop_config.json

Windsurf

Windsurf uses serverUrl instead of url in ~/.codeium/windsurf/mcp_config.json:

Error responses

All errors are JSON-RPC 2.0 envelopes with Content-Type: application/json — never HTML error pages. Agents can rely on standard codes:

• -32700 Parse error — malformed JSON syntax
• -32600 Invalid Request — empty body, missing jsonrpc: "2.0", or wrong HTTP method
• -32601 Method not found — unknown JSON-RPC method
• -32603 Internal error — unexpected server failure

Example initialize (curl):

Tools (events)

list_cities

Returns active cities with cityName, countryCode, timezone, and event count.

list_tags

Returns available tags for a city, with counts scoped by relativeTime (defaults to upcoming). Use before search_events when filtering by tag.

list_festivals

Returns available festivals for a city, with counts scoped by relativeTime (defaults to upcoming). Use exact festival names from this tool in search_events.

search_events

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).

get_event

Full event detail including description, tickets, venues, and gallery.

Tools (organisations)

search_organisations

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.

get_organisation

Full organisation detail including description, opening hours, and contact info.

Supported relativeTime values

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

Example agent workflows

Gay bars

1. search_organisations with category: "gay-bar", city, and countryCode
2. get_organisation with the chosen orgId for hours and contact

Events

1. list_cities → find Melbourne, AU
2. search_events with relativeTime: "this-weekend"
3. get_event with the chosen eventId

Canonical URLs

Gay bars:

Events:

Discovery (machine-readable)

• llms.txt — AI agent overview
• llms-full.txt — extended examples
• MCP server.json — registry manifest
• openapi.yaml — tool catalog
• ai-plugin.json — legacy AI plugin manifest