Magisterium AI facultates sequentes per protocollum A2A exponit. Specifica facultatem adhibendam per metadata.skillId in nuntio. Si skillId omittitur, catholic_qa tamquam praesumpta adhibetur.

Omnes facultates per methodum JSON-RPC message/send invocantur.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "message/send",
  "params": {
    "message": {
      "role": "user",
      "messageId": "unique-id",
      "kind": "message",
      "parts": [{ "kind": "text", "text": "your query here" }],
      "metadata": { "skillId": "document_search" }
    }
  }
}

Responsa semper reveniunt sicut Task (kind: "task") cum status.state: "completed" et una vel pluribus artifacts. Unumquodque artefactum habet unicam artifactId, name facultati propriam, et unam vel plures parts (text, data, vel file).

catholic_qa

Pone quaestionem in lingua naturali et accipe responsum longum cum citationibus. Haec est facultas maxime capax (et maxime opum intensiva) — in eodem modello currit quod magisterium.com alit.

Ingressus: una pars textus cum quaestione.

Artefactum: name: "catholic_qa_response" continens:

• Partem text cum responso integro.
• Partem data cum citations (cum fontes adhibiti sunt).
• Partem data cum related_questions (cum modellum suggestiones reddit).

{
  "artifactId": "art_...",
  "name": "catholic_qa_response",
  "parts": [
    { "kind": "text", "text": "The Catholic Church teaches..." },
    { "kind": "data", "data": { "citations": [ /* ... */ ] } },
    { "kind": "data", "data": { "related_questions": [ /* ... */ ] } }
  ]
}

catholic_qa variante rate-limit strictiore utitur quam ceterae facultates. Vide API Referentiam → Limites rate.

document_search

Recupera referentias documenti quae quaesitioni semanticae contra scientiae basem Magisterii respondent.

Ingressus: una pars textus cum quaesitione.

Artefactum: name: "search_results" cum unica parte data:

{
  "artifactId": "art_...",
  "name": "search_results",
  "parts": [
    {
      "kind": "data",
      "data": {
        "results": [
          { "id": "12345", "url": "https://...", "title": "Lumen Gentium" }
        ]
      }
    }
  ]
}

Utere campo id ex resultato ad invocandum document_fetch pro textu integro.

document_fetch

Recupera textum integrum et metadata documenti per ID eius. Haec facultas partem data accipit loco partis textus:

{
  "parts": [{ "kind": "data", "data": { "id": "12345" } }]
}

Si vocator partem textus mittit, tractator eam tractat sicut ID documenti.

Artefactum: name: "document" cum duabus partibus:

• Parte text continente corpus documenti.
• Parte data cum { id, title, author, ref }.

Si documentum non invenitur, artefactum unam partem text continet legentem "Document not found.".

liturgical_readings

Obtine lectiones Missae catholicae pro data certa. Accipit quaesitionem datae in lingua naturali — exempli gratia "today", "next Sunday", vel "Easter Sunday 2026".

Ingressus: una pars textus cum quaesitione datae.

Artefactum: name: "mass_readings" cum unica parte text continente lectiones formatas. Si nullae lectiones praesto sunt pro data petita, pars legit "No mass readings found.".

saints_of_the_day

Inquire sanctos qui data data celebrantur ex Martyrologio Romano.

Ingressus: pars data cum data absoluta, aut pars textus tractata sicut quaesitio datae:

{
  "parts": [{ "kind": "data", "data": { "date": "2026-03-19" } }]
}

Artefactum: name: "martyrology" cum unica parte text continente ingressum martyrologii formatum. Datae deficientes reddunt "No martyrology data found.".

Quinque facultates infra positae sunt inquisitiones in indicibus. Unaquaeque accipit query in lingua naturali (sicut pars textus vel campus data.query) atque ID canonicum facultativum, et reddit profilum structuratum intra unam partem data. Si neque query neque ID canonicum praebetur, petitio reicitur cum INVALID_PARAMS (-32602).

Cum quaesitio solvi non potest, artefactum continet partem data formae { "error": "not_found", "query": "...", "hint"?: "..." } loco profili. Munus ipsum tamen feliciter perficitur — not_found est resultatum normale inquisitionis, non error protocolli.

saint_lookup

Inquire sanctum, beatum, venerabilem, vel servum Dei ex indice cd_saints (~12.500 personarum).

Ingressus: data.query (e.g. "Therese of Lisieux") vel data.saint_id (clavis primaria canonica, e.g. "jerome"). Pars textus nuda accipitur sicut query.

{
  "parts": [{ "kind": "data", "data": { "query": "Catherine of Siena" } }]
}

Artefactum: name: "saint_profile" cum unica parte data continente profilum canonicum — saint_id, primary_name, canonical_status, vocation, image_url, learn_more_url, vita et mors, dies festus, causa canonizationis, patrocinium, iconographia, biographia, et (si plures candidati inventi sunt) seriem alternates.

person_lookup

Inquire personam cleri catholici (episcopum, cardinalem, archiepiscopum, etc.) ex indicibus cd_persons (viventes, ~3.500) et cd_persons_historical (~2.200). Papae per separatam facultatem pope_lookup exhibentur.

Ingressus: data.query (e.g. "Cardinal Tagle") vel data.person_id (clavis primaria canonica). Pars textus nuda accipitur sicut query.

{
  "parts": [{ "kind": "data", "data": { "query": "Cardinal Tagle" } }]
}

Artefactum: name: "person_profile" cum unica parte data continente profilum canonicum — person_id, source_table, primary_name, current_position, image_url, coat_of_arms_url, datas ordinationis et consecrationis, elevationem cardinalem, lineagium episcopale, educationem, motto, et quoslibet alternates.

Si quaesitio solvitur tantum in papam, responsum est { "error": "not_found", "hint": "Top match looks like a pope; try get_pope." }.

pope_lookup

Inquire papam ex indice cd_popes (267 personarum).

Ingressus: data.query (e.g. "Pope Francis", "John Paul II") vel data.pope_id (clavis primaria canonica, e.g. "benedict-xvi"). Pars textus nuda accipitur sicut query.

{
  "parts": [{ "kind": "data", "data": { "query": "John Paul II" } }]
}

Artefactum: name: "pope_profile" cum unica parte data continente profilum papalem canonicum — pope_id, primary_name, papal_name, ordinal, pope_title, image_url, coat_of_arms_url, birth_name, origin, pontificate, statum beatificationis et canonizationis, et quoslibet alternates.

Si quaesitio solvitur tantum in membrum cleri non-papam, responsum est { "error": "not_found", "hint": "Top match looks like a non-pope clergy member; try get_person." }.

diocese_lookup

Inquire iurisdictionem ecclesiasticam (dioecesim, archidioecesim, eparchiam, etc.) ex indice dioecesium (~3.200 iurisdictionum per orbem).

Ingressus: data.query (e.g. "Archdiocese of Manila") vel data.source_code (clavis primaria canonica, e.g. "dmaml"). Pars textus nuda accipitur sicut query.

{
  "parts": [{ "kind": "data", "data": { "query": "Archdiocese of Manila" } }]
}

Artefactum: name: "diocese_profile" cum unica parte data continente metadata indicis (source_code, primary_name, jurisdiction_type, rite, country, region_primary, state, city, metropolitan, depends_on, province, cathedral, patron_saint, area, erected, elevated, official_website, image_url, current_bishop) atque:

• recent_statistics — usque ad 5 annos numerorum principalium (catholici, populatio totalis, percentum catholicum, sacerdotes totales, paroeciae, baptismi, seminaristae).
• latest_financials — metricae principales recentissimi anni fiscalis (reditus totalis, sumptus totales, assets netti, assets totales, superplus/deficit) cum praesto sint, cum moneta.
• alternates — cum plures candidati congruunt.

Pro analysi tendentiarum per multos annos, utere potius diocese_statistics_lookup.

diocese_statistics_lookup

Reddit seriem temporis annuam plenam statisticae pro dioecesi — omnes 19 metricas in diocese_statistics observatas.

Ingressus: data.query vel data.source_code (alterum requiritur), atque limites inclusivi facultativi:

{
  "parts": [{
    "kind": "data",
    "data": {
      "source_code": "dmaml",
      "start_year": 2010,
      "end_year": 2024
    }
  }]
}

Artefactum: name: "diocese_statistics_time_series" cum unica parte data continente source_code, diocese_name, year_range: { start, end }, et seriem rows. Unaquaeque linea fert 19 metricas pro uno anno: catholics, total_population, percent_catholic, diocesan_priests, religious_priests, total_priests, catholics_per_priest, permanent_deacons, male_religious, female_religious, parishes, area_km2, churches_or_stations, diocesan_priests_ordained, religious_priests_ordained, seminarians, educational_institutes, charitable_institutes, baptisms.