MCP-Schnittstelle für KI-Assistenten

list_hubs List cities (hubs)

List the cities (hubs) covered by mygn.de (Hamburg, München, Oldenburg + Umland) and rundown.city (San Francisco): hub slug, display label, timezone and the website of the hub.

Keine Parameter.

list_categories List event categories

List the event categories one hub of mygn.de (Hamburg, München, Oldenburg + Umland) and rundown.city (San Francisco) currently has, each with its slug, display label (in the hub's language) and a one-line definition.

Parameter

hub string, Pflicht

Hub (city): one of hamburg, muenchen, oldenburg, san-francisco; names and abbreviations work too ('Munich', 'MUC', 'HH', 'OL', 'SF', 'SFO', 'Bay Area'), any case.

get_day_overview Day overview

How busy one day is in a hub of mygn.de (Hamburg, München, Oldenburg + Umland) and rundown.city (San Francisco): events per category, free and verified-location counts, whether the day is quiet, normal or busy against the same kind of day in the next 14 days (unknown further out) and top_curated, our editorial picks (occurrence_id, title, starts_at; empty while nothing is rated).

Parameter

hub string, Pflicht

Hub (city): one of hamburg, muenchen, oldenburg, san-francisco; names and abbreviations work too ('Munich', 'MUC', 'HH', 'OL', 'SF', 'SFO', 'Bay Area'), any case.

date string, optional

The day in the hub's own calendar, YYYY-MM-DD. Required unless when is given.

time_from string, optional

Count only events that start at or after this time of day, HH:MM in the hub's local time (24 hours), for 'tonight'. Events without a known start time (all_day, time_unknown) are not counted.

when string, optional

today, tonight (today from 18:00 unless time_from is given), tomorrow, in the hub's local calendar; echoed as resolved. Replaces date (naming both is an error).
Werte: today, tonight, tomorrow

verbose boolean, optional

true adds the internal fields (curation score and flags, signals, series_kind, kind, long_running) that are left out by default.
Standard: false

search_events Search events

Find things to do in Hamburg, München, Oldenburg or San Francisco for a date range: date ideas, tonight, this weekend, free events, family outings, concerts, parties, exhibitions, markets.

Parameter

hub string, Pflicht

Hub (city): one of hamburg, muenchen, oldenburg, san-francisco; names and abbreviations work too ('Munich', 'MUC', 'HH', 'OL', 'SF', 'SFO', 'Bay Area'), any case.

date_from string, optional

First day, inclusive, in the hub's own calendar, YYYY-MM-DD; not earlier than yesterday. At most 31 days to date_to, which is at most 31 days from today. Required unless when is given.

date_to string, optional

Last day, inclusive, in the hub's own calendar, YYYY-MM-DD; not before date_from. Required unless when is given.

when string, optional

today, tonight (today from 18:00 unless time_from is given), tomorrow, this_weekend (the coming Saturday and Sunday; on a weekend day the current one, on a Sunday that day alone), next_weekend (the one after), in the hub's local calendar; echoed as resolved. Replaces date_from and date_to (naming both is an error).
Werte: today, tonight, tomorrow, this_weekend, next_weekend

categories array of string, optional

Keep only events of these category slugs (see list_categories); use ['family'] for children's and family events. An unknown slug is an error.
Werte: party, concert, culture, show, family, food, sport, market, cruise, quiz, tours, other

free_only boolean, optional

true keeps only events known to be free.
Standard: false

venue string, optional

Venue name or town; matches the venue name as shown in results, so a town name keeps every venue in that town.

query string, optional

Literal keywords for title and summary, every word must match (compounds such as Halloweenparty are split, plural endings of whole words are read). Never a mood like 'romantic'. Filler, pronoun and time words (date, night, heute, wochenende, ideas, things to do, was ist los, ich, my, ...) are ignored; use when for dates; a query of only those has query_dropped true. Kinder, Kids, Familie and family list family events first instead of filtering. If nothing matches, unrelated curated picks of the same filters answer, with query_fallback true: tell the user nothing matched (not with group_by 'event'). A hint alone is advice, not a miss.

max_age_min integer, optional

Keep events with no stated minimum age or one of at most this age; 0 means no age restriction stated.

family_friendly boolean, optional

true keeps events suitable for parents with children (audience.family true; without an audience rating: category family without a minimum age of 16 or more); false keeps the rest.

time_from string, optional

Keep events that start at or after this time of day, HH:MM in the hub's local time (24 hours), for 'tonight'. Events without a known start time (all_day, time_unknown) are dropped. With a time_to before time_from the range wraps past midnight.

time_to string, optional

Keep events that start at or before this time of day, HH:MM in the hub's local time (24 hours).

limit integer, optional

Page size, 1 to 50 (clamped); default 25. total counts items.

cursor string, optional

The next_cursor of the previous page, to read on.

sort string, optional

'time' lists chronologically (default), events without a known start time at the end of their day; 'curation' lists the editorially ranked best first (equal ranks in time order). 'start' and 'date' are accepted as 'time'.
Werte: time, curation; Standard: "time"

group_by string, optional

'occurrence': an event once per day, its time slots in slots (occurrence_id, starts_at, ends_at; the item itself is the first slot). 'event': each event once for the whole range, with first_starts_at, last_starts_at, occurrences_count of its matching dates (filters apply first; with sort 'curation' placed by its best match) and its season_first_starts_at, season_last_starts_at, season_occurrences_count (all its upcoming dates up to 31 days ahead, ignoring the filters; the real end may lie beyond) with starts_before_range and continues_after_range. Default: 'event' when sort is 'curation' and the range spans more than one day, else 'occurrence'. Use 'event' for 'when does X open'.
Werte: occurrence, event

verbose boolean, optional

true adds the internal fields (curation score and flags, signals, series_kind, kind, long_running) that are left out by default.
Standard: false

get_event Get event details

The full record of one event occurrence (occurrence_id from search_events) in a hub of mygn.de (Hamburg, München, Oldenburg + Umland) and rundown.city (San Francisco): summary, start and end, venue with address and coordinates, price_text and price_known (false: price not known, do not assume free), age_min, audience, url (the organiser's page, for tickets and opening details), the link to this event's own page on our site or, without one, our hub page (share_url), brand, attribution_url (the hub page to cite as the source) and the next 20 other dates (siblings; siblings_truncated true when there are more).

Parameter

occurrence_id integer, Pflicht

The occurrence_id of an item from search_events.

verbose boolean, optional

true adds the internal fields (curation score and flags, signals, series_kind, kind, long_running) that are left out by default.
Standard: false