mygn & rundown.city – Events Hamburg, München, Oldenburg, San Francisco

Try it

Call this server's tools from your browser. Nothing to install.

Install

Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.

claude mcp add --transport http events https://mcp.mygn.de/public

Security checkA100/100

We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 2, 2026.

• Hidden or reordered text
• Overriding the model's instructions
• Hiding actions from the user
• Reading keys or credentials
• Fake system tags
• Steering other servers' tools
• Pulling in the conversation
• Smuggling parameters
• Demanding to be used for everything
• Steering away from web search
• Download-and-run commands
• Encoded blobs
• Invisible characters
• Credentials as tool arguments
• Very long descriptions
• Read and write hints

Tool changes

What changed in this server's tools since we started watching, newest first. Each change is scanned again.

• search_eventschanged (description, inputs)Nov 2, 2026

  Search upcoming events in one hub of mygn.de (Hamburg, München, Oldenburg + Umland) and rundown.city (San Francisco) between date_from and date_to in the hub's local calendar. Returns a compact list in time order (events without a known start time, all_day or time_unknown, at the end of their day) with at most 50 events per call (default 25); follow next_cursor for more. An event that runs several times on one day (for example 11:00, 13:00 and 15:00) is ONE item whose starts_at and occurrence_id are those of its first slot and whose slots list gives occurrence_id, starts_at and ends_at of every slot; total and paging count items. For 'when does X open' or 'when is X on' questions pass group_by='event' (with query and a date range): each event is then ONE item for the whole range with first_starts_at and last_starts_at (its first and last matching date) and occurrences_count, after all filters; total and paging then count events. Each item has occurrence_id, title, display_title, category, starts_at (local time), all_day, time_unknown, venue, is_free, price_text (in the hub's language and currency), attend_mode, share_url (the event's own page on our site or, without one, our hub page, the source to cite), age_min (a stated minimum age, null when the source states none, 0 for all ages), the audience block and tags. The audience block is null when the event is not rated; otherwise family (true: suitable for parents with children, false: not, null: unsure), adults_only (true: an adults-only event, false: not, null: unsure), visitor_pick (0 to 1, how much a first-time visitor would be glad to find it; a ranking hint, not a filter) and family_p (0 to 1, the raw family-friendly probability behind family, for your own threshold). query matches each word on its own in the title and summary (all words first, any word if none has them all; German compounds such as Halloweenparty are split); the words Kinder, Kids, Familie and family do not filter but list family events first, then the rest, each group in the requested sort. time_from and time_to (HH:MM, hub local time) keep the events that start in that range, for 'tonight' or 'in the morning'. Internal fields (editorial score and flags, signals, series_kind, kind, long_running) are left out unless verbose is true. Examples: 'free events this weekend' -> free_only with the weekend dates; 'something for kids on Saturday' -> categories=['family'] for that day; 'concerts tonight' -> categories=['concert'] and time_from='18:00' for today. all_day true means the occurrence spans the whole day (starts_at is the day anchor T00:00 and it ends at least 18 hours later). time_unknown true means starts_at is only a date anchor because no showtime is known: never show 00:00, say the time is not given. Call get_event for the details of events you will mention.

  Search upcoming events in one hub of mygn.de (Hamburg, München, Oldenburg + Umland) and rundown.city (San Francisco) between date_from and date_to in the hub's local calendar. Returns a compact list in time order (events without a known start time, all_day or time_unknown, at the end of their day) with at most 50 events per call (default 25); follow next_cursor for more. An event that runs several times on one day (for example 11:00, 13:00 and 15:00) is ONE item whose starts_at and occurrence_id are those of its first slot and whose slots list gives occurrence_id, starts_at and ends_at of every slot; total and paging count items. For 'when does X open' or 'when is X on' questions pass group_by='event' (with query and a date range): each event is then ONE item for the whole range with first_starts_at and last_starts_at (its first and last matching date) and occurrences_count, after all filters, plus its season over the hub calendar (up to 31 days ahead, whatever the filters): season_first_starts_at, season_last_starts_at, season_occurrences_count and the flags starts_before_range and continues_after_range, so a window inside a long run still tells when the event opens (it may run on past the data we hold); total and paging then count events. Each item has occurrence_id, title, display_title, category, starts_at (local time), all_day, time_unknown, venue, is_free, price_text (in the hub's language and currency), attend_mode, share_url (the event's own page on our site or, without one, our hub page, the source to cite), age_min (a stated minimum age, null when the source states none, 0 for all ages), the audience block and tags. The audience block is null when the event is not rated; otherwise family (true: suitable for parents with children, false: not, null: unsure), adults_only (true: an adults-only event, false: not, null: unsure), visitor_pick (0 to 1, how much a first-time visitor would be glad to find it; a ranking hint, not a filter) and family_p (0 to 1, the raw family-friendly probability behind family, for your own threshold). query matches each word on its own in the title and summary (all words first, any word if none has them all; German compounds such as Halloweenparty are split); the words Kinder, Kids, Familie and family do not filter but list family events first, then the rest, each group in the requested sort. time_from and time_to (HH:MM, hub local time) keep the events that start in that range, for 'tonight' or 'in the morning'. Internal fields (editorial score and flags, signals, series_kind, kind, long_running) are left out unless verbose is true. Examples: 'free events this weekend' -> free_only with the weekend dates; 'something for kids on Saturday' -> categories=['family'] for that day; 'concerts tonight' -> categories=['concert'] and time_from='18:00' for today. all_day true means the occurrence spans the whole day (starts_at is the day anchor T00:00 and it ends at least 18 hours later). time_unknown true means starts_at is only a date anchor because no showtime is known: never show 00:00, say the time is not given. Call get_event for the details of events you will mention.

  {
    "type": "object",
    "title": "search_eventsArguments",
    "required": [
      "hub",
      "date_from",
      "date_to"
    ],
    "properties": {
      "hub": {
        "type": "string",
        "title": "Hub",
        "examples": [
          "hamburg",
          "muenchen",
          "san-francisco"
        ],
        "description": "Hub (city): one of hamburg, muenchen, oldenburg, san-francisco. Case-insensitive; names and abbreviations are accepted too, for example 'Hamburg', 'HH', 'München', 'Munich', 'Muenchen', 'MUC', 'Oldenburg', 'OL', 'Oldenburg (Oldb)', 'SF', 'SFO', 'San Fran' or 'San Francisco'. Results report the slug."
      },
      "sort": {
        "enum": [
          "time",
          "curation"
        ],
        "type": "string",
        "title": "Sort",
        "default": "time",
        "examples": [
          "time"
        ],
        "description": "'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'."
      },
      "limit": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Limit",
        "default": null,
        "examples": [
          25
        ],
        "description": "Page size, 1 to 50 (clamped); default 25."
      },
      "query": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Query",
        "default": null,
        "examples": [
          "Halloween Kinder",
          "jazz"
        ],
        "description": "Words to look for in title and summary, each matched on its own (case-insensitive; all words, else any word). Kinder, Kids, Familie and family list family events first (then the rest, each group in the requested sort) instead of filtering."
      },
      "venue": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Venue",
        "default": null,
        "examples": [
          "Elbphilharmonie"
        ],
        "description": "Venue name or town; matches the venue name as shown in results, so a town name keeps every venue in that town."
      },
      "cursor": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Cursor",
        "default": null,
        "description": "The next_cursor of the previous page, to read on."
      },
      "date_to": {
        "type": "string",
        "title": "Date To",
        "format": "date",
        "description": "Last day, inclusive, in the hub's own calendar, YYYY-MM-DD; not before date_from."
      },
      "time_to": {
        "anyOf": [
          {
            "type": "string",
            "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$"
          },
          {
            "type": "null"
          }
        ],
        "title": "Time To",
        "default": null,
        "examples": [
          "23:59"
        ],
        "description": "Keep events that start at or before this time of day, HH:MM in the hub's local time (24 hours). See time_from. A range that wraps past midnight (time_from after time_to) applies to the start time of each day of the window."
      },
      "verbose": {
        "type": "boolean",
        "title": "Verbose",
        "default": false,
        "description": "true adds the internal fields (curation score and flags, signals, series_kind, kind, long_running) that are left out by default."
      },
      "group_by": {
        "enum": [
          "occurrence",
          "event"
        ],
        "type": "string",
        "title": "Group By",
        "default": "occurrence",
        "examples": [
          "event"
        ],
        "description": "'occurrence' (default) lists an event once per day, with its time slots; 'event' lists each event once for the whole date range, with first_starts_at, last_starts_at and occurrences_count of its matching dates (all filters apply first). Use 'event' for 'when does X open' or 'when is X on'."
      },
      "date_from": {
        "type": "string",
        "title": "Date From",
        "format": "date",
        "description": "First day, inclusive, in the hub's own calendar, YYYY-MM-DD. Not earlier than yesterday; the window to date_to is at most 31 days and ends at most 31 days from today."
      },
      "free_only": {
        "type": "boolean",
        "title": "Free Only",
        "default": false,
        "description": "true keeps only events known to be free."
      },
      "time_from": {
        "anyOf": [
          {
            "type": "string",
            "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$"
          },
          {
            "type": "null"
          }
        ],
        "title": "Time From",
        "default": null,
        "examples": [
          "18:00"
        ],
        "description": "Keep events that start at or after this time of day, HH:MM in the hub's local time (24 hours). Events without a known start time (all_day, time_unknown) are dropped when a time is given. With a time_to before time_from the range wraps past midnight."
      },
      "categories": {
        "type": "array",
        "items": {
          "enum": [
            "party",
            "concert",
            "culture",
            "show",
            "family",
            "food",
            "sport",
            "market",
            "cruise",
            "quiz",
            "tours",
            "other"
          ],
          "type": "string"
        },
        "title": "Categories",
        "examples": [
          [
            "family"
          ],
          [
            "concert",
            "show"
          ]
        ],
        "description": "Keep only events of these category slugs (see list_categories); use ['family'] for children's and family events. An unknown slug is an error."
      },
      "max_age_min": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Max Age Min",
        "default": null,
        "examples": [
          12
        ],
        "description": "Keep events with no stated minimum age or one of at most this age; 0 means no age restriction stated."
      },
      "family_friendly": {
        "anyOf": [
          {
            "type": "boolean"
          },
          {
            "type": "null"
          }
        ],
        "title": "Family Friendly",
        "default": null,
        "description": "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."
      }
    }
  }

  {
    "type": "object",
    "title": "search_eventsArguments",
    "required": [
      "hub",
      "date_from",
      "date_to"
    ],
    "properties": {
      "hub": {
        "type": "string",
        "title": "Hub",
        "examples": [
          "hamburg",
          "muenchen",
          "san-francisco"
        ],
        "description": "Hub (city): one of hamburg, muenchen, oldenburg, san-francisco. Case-insensitive; names and abbreviations are accepted too, for example 'Hamburg', 'HH', 'München', 'Munich', 'Muenchen', 'MUC', 'Oldenburg', 'OL', 'Oldenburg (Oldb)', 'SF', 'SFO', 'San Fran' or 'San Francisco'. Results report the slug."
      },
      "sort": {
        "enum": [
          "time",
          "curation"
        ],
        "type": "string",
        "title": "Sort",
        "default": "time",
        "examples": [
          "time"
        ],
        "description": "'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'."
      },
      "limit": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Limit",
        "default": null,
        "examples": [
          25
        ],
        "description": "Page size, 1 to 50 (clamped); default 25."
      },
      "query": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Query",
        "default": null,
        "examples": [
          "Halloween Kinder",
          "jazz"
        ],
        "description": "Words to look for in title and summary, each matched on its own (case-insensitive; all words, else any word). Kinder, Kids, Familie and family list family events first (then the rest, each group in the requested sort) instead of filtering."
      },
      "venue": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Venue",
        "default": null,
        "examples": [
          "Elbphilharmonie"
        ],
        "description": "Venue name or town; matches the venue name as shown in results, so a town name keeps every venue in that town."
      },
      "cursor": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Cursor",
        "default": null,
        "description": "The next_cursor of the previous page, to read on."
      },
      "date_to": {
        "type": "string",
        "title": "Date To",
        "format": "date",
        "description": "Last day, inclusive, in the hub's own calendar, YYYY-MM-DD; not before date_from."
      },
      "time_to": {
        "anyOf": [
          {
            "type": "string",
            "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$"
          },
          {
            "type": "null"
          }
        ],
        "title": "Time To",
        "default": null,
        "examples": [
          "23:59"
        ],
        "description": "Keep events that start at or before this time of day, HH:MM in the hub's local time (24 hours). See time_from. A range that wraps past midnight (time_from after time_to) applies to the start time of each day of the window."
      },
      "verbose": {
        "type": "boolean",
        "title": "Verbose",
        "default": false,
        "description": "true adds the internal fields (curation score and flags, signals, series_kind, kind, long_running) that are left out by default."
      },
      "group_by": {
        "enum": [
          "occurrence",
          "event"
        ],
        "type": "string",
        "title": "Group By",
        "default": "occurrence",
        "examples": [
          "event"
        ],
        "description": "'occurrence' (default) lists an event once per day, with its time slots; 'event' lists each event once for the whole date range, with first_starts_at, last_starts_at and occurrences_count of its matching dates (all filters apply first; with sort 'curation' it is placed by its best-ranked match but shows its earliest) and its season season_first_starts_at, season_last_starts_at, season_occurrences_count (all its upcoming dates in our hub calendar, up to 31 days ahead, not narrowed by the filters; the real end may lie beyond) with starts_before_range and continues_after_range. Use 'event' for 'when does X open' or 'when is X on'."
      },
      "date_from": {
        "type": "string",
        "title": "Date From",
        "format": "date",
        "description": "First day, inclusive, in the hub's own calendar, YYYY-MM-DD. Not earlier than yesterday; the window to date_to is at most 31 days and ends at most 31 days from today."
      },
      "free_only": {
        "type": "boolean",
        "title": "Free Only",
        "default": false,
        "description": "true keeps only events known to be free."
      },
      "time_from": {
        "anyOf": [
          {
            "type": "string",
            "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$"
          },
          {
            "type": "null"
          }
        ],
        "title": "Time From",
        "default": null,
        "examples": [
          "18:00"
        ],
        "description": "Keep events that start at or after this time of day, HH:MM in the hub's local time (24 hours). Events without a known start time (all_day, time_unknown) are dropped when a time is given. With a time_to before time_from the range wraps past midnight."
      },
      "categories": {
        "type": "array",
        "items": {
          "enum": [
            "party",
            "concert",
            "culture",
            "show",
            "family",
            "food",
            "sport",
            "market",
            "cruise",
            "quiz",
            "tours",
            "other"
          ],
          "type": "string"
        },
        "title": "Categories",
        "examples": [
          [
            "family"
          ],
          [
            "concert",
            "show"
          ]
        ],
        "description": "Keep only events of these category slugs (see list_categories); use ['family'] for children's and family events. An unknown slug is an error."
      },
      "max_age_min": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Max Age Min",
        "default": null,
        "examples": [
          12
        ],
        "description": "Keep events with no stated minimum age or one of at most this age; 0 means no age restriction stated."
      },
      "family_friendly": {
        "anyOf": [
          {
            "type": "boolean"
          },
          {
            "type": "null"
          }
        ],
        "title": "Family Friendly",
        "default": null,
        "description": "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."
      }
    }
  }

• search_eventschanged (description, inputs)Nov 2, 2026

  Search upcoming events in one hub of mygn.de (Hamburg, München, Oldenburg + Umland) and rundown.city (San Francisco) between date_from and date_to in the hub's local calendar. Returns a compact list in time order with at most 50 events per call (default 25); follow next_cursor for more. An event that runs several times on one day (for example 11:00, 13:00 and 15:00) is ONE item whose starts_at and occurrence_id are those of its first slot and whose slots list gives occurrence_id, starts_at and ends_at of every slot; total and paging count items. Each item has occurrence_id, title, display_title, category, starts_at (local time), all_day, time_unknown, venue, is_free, price_text (in the hub's language and currency), attend_mode, share_url (the event's own page on our site or, without one, our hub page, the source to cite), age_min (a stated minimum age, null when the source states none, 0 for all ages), the audience block and tags. The audience block is null when the event is not rated; otherwise family (true: suitable for parents with children, false: not, null: unsure), adults_only (true: an adults-only event, false: not, null: unsure), visitor_pick (0 to 1, how much a first-time visitor would be glad to find it; a ranking hint, not a filter) and family_p (0 to 1, the raw family-friendly probability behind family, for your own threshold). query matches each word on its own in the title and summary (all words first, any word if none has them all; German compounds such as Halloweenparty are split); the words Kinder, Kids, Familie and family do not filter but list family events first, then the rest, each group in the requested sort. time_from and time_to (HH:MM, hub local time) keep the events that start in that range, for 'tonight' or 'in the morning'. Internal fields (editorial score and flags, signals, series_kind, kind, long_running) are left out unless verbose is true. Examples: 'free events this weekend' -> free_only with the weekend dates; 'something for kids on Saturday' -> categories=['family'] for that day; 'concerts tonight' -> categories=['concert'] and time_from='18:00' for today. all_day true means the occurrence spans the whole day (starts_at is the day anchor T00:00 and it ends at least 18 hours later). time_unknown true means starts_at is only a date anchor because no showtime is known: never show 00:00, say the time is not given. Call get_event for the details of events you will mention.

  Search upcoming events in one hub of mygn.de (Hamburg, München, Oldenburg + Umland) and rundown.city (San Francisco) between date_from and date_to in the hub's local calendar. Returns a compact list in time order (events without a known start time, all_day or time_unknown, at the end of their day) with at most 50 events per call (default 25); follow next_cursor for more. An event that runs several times on one day (for example 11:00, 13:00 and 15:00) is ONE item whose starts_at and occurrence_id are those of its first slot and whose slots list gives occurrence_id, starts_at and ends_at of every slot; total and paging count items. For 'when does X open' or 'when is X on' questions pass group_by='event' (with query and a date range): each event is then ONE item for the whole range with first_starts_at and last_starts_at (its first and last matching date) and occurrences_count, after all filters; total and paging then count events. Each item has occurrence_id, title, display_title, category, starts_at (local time), all_day, time_unknown, venue, is_free, price_text (in the hub's language and currency), attend_mode, share_url (the event's own page on our site or, without one, our hub page, the source to cite), age_min (a stated minimum age, null when the source states none, 0 for all ages), the audience block and tags. The audience block is null when the event is not rated; otherwise family (true: suitable for parents with children, false: not, null: unsure), adults_only (true: an adults-only event, false: not, null: unsure), visitor_pick (0 to 1, how much a first-time visitor would be glad to find it; a ranking hint, not a filter) and family_p (0 to 1, the raw family-friendly probability behind family, for your own threshold). query matches each word on its own in the title and summary (all words first, any word if none has them all; German compounds such as Halloweenparty are split); the words Kinder, Kids, Familie and family do not filter but list family events first, then the rest, each group in the requested sort. time_from and time_to (HH:MM, hub local time) keep the events that start in that range, for 'tonight' or 'in the morning'. Internal fields (editorial score and flags, signals, series_kind, kind, long_running) are left out unless verbose is true. Examples: 'free events this weekend' -> free_only with the weekend dates; 'something for kids on Saturday' -> categories=['family'] for that day; 'concerts tonight' -> categories=['concert'] and time_from='18:00' for today. all_day true means the occurrence spans the whole day (starts_at is the day anchor T00:00 and it ends at least 18 hours later). time_unknown true means starts_at is only a date anchor because no showtime is known: never show 00:00, say the time is not given. Call get_event for the details of events you will mention.

  {
    "type": "object",
    "title": "search_eventsArguments",
    "required": [
      "hub",
      "date_from",
      "date_to"
    ],
    "properties": {
      "hub": {
        "type": "string",
        "title": "Hub",
        "examples": [
          "hamburg",
          "muenchen",
          "san-francisco"
        ],
        "description": "Hub (city): one of hamburg, muenchen, oldenburg, san-francisco. Case-insensitive; names and abbreviations are accepted too, for example 'Hamburg', 'HH', 'München', 'Munich', 'Muenchen', 'MUC', 'Oldenburg', 'OL', 'Oldenburg (Oldb)', 'SF', 'SFO', 'San Fran' or 'San Francisco'. Results report the slug."
      },
      "sort": {
        "enum": [
          "time",
          "curation"
        ],
        "type": "string",
        "title": "Sort",
        "default": "time",
        "examples": [
          "time"
        ],
        "description": "'time' lists chronologically (default); 'curation' lists the editorially ranked best first."
      },
      "limit": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Limit",
        "default": null,
        "examples": [
          25
        ],
        "description": "Page size, 1 to 50 (clamped); default 25."
      },
      "query": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Query",
        "default": null,
        "examples": [
          "Halloween Kinder",
          "jazz"
        ],
        "description": "Words to look for in title and summary, each matched on its own (case-insensitive; all words, else any word). Kinder, Kids, Familie and family list family events first (then the rest, each group in the requested sort) instead of filtering."
      },
      "venue": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Venue",
        "default": null,
        "examples": [
          "Elbphilharmonie"
        ],
        "description": "Venue name or town; matches the venue name as shown in results, so a town name keeps every venue in that town."
      },
      "cursor": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Cursor",
        "default": null,
        "description": "The next_cursor of the previous page, to read on."
      },
      "date_to": {
        "type": "string",
        "title": "Date To",
        "format": "date",
        "description": "Last day, inclusive, in the hub's own calendar, YYYY-MM-DD; not before date_from."
      },
      "time_to": {
        "anyOf": [
          {
            "type": "string",
            "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$"
          },
          {
            "type": "null"
          }
        ],
        "title": "Time To",
        "default": null,
        "examples": [
          "23:59"
        ],
        "description": "Keep events that start at or before this time of day, HH:MM in the hub's local time (24 hours). See time_from. A range that wraps past midnight (time_from after time_to) applies to the start time of each day of the window."
      },
      "verbose": {
        "type": "boolean",
        "title": "Verbose",
        "default": false,
        "description": "true adds the internal fields (curation score and flags, signals, series_kind, kind, long_running) that are left out by default."
      },
      "date_from": {
        "type": "string",
        "title": "Date From",
        "format": "date",
        "description": "First day, inclusive, in the hub's own calendar, YYYY-MM-DD. Not earlier than yesterday; the window to date_to is at most 31 days and ends at most 31 days from today."
      },
      "free_only": {
        "type": "boolean",
        "title": "Free Only",
        "default": false,
        "description": "true keeps only events known to be free."
      },
      "time_from": {
        "anyOf": [
          {
            "type": "string",
            "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$"
          },
          {
            "type": "null"
          }
        ],
        "title": "Time From",
        "default": null,
        "examples": [
          "18:00"
        ],
        "description": "Keep events that start at or after this time of day, HH:MM in the hub's local time (24 hours). Events without a known start time (all_day, time_unknown) are dropped when a time is given. With a time_to before time_from the range wraps past midnight."
      },
      "categories": {
        "type": "array",
        "items": {
          "enum": [
            "party",
            "concert",
            "culture",
            "show",
            "family",
            "food",
            "sport",
            "market",
            "cruise",
            "quiz",
            "tours",
            "other"
          ],
          "type": "string"
        },
        "title": "Categories",
        "examples": [
          [
            "family"
          ],
          [
            "concert",
            "show"
          ]
        ],
        "description": "Keep only events of these category slugs (see list_categories); use ['family'] for children's and family events. An unknown slug is an error."
      },
      "max_age_min": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Max Age Min",
        "default": null,
        "examples": [
          12
        ],
        "description": "Keep events with no stated minimum age or one of at most this age; 0 means no age restriction stated."
      },
      "family_friendly": {
        "anyOf": [
          {
            "type": "boolean"
          },
          {
            "type": "null"
          }
        ],
        "title": "Family Friendly",
        "default": null,
        "description": "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."
      }
    }
  }

  {
    "type": "object",
    "title": "search_eventsArguments",
    "required": [
      "hub",
      "date_from",
      "date_to"
    ],
    "properties": {
      "hub": {
        "type": "string",
        "title": "Hub",
        "examples": [
          "hamburg",
          "muenchen",
          "san-francisco"
        ],
        "description": "Hub (city): one of hamburg, muenchen, oldenburg, san-francisco. Case-insensitive; names and abbreviations are accepted too, for example 'Hamburg', 'HH', 'München', 'Munich', 'Muenchen', 'MUC', 'Oldenburg', 'OL', 'Oldenburg (Oldb)', 'SF', 'SFO', 'San Fran' or 'San Francisco'. Results report the slug."
      },
      "sort": {
        "enum": [
          "time",
          "curation"
        ],
        "type": "string",
        "title": "Sort",
        "default": "time",
        "examples": [
          "time"
        ],
        "description": "'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'."
      },
      "limit": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Limit",
        "default": null,
        "examples": [
          25
        ],
        "description": "Page size, 1 to 50 (clamped); default 25."
      },
      "query": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Query",
        "default": null,
        "examples": [
          "Halloween Kinder",
          "jazz"
        ],
        "description": "Words to look for in title and summary, each matched on its own (case-insensitive; all words, else any word). Kinder, Kids, Familie and family list family events first (then the rest, each group in the requested sort) instead of filtering."
      },
      "venue": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Venue",
        "default": null,
        "examples": [
          "Elbphilharmonie"
        ],
        "description": "Venue name or town; matches the venue name as shown in results, so a town name keeps every venue in that town."
      },
      "cursor": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Cursor",
        "default": null,
        "description": "The next_cursor of the previous page, to read on."
      },
      "date_to": {
        "type": "string",
        "title": "Date To",
        "format": "date",
        "description": "Last day, inclusive, in the hub's own calendar, YYYY-MM-DD; not before date_from."
      },
      "time_to": {
        "anyOf": [
          {
            "type": "string",
            "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$"
          },
          {
            "type": "null"
          }
        ],
        "title": "Time To",
        "default": null,
        "examples": [
          "23:59"
        ],
        "description": "Keep events that start at or before this time of day, HH:MM in the hub's local time (24 hours). See time_from. A range that wraps past midnight (time_from after time_to) applies to the start time of each day of the window."
      },
      "verbose": {
        "type": "boolean",
        "title": "Verbose",
        "default": false,
        "description": "true adds the internal fields (curation score and flags, signals, series_kind, kind, long_running) that are left out by default."
      },
      "group_by": {
        "enum": [
          "occurrence",
          "event"
        ],
        "type": "string",
        "title": "Group By",
        "default": "occurrence",
        "examples": [
          "event"
        ],
        "description": "'occurrence' (default) lists an event once per day, with its time slots; 'event' lists each event once for the whole date range, with first_starts_at, last_starts_at and occurrences_count of its matching dates (all filters apply first). Use 'event' for 'when does X open' or 'when is X on'."
      },
      "date_from": {
        "type": "string",
        "title": "Date From",
        "format": "date",
        "description": "First day, inclusive, in the hub's own calendar, YYYY-MM-DD. Not earlier than yesterday; the window to date_to is at most 31 days and ends at most 31 days from today."
      },
      "free_only": {
        "type": "boolean",
        "title": "Free Only",
        "default": false,
        "description": "true keeps only events known to be free."
      },
      "time_from": {
        "anyOf": [
          {
            "type": "string",
            "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$"
          },
          {
            "type": "null"
          }
        ],
        "title": "Time From",
        "default": null,
        "examples": [
          "18:00"
        ],
        "description": "Keep events that start at or after this time of day, HH:MM in the hub's local time (24 hours). Events without a known start time (all_day, time_unknown) are dropped when a time is given. With a time_to before time_from the range wraps past midnight."
      },
      "categories": {
        "type": "array",
        "items": {
          "enum": [
            "party",
            "concert",
            "culture",
            "show",
            "family",
            "food",
            "sport",
            "market",
            "cruise",
            "quiz",
            "tours",
            "other"
          ],
          "type": "string"
        },
        "title": "Categories",
        "examples": [
          [
            "family"
          ],
          [
            "concert",
            "show"
          ]
        ],
        "description": "Keep only events of these category slugs (see list_categories); use ['family'] for children's and family events. An unknown slug is an error."
      },
      "max_age_min": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Max Age Min",
        "default": null,
        "examples": [
          12
        ],
        "description": "Keep events with no stated minimum age or one of at most this age; 0 means no age restriction stated."
      },
      "family_friendly": {
        "anyOf": [
          {
            "type": "boolean"
          },
          {
            "type": "null"
          }
        ],
        "title": "Family Friendly",
        "default": null,
        "description": "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."
      }
    }
  }

• get_day_overviewchanged (description, inputs)Nov 2, 2026

  How busy one day is in a hub of mygn.de (Hamburg, München, Oldenburg + Umland) and rundown.city (San Francisco): the number of events per category, how many are free, how many have a verified location, whether the day is quiet, normal or busy compared with the same kind of day (weekday or weekend) in the next 14 days (unknown for a day further out, where the listings are not complete yet) and top_curated, our editorial picks of the day (occurrence_id, title, starts_at; empty while nothing is rated). Events are counted once per day however many time slots they have. time_from (HH:MM, hub local time) counts only the events that start at or after that time, for 'tonight' (events without a known start time are then not counted, as in search_events; busyness still compares the whole day). Use it to answer 'is there a lot on this Saturday' before listing events with search_events.

  {
    "type": "object",
    "title": "get_day_overviewArguments",
    "required": [
      "hub",
      "date"
    ],
    "properties": {
      "hub": {
        "type": "string",
        "title": "Hub",
        "examples": [
          "hamburg",
          "muenchen",
          "san-francisco"
        ],
        "description": "Hub (city): one of hamburg, muenchen, oldenburg, san-francisco. Case-insensitive; names and abbreviations are accepted too, for example 'Hamburg', 'HH', 'München', 'Munich', 'Muenchen', 'MUC', 'Oldenburg', 'OL', 'Oldenburg (Oldb)', 'SF', 'SFO', 'San Fran' or 'San Francisco'. Results report the slug."
      },
      "date": {
        "type": "string",
        "title": "Date",
        "format": "date",
        "description": "The day in the hub's own calendar, YYYY-MM-DD."
      },
      "verbose": {
        "type": "boolean",
        "title": "Verbose",
        "default": false,
        "description": "true adds the internal fields (curation score and flags, signals, series_kind, kind, long_running) that are left out by default."
      }
    }
  }

  {
    "type": "object",
    "title": "get_day_overviewArguments",
    "required": [
      "hub",
      "date"
    ],
    "properties": {
      "hub": {
        "type": "string",
        "title": "Hub",
        "examples": [
          "hamburg",
          "muenchen",
          "san-francisco"
        ],
        "description": "Hub (city): one of hamburg, muenchen, oldenburg, san-francisco. Case-insensitive; names and abbreviations are accepted too, for example 'Hamburg', 'HH', 'München', 'Munich', 'Muenchen', 'MUC', 'Oldenburg', 'OL', 'Oldenburg (Oldb)', 'SF', 'SFO', 'San Fran' or 'San Francisco'. Results report the slug."
      },
      "date": {
        "type": "string",
        "title": "Date",
        "format": "date",
        "description": "The day in the hub's own calendar, YYYY-MM-DD."
      },
      "verbose": {
        "type": "boolean",
        "title": "Verbose",
        "default": false,
        "description": "true adds the internal fields (curation score and flags, signals, series_kind, kind, long_running) that are left out by default."
      },
      "time_from": {
        "anyOf": [
          {
            "type": "string",
            "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$"
          },
          {
            "type": "null"
          }
        ],
        "title": "Time From",
        "default": null,
        "examples": [
          "17:00"
        ],
        "description": "Count only events that start at or after this time of day, HH:MM in the hub's local time (24 hours), for example '17:00' for tonight. Events without a known start time (all_day, time_unknown) are then not counted; busyness still compares the whole day."
      }
    }
  }