For developers · free API key
What’s On events, in your app.
The events guests see in What’s On by FreeGuides, as JSON: a city’s gigs, markets, nights out and weekly socials, by country, city and category. Ask for a key and build with it.
Planning with an AI assistant instead? Add What’s On to Claude or ChatGPT: no key needed.
What you get
- Events by city and categoryWhat’s on this week in a city, filtered by category, date range or keywords.
- Times that are rightStart and end in the venue’s own time zone, and every night of a weekly event.
- Ready to showVenue, price, image, the What’s On page and the organiser’s booking link.
- Any language, any stackJSON over GET or POST, from a server or a browser (CORS open).
How it works
- 1Request a keyTell us who you are and what you’re building.
- 2We approve itThe team reads every request and emails your key.
- 3Send it with each requestIn an X-API-Key header. Keep it private, like a password.
A request
curl -H "X-API-Key: YOUR_KEY" \
"https://explore.freeguides.com/api/v1/events?country=Australia&city=Sydney&category=nightlife"Leave out category for every event, or add date, from and to, limit and q. https://explore.freeguides.com/api/v1/categories lists the categories and countries covered. Link to events with the bookingUrl we send, as it is.
In Claude, ChatGPT and other AI assistants
What’s On is also an MCP server, free with no key or sign-in. Add it to Claude or ChatGPT and ask what’s on, plan a day or a whole trip, with a booking link for everything. The connector URL:
https://explore.freeguides.com/mcp- Claude: Customize → Connectors → + Add → Add custom connector, paste the URL, choose No sign in. Open Claude
- ChatGPT: Plugins → + → Add custom MCP server, paste the URL, choose No authentication. Open ChatGPT
- Claude Code:
claude mcp add --transport http whats-on https://explore.freeguides.com/mcp
Step-by-step for Claude, ChatGPT, Gemini and Grok
Questions? hello@freeguides.com