Supported Tools
Currently, Magisterium MCP provides the following tools:
| Tool | Description | Parameters |
|---|---|---|
search | Search the Magisterium corpus and return a ranked list of matching source passages, each with an id, title, and source URL. Pair with fetch to pull the full text of a result by its id; for a ready-made cited answer instead, use chat. | query (string, required): search terms or a natural-language description of what you're looking for |
fetch | Retrieve the full text and metadata (title, author, reference) of a single document passage by its id. The id comes from a prior search result. | id (string, required): a document/passage ID returned by search |
get_mass_readings | Get the Catholic lectionary Mass readings assigned to a given day or occasion, described in natural language. | query (string, required): natural-language day or occasion, e.g. "today", "readings for December 25", "the 3rd Sunday of Advent" |
get_martyrology | Get the Roman Martyrology entry — the saints and blesseds the Church commemorates on a specific calendar date. For a single saint's profile use get_saint. | date (string, required): absolute date as YYYY-MM-DD |
get_saint | Look up a saint, blessed, venerable, or servant of God by name or ID. Returns structured biographical data — canonical status, feast day, life and death, canonization, patronage, biography, image. | query (string, optional): natural-language name; saint_id (string, optional): canonical ID. At least one is required. |
get_person | Look up a Catholic clergy figure (bishop, cardinal, archbishop, etc.) by name or ID. Returns structured biographical data — current position, ordination and consecration, cardinal elevation, episcopal lineage, education, image. Covers living and historical clergy; popes are exposed via get_pope. | query (string, optional): natural-language name; person_id (string, optional): canonical ID. At least one is required. |
get_pope | Look up a pope by name or ID. Returns structured papal data — pontificate dates, papal name and ordinal, birth name and origin, beatification and canonization status. | query (string, optional): natural-language name; pope_id (string, optional): canonical ID. At least one is required. |
get_diocese | Look up an ecclesiastical jurisdiction (diocese, archdiocese, eparchy, etc.) by name or ID. Returns directory metadata (country, rite, cathedral, current bishop, coat of arms) plus the last 5 years of headline statistics and the latest year's key financial totals. | query (string, optional): natural-language name; source_code (string, optional): canonical ID. At least one is required. |
get_diocese_statistics | Return the full yearly statistics time-series for a diocese — all 19 metrics tracked (catholics, priests, parishes, baptisms, seminarians, etc.), one row per year. Use for trend or multi-year analysis. | query (string, optional): natural-language name; source_code (string, optional): canonical ID; start_year / end_year (number, optional): inclusive year range. |
chat | Ask Magisterium AI a question about Catholic faith, doctrine, morals, liturgy, canon law, Scripture, or Church history. Returns a composed answer grounded in and cited to magisterial sources. Use search + fetch instead when you want the raw source passages rather than a synthesized answer. | prompt (string, required): the question in natural language |