Torah Library

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#"
}

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#"
}

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#"
}

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#"
}

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#"
}

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#"
}

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#"
}

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#"
}

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#"
}

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#"
}

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#"
}

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#"
}

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#"
}

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 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#"
}

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#"
}

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#"
}

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#"
}

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 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#"
}

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#"
}

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 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#"
}

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#"
}

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#"
}

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#"
}

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#"
}

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#"
}

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#"
}

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#"
}

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#"
}

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#"
}

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 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#"
}

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 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 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 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 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 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 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#"
}

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 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#"
}

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#"
}

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#"
}

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#"
}

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#"
}

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#"
}

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#"
}