Event search at Biletyna.pl - Poland's top-rated ticket distributor, widest offer in all cities.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Returns a single performance identified by event_id (as returned by search_events or list_performances), with its title, venue, date, price, free places and buy_url. Free places and price are a snapshot taken at "_meta.indexed_at".
Performance identifier - an event_id value from search_events or list_performances results.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Returns a single performance identified by event_id (as returned by search_events or list_performances), with its title, venue, date, price, free places and buy_url. Free places and price are a snapshot taken at "_meta.indexed_at".
| Argument | Type | Description |
|---|---|---|
| event_id* | integer | Performance identifier - an event_id value from search_events or list_performances results. |
{
"type": "object",
"required": [
"event_id"
],
"properties": {
"event_id": {
"type": "integer",
"description": "Performance identifier - an event_id value from search_events or list_performances results."
}
}
}Returns a single title currently on sale on Biletyna.pl, identified by artist_id (as returned by search_events). "title" holds the description, average user rating, top user reviews and the nearest performance. "cities" lists every city where the title is played - one entry per city with its buy_url, number of performances, nearest date and lowest price. Use list_performances(artist_id, city) for the individual dates.
| Argument | Type | Description |
|---|---|---|
| artist_id* | integer | Title identifier - the artist_id field from search_events results. |
{
"type": "object",
"required": [
"artist_id"
],
"properties": {
"artist_id": {
"type": "integer",
"description": "Title identifier - the artist_id field from search_events results."
}
}
}Lists every performance of a single title, ordered by date, optionally narrowed to one city and a date range. Use this when the user asks for all dates of a title, or for its dates in a given city or on a given weekend - search_events returns only the nearest performance per title. Each performance carries its own venue, date, price, free places and buy_url. Only future performances are returned unless date_from says otherwise.
| Argument | Type | Description |
|---|---|---|
| city | string | City name filter (exact match, case-insensitive, diacritics required), e.g. "Warszawa". |
| page | integer | Page number, starting at 1. |
| date_to | string | Latest performance date (YYYY-MM-DD), inclusive. |
| artist_id* | integer | Title identifier - the artist_id field from search_events results. |
| date_from | string | Earliest performance date (YYYY-MM-DD). Defaults to today. |
| items_per_page | integer | Performances per page. Defaults to 20. |
{
"type": "object",
"required": [
"artist_id"
],
"properties": {
"city": {
"type": "string",
"default": null,
"description": "City name filter (exact match, case-insensitive, diacritics required), e.g. \"Warszawa\"."
},
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "Page number, starting at 1."
},
"date_to": {
"type": "string",
"format": "date",
"default": null,
"description": "Latest performance date (YYYY-MM-DD), inclusive."
},
"artist_id": {
"type": "integer",
"description": "Title identifier - the artist_id field from search_events results."
},
"date_from": {
"type": "string",
"format": "date",
"default": null,
"description": "Earliest performance date (YYYY-MM-DD). Defaults to today."
},
"items_per_page": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Performances per page. Defaults to 20."
}
}
}Searches performances (concerts, theatre plays, festivals, stand-up shows and more) currently on sale on Biletyna.pl, a Polish ticketing platform. Every filter applies to a single performance, so city, date range and price always describe the same event. Results are deduplicated by title: each hit is the nearest matching performance of a distinct title, carrying its buy_url, venue, price and free places, plus aggregates for its city (city_events_total, city_next_event_date) and for the whole title (title_events_total, title_cities_total). Use "facets" for the distribution of matches across cities and categories. Only future performances are returned unless date_from says otherwise. Use list_performances(artist_id) for all dates of a title, get_title_details(artist_id) for its description and all cities. Full-text search is typo-tolerant. All content is in Polish. Prices are provided both in grosze (*_min_price) and PLN (*_min_price_pln); dates both as unix timestamps and human-readable *_text fields. "_meta.indexed_at" tells when the data was last refreshed - free places and prices are a snapshot from that moment.
| Argument | Type | Description |
|---|---|---|
| city | string | City name filter (exact match, case-insensitive, diacritics required), e.g. "Warszawa". |
| page | integer | Page number, starting at 1. Compare "page" with "total_pages" or read "has_more" to know whether more results exist. |
| sort | string | Result ordering. "date_asc" sorts by the performance date, "price_asc" by its cheapest ticket, "rating_desc" by the average rating of the title. Defaults to "relevance". |
| query | string | Search phrase: event name, performer or kind of event. Typo-tolerant. Use Polish terms when possible. |
| date_to |
| string |
| Latest performance date (YYYY-MM-DD). |
| category | string | Event category name filter (exact match), e.g. "koncert", "spektakl", "kabaret". |
| date_from | string | Earliest performance date (YYYY-MM-DD). Defaults to today - past performances are never returned. |
| max_price | number | Maximum price of the cheapest ticket for the performance, in PLN (not in grosze). |
| min_rating | number | Minimum average user rating of the title (1-5 stars). |
| items_per_page | integer | Titles per page. Defaults to 10. |
{
"type": "object",
"properties": {
"city": {
"type": "string",
"default": null,
"description": "City name filter (exact match, case-insensitive, diacritics required), e.g. \"Warszawa\"."
},
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "Page number, starting at 1. Compare \"page\" with \"total_pages\" or read \"has_more\" to know whether more results exist."
},
"sort": {
"enum": [
"relevance",
"date_asc",
"price_asc",
"rating_desc"
],
"type": "string",
"default": "relevance",
"description": "Result ordering. \"date_asc\" sorts by the performance date, \"price_asc\" by its cheapest ticket, \"rating_desc\" by the average rating of the title. Defaults to \"relevance\"."
},
"query": {
"type": "string",
"default": null,
"description": "Search phrase: event name, performer or kind of event. Typo-tolerant. Use Polish terms when possible."
},
"date_to": {
"type": "string",
"format": "date",
"default": null,
"description": "Latest performance date (YYYY-MM-DD)."
},
"category": {
"type": "string",
"default": null,
"description": "Event category name filter (exact match), e.g. \"koncert\", \"spektakl\", \"kabaret\"."
},
"date_from": {
"type": "string",
"format": "date",
"default": null,
"description": "Earliest performance date (YYYY-MM-DD). Defaults to today - past performances are never returned."
},
"max_price": {
"type": "number",
"default": null,
"minimum": 0,
"description": "Maximum price of the cheapest ticket for the performance, in PLN (not in grosze)."
},
"min_rating": {
"type": "number",
"default": null,
"maximum": 5,
"minimum": 1,
"description": "Minimum average user rating of the title (1-5 stars)."
},
"items_per_page": {
"type": "integer",
"default": 10,
"maximum": 25,
"minimum": 1,
"description": "Titles per page. Defaults to 10."
}
}
}