search_msza_ai
Search public msza.ai sources
Searches public, predominantly Polish-language msza.ai sermons, sermon studies, Bible passages, prayers, songs, people, and places by topic, keyword, and relevance. Results retain stored source language and contain candidate matches, stable source IDs, citation labels, short excerpts, dates, and links. Date and church filters apply to sermon records. Priest names are unavailable.
Parameterslimitqueryrequireddate_toweekdaycamera_iddate_fromdays_backcontent_types
get_sermon
Get a public sermon transcript
Returns public sermon text for an exact session ID in its stored language. text_type identifies an AI-edited transcript section, fallback summary, or fallback short thought; these forms are not guaranteed verbatim speech. truncated and total_chars describe text completeness. references contains at most 50 saved annotations; selected_section concerns the displayed section and session can concern other liturgy. Saved annotations can be machine-generated and incomplete.
Parameterssession_idrequired
get_daily_page
Get the public msza.ai daily briefing
Returns an already-prepared public /dzisiaj briefing for today in the Europe/Warsaw timezone or one YYYY-MM-DD date. The briefing contains a daily thought, readings, patrons, name days, external homilies, and public sermon links. sermon_aggregates_available identifies whether stored synthesis and digest provenance remains verifiable; false makes zero digest counters placeholders. AI-generated thoughts and synthesis are orientation material. Data comes from stored SQLite content without generation or refresh.
Parametersdate
list_recent_sermons
List the latest public sermons
Returns up to 10 latest public msza.ai sermons in reverse chronological order, optionally limited to one church. This bounded, non-paginated listing contains compact metadata and excerpts.
Parameterscamera_id
list_sermons_by_date
List public sermons from one day
Returns public sermons whose start time falls on one selected Europe/Warsaw calendar day, optionally limited to one church. The non-paginated listing contains at most 50 compact records; total and truncated describe the safety ceiling.
Parametersdaterequiredcamera_id
get_prayer
Get a public prayer
Returns one saved public prayer-book item: prayer, song, or fixed liturgical text. Bare prayer IDs and namespaced song:<id> and standard:<id> IDs are supported. kind, text_status, and truncated describe content availability; a song can contain only a first line or metadata. rights_note records provenance rather than permission. Text is stored content without generation or network retrieval.
Parametersprayer_idrequired
get_person
Get a public person profile
Returns one curated Catholic or biblical person profile by exact public person ID. Session-derived dynamic profiles remain unavailable until public provenance is verifiable. Results contain bounded profile fields, canonical source URLs, and at most 20 indexed Scripture references.
Parametersperson_idrequired
get_place
Get a public place profile
Returns one public Catholic or biblical place profile by exact public place ID. Results contain bounded profile fields, canonical source URLs, and at most 20 indexed Scripture references.
Parametersplace_idrequired
get_bible_passage
Get an exact UBG Bible passage
Returns up to 50 unchanged UBG verses from one chapter with copyright, license, and source attribution. The local text uses USFM book IDs such as GEN, PSA, MAT, and JHN. No translation or AI generation occurs.
Parametersbook_idrequiredchapterrequiredend_versestart_verserequired
list_churches
Find public churches
Returns enabled public churches in stable camera ID order, up to 50 per page. next_cursor represents the next page for the same optional literal name/address substring filter; null marks the end. truncated identifies additional matching records. The live catalogue can change during traversal.
Parameterslimitquerycursor
get_church
Get a public church profile
Returns a saved public church profile by camera_id with bounded description, address, stored Mass schedule, website, and update time. Profiles can be AI-enriched and schedules can be outdated. The result reads saved data without profile refresh or generation.
Parameterscamera_idrequired
get_transcript
Read a public full-session transcript page
Returns saved final transcript segments from an ended or interrupted public session rather than an AI-edited sermon section. Each page contains at most 20 segments and 12000 UTF-16 text units. next_cursor represents the next page for the same session; long segments continue with char_offset. Text is privacy-redacted, timestamps retain original metadata, and creation-time/ID ordering is stable. Pagination is live, so edits can invalidate a cursor. Saved references concern the returned page. Each page consumes the shared listing budget; oversized stored segments fail explicitly.
Parameterscursorsession_idrequired
get_announcements
Read public parish announcements
Returns saved parish announcements for an ended or interrupted public session, preferring the edited announcements section and otherwise its summary tab. The response excludes sermon and full-recording fallbacks. text_type identifies AI-edited or summarized text rather than guaranteed verbatim speech. Recording and summary-update dates are not announcement expiry dates. Text is limited to 8000 UTF-16 units; truncated and total_chars describe completeness. No AI generation or network retrieval occurs. Shared reference rate limits apply.
Parameterssession_idrequired
get_ai_study
Read an AI-generated study and its source sermons
Returns one saved public AI study by study_id with its complete public text and source-sermon metadata. An exceptional safety limit fails explicitly rather than returning partial text. source_sermons contains currently public finished sermons from at most 200 linked candidates. sources_truncated describes the candidate cap rather than text truncation. The response identifies AI-generated origin and includes provenance fields.
Parametersstudy_idrequired
find_sessions_by_bible_passage
Find recordings with an annotated Bible passage
Returns public saved recordings whose saved Bible annotations exactly overlap the requested single-chapter verse range. scope=sermon excludes reading-only annotations; scope=session includes other liturgy annotations. Results use live lexicographic session_id order rather than chronology. Matches are stored annotations rather than semantic search or verified evidence. The indexed scan covers at most 200 public chapter candidates per request. No content generation, Bible-text retrieval, or network access occurs. Each page consumes the shared listing quota.
Parameterslimitscopecursorbook_idrequiredchapterrequiredend_versestart_verserequired
list_agent_skills
List public Agent Skills
Returns up to 50 immutable public Agent Skill summaries from the msza.ai catalogue, optionally filtered by one exact tag. Results contain metadata and canonical links without full Markdown. The catalogue is read-only; publishing belongs to a separate authenticated Hermes endpoint.
Parameterstaglimitoffset
get_agent_skill
Get a public Agent Skill
Returns one immutable public Agent Skill by exact lowercase slug and optional x.y.z version. An omitted version returns the current published head; a supplied version returns that immutable snapshot. The read-only result contains complete skillMarkdown and metadata. Publishing belongs to a separate authenticated Hermes endpoint.
Parametersslugrequiredversion