Enjoyvent Public Events API and MCP server
Read-only JSON over the events listed on Enjoyvent — concerts, theatre, stand-up, festivals, workshops, children's events — across Türkiye's 81 provinces and beyond. No authentication. Published events and sessions still to come only; one result per event.
Machine-readable description: https://api.enjoyvent.com/public/v1/openapi.json (OpenAPI 3.1). For AI assistants, the same answers are an MCP server at https://api.enjoyvent.com/mcp.
Use it in Claude, ChatGPT and other AI assistants (MCP)
The MCP server is https://api.enjoyvent.com/mcp: Streamable HTTP, read-only, with no sign-in, no API key and no Enjoyvent account needed. Ask in your own words, in English or Turkish, and the assistant picks the tool.
- Claude (claude.ai, Claude Desktop, mobile): open Enjoyvent in Claude's Connectors Directory and select Connect; on a Team or Enterprise plan an owner may have to allow it first. Or add it yourself: Customize → Connectors → Add custom connector, the URL above, authentication left empty. Then turn it on in a conversation.
- Claude Code:
claude mcp add --transport http enjoyvent https://api.enjoyvent.com/mcp - ChatGPT: add the Enjoyvent plugin from ChatGPT's plugin directory. Or add the server yourself: chatgpt.com/plugins → + → Add custom MCP server, the URL above, no authentication.
- Any other MCP client: the URL above, Streamable HTTP transport, no authentication.
| Tool | What it answers |
|---|---|
search_eventsSearch events | Find upcoming events on Enjoyvent — concerts, theatre, stand-up, festivals, workshops, children's events and more — in Türkiye's 81 provinces and other cities Enjoyvent lists. Use for questions like "what's on in İstanbul this weekend", "concerts in Kadıköy today", "children's events in Ankara", "free events in İzmir", "Duman concert dates". Filter by city or district, kind of event, date (today, tomorrow, this_weekend, this_week, next_week, next_weekend, a day, or a date range), price, free, family and availability. Returns one result per event with its matching sessions (date, time, venue), price range and the Enjoyvent page to send the person to. Prices and availability are known only for events sold on Enjoyvent (sold_on_enjoyvent: true). |
get_event_detailsGet event details | Everything about one event: description, every upcoming session with its venue and address, performers, organiser, age limits, prices and ticket availability for each session, and the Enjoyvent page to book on. Use after search_events, or when the person names a specific event or pastes an Enjoyvent event link. |
get_ticket_availabilityGet ticket availability | Current ticket prices and availability, per session and per ticket type, for one event — or one session of it. Use when the person asks "are there tickets left", "how much are tickets", "is it sold out". Live for events sold on Enjoyvent (realtime: true); for events sold on other ticketing sites Enjoyvent has no live stock or price, and the answer says so (availability.status "unknown") — never present those as sold out or free. |
get_events_by_venueGet events at a venue | Upcoming events at one venue (and its halls), soonest first: "what's on at Zorlu PSM", "Jolly Joker Kadıköy program". Optionally narrowed to a date. Returns the venue's address and location with the events; a name that covers several halls of one place lists the events of all of them, with the halls under "halls". |
get_event_categoriesGet event categories and filters | The kinds of event Enjoyvent lists (with their sub-kinds and how many upcoming sessions each has), the cities with the most events, and the filters search_events accepts. Use to learn valid category and city values, or to answer "what kinds of events are there". |
Things to ask:
- What concerts are on in İstanbul this weekend?
- Kadıköy'de bu akşam stand-up gösterisi var mı?
- Suggest events for kids in Ankara next weekend.
- What's on at Zorlu PSM next month?
- Are there tickets left for the next date of this play, and how much are they?
Every tool only reads Enjoyvent's public event listings. None buys or reserves tickets, takes a payment, reaches an account, an order or anyone's personal data, or changes an event: tickets are bought on the event's Enjoyvent page, which every answer links to. Prices and live availability exist only for events sold on Enjoyvent; for events sold on other ticketing sites the answer says so, and never calls them free or sold out.
Privacy: the server sets no cookies and asks no one to sign in. Calls are counted by tool and by the city, kind of event and date asked about; the counts keep no IP address, no account and no words of the question (privacy policy). Questions and problems: [email protected].
Endpoints
| GET | What |
|---|---|
/events | Search upcoming events (filters below). |
/events/{event} | One event: description, every upcoming session, venues, artists, tickets. |
/events/{event}/sessions | An event's sessions with prices and ticket availability. |
/sessions/{session} | One session's prices and availability. |
/venues/{venue}/events | Upcoming events at a venue (and its halls). |
/categories | Kinds of event, busiest cities, and the filters. |
/cities | Cities with upcoming events. |
/cities/{city}/districts | A city's districts with upcoming events. |
Search filters
q | Words from the event or artist name, e.g. "Duman", "Hamlet", "Cem Yılmaz". Leave out to list everything matching the other filters. |
city | City (province) name or slug, e.g. "İstanbul", "istanbul", "Ankara", "izmir". Any of Türkiye's 81 provinces and the other cities Enjoyvent lists. |
district | District (ilçe) name or slug, e.g. "Kadıköy", "beyoglu", "Çankaya". Narrower than city; give one or the other. |
category | Kind of event, as a slug or a name in Turkish or English: "konser"/"concert", "tiyatro"/"theatre", "stand-up", "festival", "atolye"/"workshop", "cocuk"/"kids", "opera", "bale", "sergi", ... get_event_categories lists them all. |
date | When: one of today, tomorrow, this_weekend, this_week, next_week, next_weekend (read in Türkiye's time, Europe/Istanbul, or the city's own), or a single day as YYYY-MM-DD. Do not combine with date_from/date_to. |
date_from | First day of a date range, YYYY-MM-DD (inclusive). Use with date_to. |
date_to | Last day of a date range, YYYY-MM-DD (inclusive), at most 366 days after date_from. |
min_price | Lowest ticket price, in the listed country's currency (TRY in Türkiye). Only events sold on Enjoyvent have known prices. |
max_price | Highest ticket price, in the listed country's currency (TRY in Türkiye). Only events sold on Enjoyvent have known prices. |
free | Only events with a free ticket. Events whose price is unknown are never counted as free. |
family | Only children's and family events. |
available | Only events with tickets on sale on Enjoyvent right now. |
venue | Venue name or slug, e.g. "Zorlu PSM". get_events_by_venue is better for "what is on at X". |
sort | soonest: by date (default). popular: most popular first. |
page | integer |
per_page | integer |
lang | Language of category names and of the Enjoyvent page URLs returned. Event titles are as the organiser wrote them. |
Examples
GET https://api.enjoyvent.com/public/v1/events?city=istanbul&date=this_weekend GET https://api.enjoyvent.com/public/v1/events?district=kadikoy&category=konser&date=today GET https://api.enjoyvent.com/public/v1/events?city=ankara&family=true GET https://api.enjoyvent.com/public/v1/events?city=izmir&free=true GET https://api.enjoyvent.com/public/v1/events?q=Duman GET https://api.enjoyvent.com/public/v1/venues/zorlu-psm/events
What the answers mean
- Times are ISO 8601 with the venue's own UTC offset; day names (
today,this_weekend, …) are read in the city's time — Europe/Istanbul in Türkiye. sold_on_enjoyvent: true: prices and availability come live from Enjoyvent's own stock. Otherwise the event is sold on another ticketing site:availability.statusisunknownand there is no price — never treat it as free or sold out.- Link people to a result's
url; that page has the dates, the venue and the tickets. - Rate limited per client address (HTTP 429 with
Retry-After); answers are cached for a minute or two.
Terms: Terms of use (Kullanım Koşulları) · Privacy: Privacy policy (Gizlilik Politikası) · Support: [email protected]