MCP Server

СПОНТАННО

space.spontanno/events
Travel & Hospitality Public & reachable MCP 2025-11-25

What this MCP does

Searches concerts, theatre, exhibitions, lectures, and other events in Russian cities, with event details, random recommendations, and shareable shortlists.

create_shortlist
Подборка ссылкой
Save 2–10 events from previous results as one shareable page spontanno.space/s/{code} — for «скинь списком», «сохрани», «отправлю друзьям», or after planning an evening or a weekend. Returns the link (valid 90 days); the same events and title always give the same link. Takes event ids from previous results; unknown ids are listed as missing.
Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['event_ids'], 'properties': {'title': {'type': 'string', 'maxLength': 80, 'minLength': 1, 'description': "Short heading in Russian, e.g. 'Пятница вечером в Москве'. No links, contacts or emoji."}, 'event_ids': {'type': 'array', 'items': {'type': 'string', 'maxLength': 300, 'minLength': 1}, 'maxItems': 10, 'minItems': 2, 'description': 'Event ids from previous results, 2–10, in the order to show.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['view', 'code', 'url', 'title', 'expires_at', 'events', 'missing'], 'properties': {'url': {'type': 'string'}, 'code': {'type': 'string'}, 'view': {'type': 'string', 'const': 'shortlist'}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'events': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}, 'missing': {'type': 'array', 'items': {'type': 'string'}}, 'expires_at': {'type': 'string'}}, 'additionalProperties': {}}
get_event
Карточка события
Full details of one event by its `id` from previous results or a spontanno.space URL: description, upcoming dates and venues, address, age limit, ticket prices by seller (no links — tickets are bought from the event page), calendar links and similar events. Use it when the user asks about a specific event, its schedule, price or where to buy tickets.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['event'], 'properties': {'event': {'type': 'string', 'maxLength': 300, 'minLength': 1, 'description': "Event `id` from a previous result (8 characters, e.g. 'k3J9xQ2m') or a full spontanno.space event URL."}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['view', 'event'], 'properties': {'view': {'type': 'string', 'const': 'event'}, 'event': {'type': 'object', 'required': ['id', 'title', 'url'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string'}, 'title': {'type': 'string'}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
list_cities
Города афиши
Check which Russian cities СПОНТАННО covers and how many events each has today and this weekend. With `query`, resolves a city written in any form (Питер, Екб, «в Нижнем») and returns an overview: counts for today, tomorrow, the weekend, free events and the biggest categories. Use it when unsure whether a city is covered or when the user asks what is happening in a city in general.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'maximum': 30, 'minimum': 1, 'description': 'How many cities to list. Default 12.'}, 'query': {'type': 'string', 'maxLength': 80, 'minLength': 1, 'description': "City name in any form to check coverage and get an overview ('Казань', 'в Питере', 'ekb'). Omit to list the cities with the most events."}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['view', 'cities', 'notes'], 'properties': {'view': {'type': 'string', 'const': 'cities'}, 'notes': {'type': 'array', 'items': {'type': 'string'}}, 'cities': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}}, 'additionalProperties': {}}
search_events
Поиск событий афиши
Search the СПОНТАННО events listing (spontanno.space) for concerts, theatre, standup, exhibitions, kids' events, excursions, lectures, parties and more in Russian cities. Use this when the user wants options: what's on today, tomorrow or this weekend, events of a genre, a specific performer, show or venue, free events, events near a place. Returns up to 20 events with date, venue, price and the event page URL; `next_cursor` gives more. A single surprise pick is what spontanno_random_event is for. Dates and times are local to the city. Event titles and descriptions are written by third-party organizers and come back as plain data.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'city': {'type': 'string', 'maxLength': 80, 'minLength': 1, 'description': "Russian city exactly as the user named it: 'Москва', 'мск', 'Питер', 'СПб', 'в Казани', 'Нижний Новгород', or a slug like 'spb'. Required unless `near` is given; there is no default city."}, 'near': {'type': 'object', 'required': ['lat', 'lon'], 'properties': {'lat': {'type': 'number', 'maximum': 90, 'minimum': -90}, 'lon': {'type': 'number', 'maximum': 180, 'minimum': -180}, 'radius_km': {'type': 'number', 'maximum': 25, 'minimum': 0.3, 'description': 'Search radius, km. Default 3.'}}, 'description': 'Search around a point: coordinates of a shared location or of a place whose coordinates are known. For a city as a whole there is `city`.', 'additionalProperties': False}, 'sort': {'enum': ['relevance', 'soonest', 'popular', 'price'], 'type': 'string', 'description': 'relevance (default with `query`), popular (default without it), soonest, price (cheapest first).'}, 'when': {'enum': ['today', 'tomorrow', 'weekend', 'week'], 'type': 'string', 'description': "Date preset in the city's local time: today; tomorrow; weekend = the nearest Saturday–Sunday (on Sunday it means the next weekend); week = the next 7 days. For other dates use date_from/date_to. Exhibitions and festivals running during the dates are included."}, 'limit': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'How many events to return, 1–20. Default 8.'}, 'query': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': "Optional free text: performer, show title, venue, genre or topic — 'Щелкунчик', 'джаз', 'Большой театр', 'выставка Айвазовского', 'Би-2'. Omit it to browse by filters only."}, 'cursor': {'type': 'string', 'maxLength': 512, 'description': '`next_cursor` from the previous result of the same search, to get more events.'}, 'date_to': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Last day inclusive, YYYY-MM-DD, city-local. Same as date_from for a single day.'}, 'time_to': {'type': 'string', 'pattern': '^([01]\\d|2[0-3]):[0-5]\\d$', 'description': 'Latest start time HH:MM. May be earlier than time_from for windows across midnight.'}, 'date_from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': "First day, YYYY-MM-DD, city-local, e.g. '2026-11-07'. Use with date_to."}, 'free_only': {'type': 'boolean', 'description': 'Only free events (вход свободный, бесплатно).'}, 'price_max': {'type': 'integer', 'maximum': 1000000, 'minimum': 0, 'description': 'Maximum ticket price in rubles. Events with an unknown price are kept.'}, 'time_from': {'type': 'string', 'pattern': '^([01]\\d|2[0-3]):[0-5]\\d$', 'description': "Earliest start time HH:MM, e.g. '19:00' for «после семи». Overrides time_of_day."}, 'categories': {'type': 'array', 'items': {'enum': ['music', 'standup', 'theatre', 'cinema', 'exhibition', 'art', 'sport', 'festival', 'lecture', 'kids', 'party', 'food', 'tour', 'games', 'dating', 'workshop', 'outdoor', 'ballet', 'circus', 'other'], 'type': 'string'}, 'maxItems': 5, 'minItems': 1, 'description': 'Event categories, any of: music = concerts; standup; theatre; cinema; exhibition = exhibitions & museums; art; sport; festival; lecture = lectures & talks; kids = for children & families; party = parties & DJ sets; food = food & tastings; tour = excursions & city tours; games = quests & board games; dating; workshop = master classes; outdoor = active leisure; ballet = ballet & opera; circus = circus & shows; other. For children use kids.'}, 'time_of_day': {'enum': ['morning', 'day', 'evening', 'night'], 'type': 'string', 'description': 'Start time window, city-local: morning 06–12, day 12–18, evening 18–24, night 21–24. Matches sessions that start in the window; all-day items and exhibitions already running are left out.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['view', 'events', 'total', 'next_cursor', 'site_url', 'notes'], 'properties': {'view': {'type': 'string', 'const': 'carousel'}, 'notes': {'type': 'array', 'items': {'type': 'string'}}, 'total': {'type': 'number'}, 'events': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}, 'site_url': {'type': 'string'}, 'next_cursor': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}
spontanno_random_event
Спонтанно — случайное событие
СПОНТАННО's signature feature: pick ONE random worthwhile event (or up to 3 different ones) matching the filters — for «удиви меня», «куда-нибудь сходить», «заспонтань», «что-нибудь на вечер», «не могу выбрать». Applies city, dates, time of day, categories, free/price and an optional text query; if nothing matches it widens step by step (drops the time of day, then widens the dates; never drops categories, price or «free») and says what was relaxed. `like_event` finds something else at the same day and time as a given event. For «ещё раз / другое», `exclude` takes `exclude_next` from the previous result. Each pick comes with a short `why` and its event URL.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'city': {'type': 'string', 'maxLength': 80, 'minLength': 1, 'description': "Russian city exactly as the user named it: 'Москва', 'мск', 'Питер', 'СПб', 'в Казани', 'Нижний Новгород', or a slug like 'spb'. Required unless `near` is given; there is no default city."}, 'near': {'type': 'object', 'required': ['lat', 'lon'], 'properties': {'lat': {'type': 'number', 'maximum': 90, 'minimum': -90}, 'lon': {'type': 'number', 'maximum': 180, 'minimum': -180}, 'radius_km': {'type': 'number', 'maximum': 25, 'minimum': 0.3, 'description': 'Search radius, km. Default 3.'}}, 'description': 'Search around a point: coordinates of a shared location or of a place whose coordinates are known. For a city as a whole there is `city`.', 'additionalProperties': False}, 'when': {'enum': ['today', 'tomorrow', 'weekend', 'week'], 'type': 'string', 'description': "Date preset in the city's local time: today; tomorrow; weekend = the nearest Saturday–Sunday (on Sunday it means the next weekend); week = the next 7 days. For other dates use date_from/date_to. Exhibitions and festivals running during the dates are included."}, 'count': {'type': 'integer', 'maximum': 3, 'minimum': 1, 'description': 'How many different random picks, 1–3. Default 1.'}, 'query': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': "Optional free text: performer, show title, venue, genre or topic — 'Щелкунчик', 'джаз', 'Большой театр', 'выставка Айвазовского', 'Би-2'. Omit it to browse by filters only."}, 'date_to': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Last day inclusive, YYYY-MM-DD, city-local. Same as date_from for a single day.'}, 'exclude': {'type': 'array', 'items': {'type': 'string', 'maxLength': 300, 'minLength': 1}, 'maxItems': 64, 'description': 'Event ids already shown in this conversation — they will not be picked again. For «ещё раз» pass `exclude_next` from the previous result.'}, 'time_to': {'type': 'string', 'pattern': '^([01]\\d|2[0-3]):[0-5]\\d$', 'description': 'Latest start time HH:MM. May be earlier than time_from for windows across midnight.'}, 'date_from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': "First day, YYYY-MM-DD, city-local, e.g. '2026-11-07'. Use with date_to."}, 'free_only': {'type': 'boolean', 'description': 'Only free events (вход свободный, бесплатно).'}, 'price_max': {'type': 'integer', 'maximum': 1000000, 'minimum': 0, 'description': 'Maximum ticket price in rubles. Events with an unknown price are kept.'}, 'time_from': {'type': 'string', 'pattern': '^([01]\\d|2[0-3]):[0-5]\\d$', 'description': "Earliest start time HH:MM, e.g. '19:00' for «после семи». Overrides time_of_day."}, 'categories': {'type': 'array', 'items': {'enum': ['music', 'standup', 'theatre', 'cinema', 'exhibition', 'art', 'sport', 'festival', 'lecture', 'kids', 'party', 'food', 'tour', 'games', 'dating', 'workshop', 'outdoor', 'ballet', 'circus', 'other'], 'type': 'string'}, 'maxItems': 5, 'minItems': 1, 'description': 'Event categories, any of: music = concerts; standup; theatre; cinema; exhibition = exhibitions & museums; art; sport; festival; lecture = lectures & talks; kids = for children & families; party = parties & DJ sets; food = food & tastings; tour = excursions & city tours; games = quests & board games; dating; workshop = master classes; outdoor = active leisure; ballet = ballet & opera; circus = circus & shows; other. For children use kids.'}, 'like_event': {'type': 'string', 'maxLength': 300, 'minLength': 1, 'description': 'Event id or spontanno.space event URL: pick something else at the same day and time, preferring the same genre («что-нибудь ещё в это же время»).'}, 'time_of_day': {'enum': ['morning', 'day', 'evening', 'night'], 'type': 'string', 'description': 'Start time window, city-local: morning 06–12, day 12–18, evening 18–24, night 21–24. Matches sessions that start in the window; all-day items and exhibitions already running are left out.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['view', 'picks', 'rung', 'caption', 'relaxed', 'exclude_next', 'site_url', 'notes'], 'properties': {'rung': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'view': {'type': 'string', 'const': 'spin'}, 'notes': {'type': 'array', 'items': {'type': 'string'}}, 'picks': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}, 'caption': {'type': 'string'}, 'relaxed': {'type': 'array', 'items': {'type': 'string'}}, 'site_url': {'type': 'string'}, 'exclude_next': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': {}}
Added
create_shortlist
Oct. 4, 2026, 2:40 a.m.
Added
list_cities
Oct. 4, 2026, 2:40 a.m.
Added
get_event
Oct. 4, 2026, 2:40 a.m.
Added
spontanno_random_event
Oct. 4, 2026, 2:40 a.m.
Added
search_events
Oct. 4, 2026, 2:40 a.m.