# Padzei

> Афиша событий Беларуси — концерты, театр, лекции, фестивали, выставки. Для ИИ-агентов открыт MCP-сервер (`mcp.padzei.com`): список событий, карточка события, семантический поиск и справочник тем через Model Context Protocol (Streamable HTTP).

MCP-сервер Padzei — только чтение. Аутентификация: общий ключ в заголовке `X-API-Key` (или `Authorization: Bearer <ключ>`). Языки контента: `ru` (по умолчанию), `en`, `be`, `es`, `de`, `zh`; `limit` ограничен 50.

Инструменты MCP (вызываются POST-запросом на https://mcp.padzei.com/mcp):

- `list_events(date_from?, date_to?, topics?, language?, limit?)` — события на период, даты `YYYY-MM-DD` (по умолчанию сегодня…+60 дней), фильтр `topics` — список id тем, `limit` 1–50 (по умолчанию 20)
- `get_event(event_id, language?)` — карточка события по id: markdown-описание, площадка, цена, регистрация
- `search_events(query, language?, limit?)` — семантический поиск по свободному тексту, `limit` 1–50 (по умолчанию 10)
- `list_topics()` — справочник тем: id 0–15, slug и названия (en/ru) для фильтра `topics`

## MCP-сервер (mcp.padzei.com)

- [Endpoint Streamable HTTP](https://mcp.padzei.com/mcp): точка входа протокола MCP, JSON-RPC POST, требуется заголовок `X-API-Key`
- [list_events](https://mcp.padzei.com/mcp): список событий на период с фильтрами по дате, теме, языку и лимитом (≤ 50)
- [get_event](https://mcp.padzei.com/mcp): детальная карточка события по ID (описание, площадка, цена, регистрация)
- [search_events](https://mcp.padzei.com/mcp): семантический поиск событий по свободному тексту
- [list_topics](https://mcp.padzei.com/mcp): справочник тем событий (id 0–15)
- [Health check](https://mcp.padzei.com/health): GET без аутентификации, статус сервиса

## REST API (api.padzei.com)

- [Корень API](https://api.padzei.com): JSON с версией и перечнем эндпоинтов (`/events`, `/auth`)
- [Swagger UI](https://api.padzei.com/api/docs): интерактивная документация OpenAPI
- [ReDoc](https://api.padzei.com/api/redoc): альтернативный рендер документации
- [Health API](https://api.padzei.com/health): статус API

## Веб-сайт (padzei.com)

- [Главная](https://padzei.com/): персональные рекомендации событий
- [Афиша](https://padzei.com/events): календарь событий с фильтрами по дате, категории и цене
- [Поиск по афише](https://padzei.com/events?q=концерт): поиск через параметр `q` на странице событий
- [Коллекции](https://padzei.com/collections): тематические подборки событий
- [Люди](https://padzei.com/people): организаторы и участники
- [Места](https://padzei.com/venues): площадки проведения событий
- [О проекте](https://padzei.com/about): информация о сервисе Padzei