Torah Library
Jewish calendar, zmanim, Shabbat times, parsha, Daf Yomi, and Torah texts with commentaries.
我該用這個嗎
品質與安全性
發現項目（8）
- LOWTool 'resolve_name' description lacks action verb在 resolve_name 中
- LOWTool 'find_references_in_text' description lacks action verb在 find_references_in_text 中
- LOWTool 'get_manuscripts' description lacks action verb在 get_manuscripts 中
- LOWTool 'browse_library' description lacks action verb在 browse_library 中
- LOWTool 'get_term' description lacks action verb在 get_term 中
- LOWTool 'dictionary_autocomplete' description lacks action verb在 dictionary_autocomplete 中
- LOWTool 'get_learning_schedules' description lacks action verb在 get_learning_schedules 中
- LOWTool 'get_user_profile' description lacks action verb在 get_user_profile 中
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"torah-library": {
"url": "https://torah.kolsgo.xyz/mcp"
}
}
}遠端端點
https://torah.kolsgo.xyz/mcpstreamable-http它能做什麼
工具清單
工具（49）
🟢convert_date(gregorian_date, end_date, after_sunset, hebrew_year, hebrew_month, ...)
Convert between Gregorian and Hebrew (Jewish) calendar dates. - Gregorian → Hebrew: pass gregorian_date (YYYY-MM-DD). Add end_date to convert a whole range (max ~180 days). - Hebrew → Gregorian: pass hebrew_year, hebrew_month, hebrew_day. Set after_sunset=true when the Gregorian time is after sunset (the Hebrew date advances at nightfall). Returns the Hebrew date in English and Hebrew letters plus any holidays/events on that day.
輸入結構描述
{
"type": "object",
"properties": {
"gregorian_date": {
"description": "Gregorian date YYYY-MM-DD. Defaults to today (US Eastern) if nothing else is given.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"end_date": {
"description": "Optional end of a Gregorian range to convert every day in it.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"after_sunset": {
"description": "Treat the Gregorian date as after sunset (Hebrew date = next day).",
"type": "boolean"
},
"hebrew_year": {
"description": "Hebrew year, e.g. 5787.",
"type": "integer",
"minimum": 1,
"maximum": 9999
},
"hebrew_month": {
"description": "Hebrew month name.",
"type": "string",
"enum": [
"Nisan",
"Iyyar",
"Sivan",
"Tamuz",
"Av",
"Elul",
"Tishrei",
"Cheshvan",
"Kislev",
"Tevet",
"Sh'vat",
"Adar",
"Adar I",
"Adar II"
]
},
"hebrew_day": {
"description": "Day of the Hebrew month.",
"type": "integer",
"minimum": 1,
"maximum": 30
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_jewish_calendar(start, end, year, month, hebrew_year_mode, ...)
List Jewish calendar events for a date range: holidays (major, minor, modern Israeli), Rosh Chodesh, fast days, special Shabbatot, weekly parsha, Omer count, molad, Yizkor, Yom Kippur Katan, daily-learning cycles (Daf Yomi, Mishna Yomi, Nach Yomi, Tanakh Yomi, Yerushalmi, Rambam, Chofetz Chaim), and — when a location is given — candle-lighting, havdalah and fast start/end times. Pick either start+end, or year (+ optional month). Max range ~1 year. Defaults include holidays, Rosh Chodesh, fasts, special Shabbatot and parsha.
輸入結構描述
{
"type": "object",
"properties": {
"start": {
"description": "Range start YYYY-MM-DD.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"end": {
"description": "Range end YYYY-MM-DD.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"year": {
"description": "Gregorian year (or Hebrew year if hebrew_year_mode=true). Used when start/end not given.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"month": {
"description": "Gregorian month 1-12 (with year).",
"type": "integer",
"minimum": 1,
"maximum": 12
},
"hebrew_year_mode": {
"description": "Interpret year as a Hebrew year (e.g. 5787) and return the whole Hebrew year.",
"type": "boolean"
},
"major_holidays": {
"default": true,
"type": "boolean"
},
"minor_holidays": {
"default": true,
"type": "boolean"
},
"modern_holidays": {
"default": true,
"description": "Yom HaAtzmaut, Yom HaShoah, etc.",
"type": "boolean"
},
"rosh_chodesh": {
"default": true,
"type": "boolean"
},
"minor_fasts": {
"default": true,
"type": "boolean"
},
"special_shabbatot": {
"default": true,
"description": "Shabbat Shekalim, Zachor, HaGadol, etc.",
"type": "boolean"
},
"parsha": {
"default": true,
"description": "Weekly Torah portion on Shabbat.",
"type": "boolean"
},
"omer": {
"default": false,
"description": "Daily Sefirat HaOmer count.",
"type": "boolean"
},
"molad": {
"default": false,
"description": "Molad announcements.",
"type": "boolean"
},
"yom_kippur_katan": {
"default": false,
"type": "boolean"
},
"yizkor": {
"default": false,
"type": "boolean"
},
"hebrew_date_every_day": {
"default": false,
"description": "Add the Hebrew date for every day in range.",
"type": "boolean"
},
"learning": {
"description": "Daily learning cycles to include.",
"type": "array",
"items": {
"type": "string",
"enum": [
"daf_yomi",
"mishna_yomi",
"nach_yomi",
"tanakh_yomi",
"yerushalmi_yomi",
"rambam_1_chapter",
"rambam_3_chapters",
"chofetz_chaim"
]
}
},
"israel": {
"default": false,
"description": "Use the Israel holiday/parsha schedule instead of the Diaspora one.",
"type": "boolean"
},
"hebrew_names": {
"default": false,
"description": "Return event titles in Hebrew.",
"type": "boolean"
},
"include_times": {
"default": false,
"description": "Include candle lighting / havdalah / fast times (needs a location).",
"type": "boolean"
},
"candle_minutes": {
"description": "Minutes before sunset for candle lighting (default 18; Jerusalem 40).",
"type": "integer",
"minimum": 10,
"maximum": 90
},
"havdalah_minutes": {
"description": "Havdalah N minutes after sunset instead of at nightfall (e.g. 42, 50, 72).",
"type": "integer",
"minimum": 20,
"maximum": 90
},
"location": {
"description": "Where the user is. A US ZIP code (\"11691\"), a city name (\"Jerusalem\", \"London\", \"Lakewood, NJ\"), or a numeric place id returned by find_location. Omit to use the server default.",
"type": "string"
},
"latitude": {
"description": "Latitude in decimal degrees (use with longitude + timezone instead of location).",
"type": "number",
"minimum": -90,
"maximum": 90
},
"longitude": {
"description": "Longitude in decimal degrees.",
"type": "number",
"minimum": -180,
"maximum": 180
},
"timezone": {
"description": "IANA timezone, required with latitude/longitude, e.g. \"America/New_York\".",
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_shabbat_times(location, latitude, longitude, timezone, date, ...)
Candle-lighting and havdalah times for the coming (or a specified) Shabbat and any Yom Tov that week, plus the parsha and holiday Torah readings, for a location.
輸入結構描述
{
"type": "object",
"properties": {
"location": {
"description": "Where the user is. A US ZIP code (\"11691\"), a city name (\"Jerusalem\", \"London\", \"Lakewood, NJ\"), or a numeric place id returned by find_location. Omit to use the server default.",
"type": "string"
},
"latitude": {
"description": "Latitude in decimal degrees (use with longitude + timezone instead of location).",
"type": "number",
"minimum": -90,
"maximum": 90
},
"longitude": {
"description": "Longitude in decimal degrees.",
"type": "number",
"minimum": -180,
"maximum": 180
},
"timezone": {
"description": "IANA timezone, required with latitude/longitude, e.g. \"America/New_York\".",
"type": "string"
},
"date": {
"description": "Any date in the week you want (defaults to this week).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"candle_minutes": {
"description": "Minutes before sunset for candle lighting (default 18; 40 for Jerusalem).",
"type": "integer",
"minimum": 10,
"maximum": 90
},
"havdalah_minutes": {
"description": "Havdalah N minutes after sunset; default is nightfall (tzeit, 8.5°).",
"type": "integer",
"minimum": 20,
"maximum": 90
},
"include_readings": {
"default": true,
"description": "Include aliyah-by-aliyah Torah reading details.",
"type": "boolean"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_zmanim(location, latitude, longitude, timezone, date, ...)
Halachic times of day for a location and date (or date range, max ~7 days recommended): alot hashachar, misheyakir, sunrise (netz), latest Shema and Tefilla (GRA and Magen Avraham), chatzot, mincha gedola/ketana, plag hamincha, sunset (shkia), bein hashmashot, tzeit hakochavim (several opinions), and midnight.
輸入結構描述
{
"type": "object",
"properties": {
"location": {
"description": "Where the user is. A US ZIP code (\"11691\"), a city name (\"Jerusalem\", \"London\", \"Lakewood, NJ\"), or a numeric place id returned by find_location. Omit to use the server default.",
"type": "string"
},
"latitude": {
"description": "Latitude in decimal degrees (use with longitude + timezone instead of location).",
"type": "number",
"minimum": -90,
"maximum": 90
},
"longitude": {
"description": "Longitude in decimal degrees.",
"type": "number",
"minimum": -180,
"maximum": 180
},
"timezone": {
"description": "IANA timezone, required with latitude/longitude, e.g. \"America/New_York\".",
"type": "string"
},
"date": {
"description": "Date YYYY-MM-DD (default today).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"end_date": {
"description": "Optional end date for a range.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"use_elevation": {
"default": false,
"description": "Adjust sunrise/sunset for elevation.",
"type": "boolean"
},
"include_seconds": {
"default": false,
"description": "Return times with seconds precision.",
"type": "boolean"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_torah_reading(date, end_date, israel, triennial, include_weekday)
Torah and Haftarah readings for a date or date range: parsha or holiday name, each aliyah with verse ranges and counts, maftir, haftarah, and special readings. Supports Israel vs Diaspora and the triennial cycle.
輸入結構描述
{
"type": "object",
"properties": {
"date": {
"description": "Date YYYY-MM-DD (defaults to the coming Shabbat).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"end_date": {
"description": "End date for a range (max ~1 year).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"israel": {
"default": false,
"type": "boolean"
},
"triennial": {
"default": false,
"description": "Return triennial-cycle aliyot.",
"type": "boolean"
},
"include_weekday": {
"default": true,
"description": "Include Monday/Thursday and Rosh Chodesh/holiday weekday readings.",
"type": "boolean"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_yahrzeit_dates(entries, years)
Compute upcoming Gregorian dates for yahrzeits, Hebrew birthdays or Hebrew anniversaries from the original Gregorian date. Handles after-sunset, Adar in leap years, and Cheshvan/Kislev edge cases. Up to 10 entries at once.
輸入結構描述
{
"type": "object",
"properties": {
"entries": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Name of the person or event."
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Original Gregorian date YYYY-MM-DD (date of passing, birth or wedding)."
},
"after_sunset": {
"default": false,
"description": "The event occurred after sunset.",
"type": "boolean"
},
"type": {
"default": "yahrzeit",
"type": "string",
"enum": [
"yahrzeit",
"birthday",
"anniversary"
]
}
},
"required": [
"name",
"date"
]
}
},
"years": {
"default": 3,
"description": "How many years ahead to list.",
"type": "integer",
"minimum": 1,
"maximum": 20
}
},
"required": [
"entries"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢find_location(query)
Search for a city/place by name and get place ids, country and region. Use the returned id as the "location" argument of other tools when a city name is ambiguous.
輸入結構描述
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 2,
"description": "City or place name, e.g. \"Jerusalem\", \"Monsey\", \"Paris\"."
}
},
"required": [
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_text(ref, language, translation_language, version_title, vowels, ...)
Fetch any text from the Jewish library by reference, in Hebrew/Aramaic and/or translation, aligned segment by segment. Covers Tanakh, Mishnah, Talmud Bavli & Yerushalmi, Midrash, Rambam, Shulchan Arukh, commentaries (e.g. "Rashi on Genesis 1:1"), Siddur, Zohar, Chasidut, Musar, responsa and more. Reference examples: "Genesis 1:1-5", "Bereishit 1", "Berakhot 2a", "Berakhot 2a:3-7", "Mishnah Avot 1", "Mishneh Torah, Sabbath 1:1", "Shulchan Arukh, Orach Chayim 1", "Psalms 23", "Ramban on Exodus 20:2". Returns segments as {n, he, en}; includes next/previous section refs for paging. If a reference fails, try resolve_name.
輸入結構描述
{
"type": "object",
"properties": {
"ref": {
"type": "string",
"minLength": 2,
"description": "Text reference, e.g. \"Genesis 1:1-10\" or \"Berakhot 2a\"."
},
"language": {
"default": "both",
"description": "\"both\" = original + translation; \"all\" = every available version.",
"type": "string",
"enum": [
"both",
"hebrew",
"english",
"all"
]
},
"translation_language": {
"description": "Translation language family instead of English, e.g. \"french\", \"spanish\", \"german\", \"russian\", \"italian\".",
"type": "string"
},
"version_title": {
"description": "Exact version title to use (see get_text_versions).",
"type": "string"
},
"vowels": {
"default": "full",
"description": "Hebrew vowels/cantillation: \"full\" keeps nikud, \"none\" strips it.",
"type": "string",
"enum": [
"full",
"none"
]
},
"footnotes": {
"default": false,
"description": "Keep translator footnotes inline.",
"type": "boolean"
},
"max_segments": {
"default": 60,
"description": "Max segments to return.",
"type": "integer",
"minimum": 1,
"maximum": 400
}
},
"required": [
"ref"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_texts_bulk(refs, vowels)
Fetch many short references in one call (e.g. a list of verses or commentary lines). Returns Hebrew and English for each. Up to 30 references.
輸入結構描述
{
"type": "object",
"properties": {
"refs": {
"minItems": 1,
"maxItems": 30,
"type": "array",
"items": {
"type": "string"
},
"description": "List of references, e.g. [\"Genesis 1:1\", \"Exodus 20:2\", \"Rashi on Genesis 1:1:1\"]."
},
"vowels": {
"default": "full",
"description": "Hebrew vowels/cantillation: \"full\" keeps nikud, \"none\" strips it.",
"type": "string",
"enum": [
"full",
"none"
]
}
},
"required": [
"refs"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢resolve_name(name, limit, type)
Autocomplete and identify a book title, reference, author, topic or person from partial, misspelled, transliterated or Hebrew input ("bava metzia", "bereishis", "ברכות ב", "Rambam"). Tells you whether the input is a valid reference and gives canonical names.
輸入結構描述
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1
},
"limit": {
"default": 10,
"type": "integer",
"minimum": 1,
"maximum": 30
},
"type": {
"description": "Restrict to one kind of result.",
"type": "string",
"enum": [
"ref",
"Topic",
"AuthorTopic",
"PersonTopic",
"TocCategory",
"Collection",
"User"
]
}
},
"required": [
"name"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢parse_reference(ref)
Validate and normalize a text reference: canonical English and Hebrew forms, the book it belongs to, its structure, and previous/next sections.
輸入結構描述
{
"type": "object",
"properties": {
"ref": {
"type": "string",
"minLength": 2
}
},
"required": [
"ref"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢find_references_in_text(text, title, language)
Scan free text (a dvar Torah, article, shiur notes) and detect every citation of a Jewish source in it (e.g. "Genesis 1:1", "Berakhot 2a", "Rambam Hilchot Shabbat 1:1"). Returns the matched spans and their canonical references.
輸入結構描述
{
"type": "object",
"properties": {
"text": {
"type": "string",
"minLength": 3,
"maxLength": 20000,
"description": "Body text to scan."
},
"title": {
"description": "Optional title of the piece (also scanned).",
"type": "string"
},
"language": {
"type": "string",
"enum": [
"en",
"he"
]
}
},
"required": [
"text"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_task_status(task_id)
Check the status/result of a background task (e.g. a long reference-detection job) by task_id.
輸入結構描述
{
"type": "object",
"properties": {
"task_id": {
"type": "string",
"minLength": 4
}
},
"required": [
"task_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢search_library(query, search_in, filters, exact, sort, ...)
Full-text search across the entire Jewish library (texts), or across user-made source sheets. Hebrew or English queries. - exact=true matches the exact word forms; default matching is lemmatized (finds grammatical variants). - filters narrow by category/book path, e.g. ["Tanakh"], ["Talmud/Bavli"], ["Mishnah/Seder Moed"], ["Halakhah/Shulchan Arukh"], ["Tanakh/Torah/Genesis"]. - sort "relevance" or "chronological" (by composition date). Returns matching references with highlighted snippets, total hit count and a breakdown of hits by category (use it to refine filters). Paginate with offset.
輸入結構描述
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1
},
"search_in": {
"default": "texts",
"type": "string",
"enum": [
"texts",
"sheets"
]
},
"filters": {
"description": "Category/book paths to restrict to.",
"type": "array",
"items": {
"type": "string"
}
},
"exact": {
"default": false,
"type": "boolean"
},
"sort": {
"default": "relevance",
"type": "string",
"enum": [
"relevance",
"chronological"
]
},
"size": {
"default": 15,
"type": "integer",
"minimum": 1,
"maximum": 50
},
"offset": {
"default": 0,
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"slop": {
"description": "Allowed word distance for multi-word phrases (default 10 for texts).",
"type": "integer",
"minimum": 0,
"maximum": 20
}
},
"required": [
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_commentaries(ref, commentator, category, include_text, limit, ...)
Get commentaries and other sources connected to a passage. - With commentator (e.g. "Rashi", "Ramban", "Ibn Ezra", "Sforno", "Tosafot", "Or HaChaim", "Onkelos", "Kli Yakar"): returns that commentator's full text on the passage. - Without commentator: lists all connected sources in a category ("Commentary" by default; also Targum, Midrash, Talmud, Halakhah, Chasidut, Kabbalah, Musar, Jewish Thought, Liturgy, Responsa, Quoting Commentary, …) grouped by work, optionally with text. Works for Tanakh, Talmud, Mishnah, Rambam, Shulchan Arukh, etc.
輸入結構描述
{
"type": "object",
"properties": {
"ref": {
"type": "string",
"minLength": 2,
"description": "Passage, e.g. \"Genesis 1:1\" or \"Berakhot 2a\"."
},
"commentator": {
"description": "Commentator/work name to fetch in full.",
"type": "string"
},
"category": {
"default": "Commentary",
"type": "string",
"enum": [
"Commentary",
"Quoting Commentary",
"Targum",
"Midrash",
"Talmud",
"Mishnah",
"Tosefta",
"Halakhah",
"Responsa",
"Chasidut",
"Kabbalah",
"Musar",
"Jewish Thought",
"Liturgy",
"Tanakh",
"Reference",
"Second Temple"
]
},
"include_text": {
"default": false,
"description": "Include the text of connected sources (first `limit`).",
"type": "boolean"
},
"limit": {
"default": 10,
"type": "integer",
"minimum": 1,
"maximum": 30
},
"language": {
"default": "both",
"type": "string",
"enum": [
"both",
"hebrew",
"english"
]
},
"vowels": {
"default": "full",
"description": "Hebrew vowels/cantillation: \"full\" keeps nikud, \"none\" strips it.",
"type": "string",
"enum": [
"full",
"none"
]
}
},
"required": [
"ref"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_related_content(ref, include)
Overview of everything connected to a passage: counts of linked sources by category and book, related topics, source sheets that use it, manuscript images, and related web articles. Use it to explore before drilling in with get_commentaries.
輸入結構描述
{
"type": "object",
"properties": {
"ref": {
"type": "string",
"minLength": 2
},
"include": {
"default": [
"link_summary",
"topics",
"sheets",
"manuscripts",
"web_pages"
],
"type": "array",
"items": {
"type": "string",
"enum": [
"link_summary",
"topics",
"sheets",
"manuscripts",
"web_pages"
]
}
}
},
"required": [
"ref"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_text_versions(book, language)
List every available edition and translation of a book (language, version title, license, source). Use a version_title with get_text to read a specific translation.
輸入結構描述
{
"type": "object",
"properties": {
"book": {
"type": "string",
"description": "Book title, e.g. \"Genesis\", \"Berakhot\", \"Mishneh Torah, Sabbath\"."
},
"language": {
"description": "Filter by language code, e.g. \"en\", \"he\", \"fr\".",
"type": "string"
}
},
"required": [
"book"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_translations(language)
Without a language: list every language code that has translations in the library. With a language code (e.g. "fr", "es", "de", "ru", "yi", "lad"): list every book translated into that language with its version titles.
輸入結構描述
{
"type": "object",
"properties": {
"language": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_manuscripts(ref)
Images of manuscripts and early printed editions (e.g. Vilna Shas, Venice 1523, Munich manuscript) for a passage, with image and thumbnail URLs.
輸入結構描述
{
"type": "object",
"properties": {
"ref": {
"type": "string",
"minLength": 2
}
},
"required": [
"ref"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_random_text(titles, categories, vowels)
Get a random passage, optionally limited to specific books or categories (e.g. categories ["Tanakh"], titles ["Psalms", "Proverbs"]).
輸入結構描述
{
"type": "object",
"properties": {
"titles": {
"type": "array",
"items": {
"type": "string"
}
},
"categories": {
"type": "array",
"items": {
"type": "string"
}
},
"vowels": {
"default": "full",
"description": "Hebrew vowels/cantillation: \"full\" keeps nikud, \"none\" strips it.",
"type": "string",
"enum": [
"full",
"none"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_passage_context(refs)
Given one or more segment references (e.g. "Berakhot 2a:1"), return the full logical passage/sugya each belongs to.
輸入結構描述
{
"type": "object",
"properties": {
"refs": {
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"refs"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_text_image(ref, language, platform)
Generate a shareable image (PNG) of a short passage, sized for a social platform.
輸入結構描述
{
"type": "object",
"properties": {
"ref": {
"type": "string",
"minLength": 2,
"description": "Short passage, ideally one verse/segment."
},
"language": {
"default": "en",
"type": "string",
"enum": [
"en",
"he"
]
},
"platform": {
"default": "facebook",
"type": "string",
"enum": [
"facebook",
"twitter",
"instagram"
]
}
},
"required": [
"ref"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢browse_library(category_path)
Browse the library's table of contents by category. With no path: top-level categories (Tanakh, Mishnah, Talmud, Midrash, Halakhah, Kabbalah, Liturgy, Jewish Thought, Tosefta, Chasidut, Musar, Responsa, Second Temple, Reference). With a path like "Talmud/Bavli/Seder Moed" or "Halakhah/Shulchan Arukh": that category's description, subcategories and books.
輸入結構描述
{
"type": "object",
"properties": {
"category_path": {
"description": "Slash-separated path, e.g. \"Tanakh/Torah\".",
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_book_titles(contains, category_path, limit)
Search the list of all books in the library by (part of) an English or Hebrew title, optionally within a category path. Returns canonical titles with their category.
輸入結構描述
{
"type": "object",
"properties": {
"contains": {
"description": "Substring to match, e.g. \"Rashi\", \"Mishneh Torah\", \"תהלים\".",
"type": "string"
},
"category_path": {
"description": "Limit to a category, e.g. \"Talmud/Bavli\".",
"type": "string"
},
"limit": {
"default": 100,
"type": "integer",
"minimum": 1,
"maximum": 500
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_book_info(title, include_structure, include_availability)
Metadata for a book: author(s), era, composition date and place, description, categories, alternative titles, section structure (e.g. Chapter/Verse, Daf/Line), chapter lengths, and alternate structures (e.g. parshiyot for Torah books). Optionally text availability counts.
輸入結構描述
{
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Book title, e.g. \"Genesis\", \"Berakhot\", \"Mishneh Torah, Sabbath\", \"Kuzari\"."
},
"include_structure": {
"default": true,
"description": "Include chapter lengths (shape).",
"type": "boolean"
},
"include_availability": {
"default": false,
"description": "Include counts of available Hebrew/English text.",
"type": "boolean"
}
},
"required": [
"title"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_book_raw_index(title)
Full, unabridged index record for a book (complete schema tree, match templates, alternate structures). Use get_book_info for a friendly summary.
輸入結構描述
{
"type": "object",
"properties": {
"title": {
"type": "string"
}
},
"required": [
"title"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_author_works(author_slug)
List the books written by an author. Pass the author slug (e.g. "rashi", "rambam", "ramban", "ibn-ezra", "rabbi-yosef-karo") — find slugs with resolve_name type AuthorTopic.
輸入結構描述
{
"type": "object",
"properties": {
"author_slug": {
"type": "string"
}
},
"required": [
"author_slug"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_library_statistics(kind, title, version_title, language, category_a, ...)
Statistics: - kind "word_count": number of words in a specific version of a book (needs title, version_title, language he/en). - kind "links_between_categories": how many links connect two categories (e.g. Tanakh ↔ Talmud). - kind "text_availability": raw availability counts for a book.
輸入結構描述
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"word_count",
"links_between_categories",
"text_availability"
]
},
"title": {
"type": "string"
},
"version_title": {
"type": "string"
},
"language": {
"type": "string",
"enum": [
"he",
"en"
]
},
"category_a": {
"type": "string"
},
"category_b": {
"type": "string"
}
},
"required": [
"kind"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_term(name)
Look up a named term (parsha names, section names, holidays, etc.) with its Hebrew and English titles and alternate spellings, e.g. "Noach", "Bereshit", "Perek".
輸入結構描述
{
"type": "object",
"properties": {
"name": {
"type": "string"
}
},
"required": [
"name"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢dictionary_lookup(word, context_ref, dictionary, never_split, always_split, ...)
Look up a Hebrew or Aramaic word in classic dictionaries (Jastrow, BDB, Klein, and others). Handles prefixes/inflected forms. Pass context_ref to disambiguate using the passage where the word appears.
輸入結構描述
{
"type": "object",
"properties": {
"word": {
"type": "string",
"minLength": 1,
"description": "Hebrew/Aramaic word (with or without vowels)."
},
"context_ref": {
"description": "Passage the word appears in, e.g. \"Berakhot 2a:1\".",
"type": "string"
},
"dictionary": {
"description": "Only return entries from this dictionary, e.g. \"Jastrow Dictionary\", \"Klein Dictionary\", \"BDB Dictionary\".",
"type": "string"
},
"never_split": {
"description": "Don't try splitting prefixes off the word.",
"type": "boolean"
},
"always_split": {
"type": "boolean"
},
"consonants_only": {
"description": "Match on consonants, ignoring vowels.",
"type": "boolean"
},
"max_entries": {
"default": 8,
"type": "integer",
"minimum": 1,
"maximum": 30
}
},
"required": [
"word"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢dictionary_autocomplete(prefix, dictionary, limit)
Autocomplete a partial Hebrew/Aramaic word against a dictionary ("Jastrow Dictionary", "Klein Dictionary", "BDB Augmented Strong").
輸入結構描述
{
"type": "object",
"properties": {
"prefix": {
"type": "string",
"minLength": 1
},
"dictionary": {
"default": "Jastrow Dictionary",
"type": "string"
},
"limit": {
"default": 15,
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"required": [
"prefix"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_learning_schedules(date, israel, timezone, custom)
Today's (or any date's) study schedule items with exact references: Parashat HaShavua, Haftarah, Daf Yomi, 929, Daily Mishnah, Daily Rambam (1 and 3 chapters), Daf a Week, Halakhah Yomit, Arukh HaShulchan Yomi, Tanakh Yomi, Chok LeYisrael, Tanya Yomi, Yerushalmi Yomi, and more.
輸入結構描述
{
"type": "object",
"properties": {
"date": {
"description": "YYYY-MM-DD (default today).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"israel": {
"default": false,
"type": "boolean"
},
"timezone": {
"description": "IANA timezone used for 'today'.",
"type": "string"
},
"custom": {
"description": "Haftarah custom.",
"type": "string",
"enum": [
"ashkenazi",
"sephardi"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_parasha(parasha)
Details for a weekly Torah portion by name (e.g. "Noach", "Lech Lecha", "Ki Tisa"): full reference, aliyot, haftarah, and the next date it will be read.
輸入結構描述
{
"type": "object",
"properties": {
"parasha": {
"type": "string",
"description": "Parasha name in English transliteration."
}
},
"required": [
"parasha"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_topic(slug, max_sources, include_source_text, include_related_topics)
Get a curated topic — a person (e.g. "moses", "rambam", "rabbi-akiva"), concept ("teshuvah", "kindness"), holiday ("passover"), mitzvah or object — with its description and its top sources, ordered by importance. Use resolve_name (type "Topic") or search_topics to find slugs.
輸入結構描述
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "Topic slug, e.g. \"shabbat\", \"prayer\", \"abraham\"."
},
"max_sources": {
"default": 20,
"type": "integer",
"minimum": 0,
"maximum": 100
},
"include_source_text": {
"default": false,
"description": "Also fetch the text of the top sources (first 10).",
"type": "boolean"
},
"include_related_topics": {
"default": true,
"type": "boolean"
}
},
"required": [
"slug"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢search_topics(contains, limit)
List topics, optionally filtered by a word in the title. Without a filter returns the most prominent topics.
輸入結構描述
{
"type": "object",
"properties": {
"contains": {
"type": "string"
},
"limit": {
"default": 50,
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_topic_graph(slug, link_type)
Get the network of topics connected to a topic (e.g. students/teachers of a sage, parts of a concept). Optionally restrict to one link type such as "is-a", "has-student", "has-teacher", "related-to", "part-of".
輸入結構描述
{
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"link_type": {
"type": "string"
}
},
"required": [
"slug"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢recommend_topics(refs)
Recommend topics relevant to one or more passages (e.g. for tagging a source sheet or finding themes in a set of verses).
輸入結構描述
{
"type": "object",
"properties": {
"refs": {
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"refs"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_random_source_by_topic
Get a random source together with the topic it illustrates — handy for a daily inspiration or quiz.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_seasonal_topic(kind, date, israel)
Get the curated topic for the current parsha (kind "parasha") or the current/upcoming holiday (kind "holiday"), with description and key sources.
輸入結構描述
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"parasha",
"holiday"
]
},
"date": {
"description": "For holiday: date to check (default today).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"israel": {
"default": false,
"type": "boolean"
}
},
"required": [
"kind"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_source_sheet(ids, max_sources)
Get a user-made source sheet by id: title, author, tags, and each source (reference + text) and commentary block in order. Pass several ids to fetch up to 10 sheets.
輸入結構描述
{
"type": "object",
"properties": {
"ids": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "string"
}
]
}
},
"max_sources": {
"default": 60,
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"required": [
"ids"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_source_sheets(ref, user_id, sort_by, limit, offset)
List public source sheets: - by passage (ref): sheets that use a given text; - by user (user_id): a user's sheets, sortable by "views" or "date", with paging; - latest: newest public sheets (no ref/user_id).
輸入結構描述
{
"type": "object",
"properties": {
"ref": {
"type": "string"
},
"user_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"sort_by": {
"default": "views",
"type": "string",
"enum": [
"views",
"date"
]
},
"limit": {
"default": 20,
"type": "integer",
"minimum": 1,
"maximum": 100
},
"offset": {
"default": 0,
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_sheet_tags(kind, sort_by, user_id, limit)
Source-sheet tags: "trending" (this week's trending tags), "all" (every tag, sorted by count or alphabetically), or a specific user's tags.
輸入結構描述
{
"type": "object",
"properties": {
"kind": {
"default": "trending",
"type": "string",
"enum": [
"trending",
"all",
"user"
]
},
"sort_by": {
"default": "count",
"type": "string",
"enum": [
"count",
"alpha"
]
},
"user_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"limit": {
"default": 50,
"type": "integer",
"minimum": 1,
"maximum": 500
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢check_sheet_modified(id, since)
Check whether a source sheet has been modified since a timestamp (ISO date/time).
輸入結構描述
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "string"
}
]
},
"since": {
"type": "string",
"description": "ISO timestamp, e.g. 2026-01-01T00:00:00"
}
},
"required": [
"id",
"since"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_collections(slug, user_id, contains, limit)
Browse collections of source sheets: pass slug for one collection (with its sheets), user_id for a user's collections, or neither to list public collections (filterable by name).
輸入結構描述
{
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"user_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"contains": {
"type": "string"
},
"limit": {
"default": 40,
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_user_profile(slug)
Public profile of a library user/author of source sheets, by profile slug (e.g. "dovid-birk").
輸入結構描述
{
"type": "object",
"properties": {
"slug": {
"type": "string"
}
},
"required": [
"slug"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢todays_learning(date, israel, timezone, include_opening_text, only)
One-call daily briefing: today's Hebrew date, holidays/events, the weekly parsha, and every daily learning schedule (Daf Yomi, Rambam, Mishnah, 929, Halakhah Yomit, Tanya, etc.) with exact references. Optionally include the opening lines of each study item.
輸入結構描述
{
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"israel": {
"default": false,
"type": "boolean"
},
"timezone": {
"default": "America/New_York",
"type": "string"
},
"include_opening_text": {
"default": false,
"description": "Include the first lines of each study item.",
"type": "boolean"
},
"only": {
"description": "Only these schedules, e.g. [\"Daf Yomi\", \"Daily Rambam\", \"Parashat Hashavua\"].",
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢parsha_study_pack(date, parasha, aliyah, commentator, verses_of_commentary, ...)
Everything to study the weekly Torah portion: the reading (for a date, or by parsha name), aliyot and haftarah, the text of a chosen aliyah (Hebrew + English), a commentator's notes on its opening verses, and the parsha's topic and themes. Great for preparing a dvar Torah.
輸入結構描述
{
"type": "object",
"properties": {
"date": {
"description": "Any date — uses that week's Shabbat reading. Default: this week.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"parasha": {
"description": "Or a parsha name, e.g. \"Vayera\".",
"type": "string"
},
"aliyah": {
"default": 1,
"description": "Which aliyah's text to include.",
"type": "integer",
"minimum": 1,
"maximum": 7
},
"commentator": {
"default": "Rashi",
"type": "string"
},
"verses_of_commentary": {
"default": 3,
"type": "integer",
"minimum": 0,
"maximum": 10
},
"israel": {
"default": false,
"type": "boolean"
},
"vowels": {
"default": "full",
"type": "string",
"enum": [
"full",
"none"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢holiday_sources(holiday, max_sources, israel)
For the next (or a named) Jewish holiday: its dates, a description, the Torah/Haftarah readings, and key classical sources with text. Examples: "Sukkot", "Chanukah", "Purim", "Pesach", "Shavuot", "Tisha B'Av", "Rosh Hashana".
輸入結構描述
{
"type": "object",
"properties": {
"holiday": {
"description": "Holiday name; default is the next major/minor holiday from today.",
"type": "string"
},
"max_sources": {
"default": 6,
"type": "integer",
"minimum": 1,
"maximum": 15
},
"israel": {
"default": false,
"type": "boolean"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢shabbat_briefing(location, latitude, longitude, timezone, date, ...)
A ready-to-read Friday summary for a location: candle-lighting and havdalah times, the parsha with aliyot and haftarah, the opening verse of the parsha in Hebrew and English, and any holiday that week.
輸入結構描述
{
"type": "object",
"properties": {
"location": {
"description": "Where the user is. A US ZIP code (\"11691\"), a city name (\"Jerusalem\", \"London\", \"Lakewood, NJ\"), or a numeric place id returned by find_location. Omit to use the server default.",
"type": "string"
},
"latitude": {
"description": "Latitude in decimal degrees (use with longitude + timezone instead of location).",
"type": "number",
"minimum": -90,
"maximum": 90
},
"longitude": {
"description": "Longitude in decimal degrees.",
"type": "number",
"minimum": -180,
"maximum": 180
},
"timezone": {
"description": "IANA timezone, required with latitude/longitude, e.g. \"America/New_York\".",
"type": "string"
},
"date": {
"description": "Any date in the week (default this week).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"candle_minutes": {
"type": "integer",
"minimum": 10,
"maximum": 90
},
"havdalah_minutes": {
"type": "integer",
"minimum": 20,
"maximum": 90
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}社群
證據