Torah Library

Official49 tools

by torah

Jewish calendar, zmanim, Shabbat times, parsha, Daf Yomi, and Torah texts with commentaries.

MCP Server: xyz.kolsgo.torah/torah-library

This MCP server provides access to Jewish calendar data, including zmanim, Shabbat times, parsha, Daf Yomi, and Torah texts with commentaries. The catalog entry identifies the server by the slug xyz-kolsgo-torah-torah-library and describes its scope around these time-based and textual resources.

🛠️ Key Features

Jewish calendar
Zmanim
Shabbat times
Parsha
Daf Yomi
Torah texts with commentaries

🚀 Use Cases

Retrieve calendar-based Jewish times and schedules
Look up Shabbat times and zmanim
Access parsha and Daf Yomi references
Use Torah text content alongside commentaries

⚡ Developer Benefits

Focused dataset covering core Jewish calendar and study resources
Named server identifier: xyz.kolsgo.torah/torah-library

⚠️ Limitations

No tool count, specific API/tool interfaces, topics, or README excerpt were provided in the source data.

Captured live from the server via tools/list.

convert_date

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.

Parameters6

gregorian_date	string	optional	Gregorian date YYYY-MM-DD. Defaults to today (US Eastern) if nothing else is given.
end_date	string	optional	Optional end of a Gregorian range to convert every day in it.
after_sunset	boolean	optional	Treat the Gregorian date as after sunset (Hebrew date = next day).
hebrew_year	integer	optional	Hebrew year, e.g. 5787.
hebrew_month	string	optional	Hebrew month name.
hebrew_day	integer	optional	Day of the Hebrew month.

Raw schema

{
  "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

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.

Parameters27

start	string	optional	Range start YYYY-MM-DD.
end	string	optional	Range end YYYY-MM-DD.
year	integer	optional	Gregorian year (or Hebrew year if hebrew_year_mode=true). Used when start/end not given.
month	integer	optional	Gregorian month 1-12 (with year).
hebrew_year_mode	boolean	optional	Interpret year as a Hebrew year (e.g. 5787) and return the whole Hebrew year.
major_holidays	boolean	optional
minor_holidays	boolean	optional
modern_holidays	boolean	optional	Yom HaAtzmaut, Yom HaShoah, etc.
rosh_chodesh	boolean	optional
minor_fasts	boolean	optional
special_shabbatot	boolean	optional	Shabbat Shekalim, Zachor, HaGadol, etc.
parsha	boolean	optional	Weekly Torah portion on Shabbat.
omer	boolean	optional	Daily Sefirat HaOmer count.
molad	boolean	optional	Molad announcements.
yom_kippur_katan	boolean	optional
yizkor	boolean	optional
hebrew_date_every_day	boolean	optional	Add the Hebrew date for every day in range.
learning	array	optional	Daily learning cycles to include.
israel	boolean	optional	Use the Israel holiday/parsha schedule instead of the Diaspora one.
hebrew_names	boolean	optional	Return event titles in Hebrew.
include_times	boolean	optional	Include candle lighting / havdalah / fast times (needs a location).
candle_minutes	integer	optional	Minutes before sunset for candle lighting (default 18; Jerusalem 40).
havdalah_minutes	integer	optional	Havdalah N minutes after sunset instead of at nightfall (e.g. 42, 50, 72).
location	string	optional	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.
latitude	number	optional	Latitude in decimal degrees (use with longitude + timezone instead of location).
longitude	number	optional	Longitude in decimal degrees.
timezone	string	optional	IANA timezone, required with latitude/longitude, e.g. "America/New_York".

Raw schema

{
  "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

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.

Parameters8

location	string	optional	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.
latitude	number	optional	Latitude in decimal degrees (use with longitude + timezone instead of location).
longitude	number	optional	Longitude in decimal degrees.
timezone	string	optional	IANA timezone, required with latitude/longitude, e.g. "America/New_York".
date	string	optional	Any date in the week you want (defaults to this week).
candle_minutes	integer	optional	Minutes before sunset for candle lighting (default 18; 40 for Jerusalem).
havdalah_minutes	integer	optional	Havdalah N minutes after sunset; default is nightfall (tzeit, 8.5°).
include_readings	boolean	optional	Include aliyah-by-aliyah Torah reading details.

Raw schema

{
  "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

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.

Parameters8

location	string	optional	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.
latitude	number	optional	Latitude in decimal degrees (use with longitude + timezone instead of location).
longitude	number	optional	Longitude in decimal degrees.
timezone	string	optional	IANA timezone, required with latitude/longitude, e.g. "America/New_York".
date	string	optional	Date YYYY-MM-DD (default today).
end_date	string	optional	Optional end date for a range.
use_elevation	boolean	optional	Adjust sunrise/sunset for elevation.
include_seconds	boolean	optional	Return times with seconds precision.

Raw schema

{
  "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

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.

Parameters5

date	string	optional	Date YYYY-MM-DD (defaults to the coming Shabbat).
end_date	string	optional	End date for a range (max ~1 year).
israel	boolean	optional
triennial	boolean	optional	Return triennial-cycle aliyot.
include_weekday	boolean	optional	Include Monday/Thursday and Rosh Chodesh/holiday weekday readings.

Raw schema

{
  "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

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.

Parameters2

entries	array	required
years	integer	optional	How many years ahead to list.

Raw schema

{
  "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

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.

Parameters1

query

string

required

City or place name, e.g. "Jerusalem", "Monsey", "Paris".

Raw schema

{
  "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

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.

Parameters7

ref	string	required	Text reference, e.g. "Genesis 1:1-10" or "Berakhot 2a".
language	string	optional	"both" = original + translation; "all" = every available version.
translation_language	string	optional	Translation language family instead of English, e.g. "french", "spanish", "german", "russian", "italian".
version_title	string	optional	Exact version title to use (see get_text_versions).
vowels	string	optional	Hebrew vowels/cantillation: "full" keeps nikud, "none" strips it.
footnotes	boolean	optional	Keep translator footnotes inline.
max_segments	integer	optional	Max segments to return.

Raw schema

{
  "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

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.

Parameters2

refs	array	required	List of references, e.g. ["Genesis 1:1", "Exodus 20:2", "Rashi on Genesis 1:1:1"].
vowels	string	optional	Hebrew vowels/cantillation: "full" keeps nikud, "none" strips it.

Raw schema

{
  "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

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.

Parameters3

name	string	required
limit	integer	optional
type	string	optional	Restrict to one kind of result.

Raw schema

{
  "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

Validate and normalize a text reference: canonical English and Hebrew forms, the book it belongs to, its structure, and previous/next sections.

Parameters1

ref

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "ref": {
      "type": "string",
      "minLength": 2
    }
  },
  "required": [
    "ref"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

find_references_in_text

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.

Parameters3

text	string	required	Body text to scan.
title	string	optional	Optional title of the piece (also scanned).
language	string	optional

Raw schema

{
  "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

Check the status/result of a background task (e.g. a long reference-detection job) by task_id.

Parameters1

task_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "task_id": {
      "type": "string",
      "minLength": 4
    }
  },
  "required": [
    "task_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_library

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.

Parameters8

query	string	required
search_in	string	optional
filters	array	optional	Category/book paths to restrict to.
exact	boolean	optional
sort	string	optional
size	integer	optional
offset	integer	optional
slop	integer	optional	Allowed word distance for multi-word phrases (default 10 for texts).

Raw schema

{
  "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

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.

Parameters7

ref	string	required	Passage, e.g. "Genesis 1:1" or "Berakhot 2a".
commentator	string	optional	Commentator/work name to fetch in full.
category	string	optional
include_text	boolean	optional	Include the text of connected sources (first `limit`).
limit	integer	optional
language	string	optional
vowels	string	optional	Hebrew vowels/cantillation: "full" keeps nikud, "none" strips it.

Raw schema

{
  "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

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.

Parameters2

ref	string	required
include	array	optional

Raw schema

{
  "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

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.

Parameters2

book	string	required	Book title, e.g. "Genesis", "Berakhot", "Mishneh Torah, Sabbath".
language	string	optional	Filter by language code, e.g. "en", "he", "fr".

Raw schema

{
  "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

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.

Parameters1

language

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "language": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_manuscripts

Images of manuscripts and early printed editions (e.g. Vilna Shas, Venice 1523, Munich manuscript) for a passage, with image and thumbnail URLs.

Parameters1

ref

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "ref": {
      "type": "string",
      "minLength": 2
    }
  },
  "required": [
    "ref"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_random_text

Get a random passage, optionally limited to specific books or categories (e.g. categories ["Tanakh"], titles ["Psalms", "Proverbs"]).

Parameters3

titles	array	optional
categories	array	optional
vowels	string	optional	Hebrew vowels/cantillation: "full" keeps nikud, "none" strips it.

Raw schema

{
  "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

Given one or more segment references (e.g. "Berakhot 2a:1"), return the full logical passage/sugya each belongs to.

Parameters1

refs

array

required

Raw schema

{
  "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

Generate a shareable image (PNG) of a short passage, sized for a social platform.

Parameters3

ref	string	required	Short passage, ideally one verse/segment.
language	string	optional
platform	string	optional

Raw schema

{
  "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

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.

Parameters1

category_path

string

optional

Slash-separated path, e.g. "Tanakh/Torah".

Raw schema

{
  "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

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.

Parameters3

contains	string	optional	Substring to match, e.g. "Rashi", "Mishneh Torah", "תהלים".
category_path	string	optional	Limit to a category, e.g. "Talmud/Bavli".
limit	integer	optional

Raw schema

{
  "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

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.

Parameters3

title	string	required	Book title, e.g. "Genesis", "Berakhot", "Mishneh Torah, Sabbath", "Kuzari".
include_structure	boolean	optional	Include chapter lengths (shape).
include_availability	boolean	optional	Include counts of available Hebrew/English text.

Raw schema

{
  "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

Full, unabridged index record for a book (complete schema tree, match templates, alternate structures). Use get_book_info for a friendly summary.

Parameters1

title

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string"
    }
  },
  "required": [
    "title"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_author_works

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.

Parameters1

author_slug

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "author_slug": {
      "type": "string"
    }
  },
  "required": [
    "author_slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_library_statistics

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.

Parameters6

kind	string	required
title	string	optional
version_title	string	optional
language	string	optional
category_a	string	optional
category_b	string	optional

Raw schema

{
  "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

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".

Parameters1

name

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

dictionary_lookup

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.

Parameters7

word	string	required	Hebrew/Aramaic word (with or without vowels).
context_ref	string	optional	Passage the word appears in, e.g. "Berakhot 2a:1".
dictionary	string	optional	Only return entries from this dictionary, e.g. "Jastrow Dictionary", "Klein Dictionary", "BDB Dictionary".
never_split	boolean	optional	Don't try splitting prefixes off the word.
always_split	boolean	optional
consonants_only	boolean	optional	Match on consonants, ignoring vowels.
max_entries	integer	optional

Raw schema

{
  "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

Autocomplete a partial Hebrew/Aramaic word against a dictionary ("Jastrow Dictionary", "Klein Dictionary", "BDB Augmented Strong").

Parameters3

prefix	string	required
dictionary	string	optional
limit	integer	optional

Raw schema

{
  "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

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.

Parameters4

date	string	optional	YYYY-MM-DD (default today).
israel	boolean	optional
timezone	string	optional	IANA timezone used for 'today'.
custom	string	optional	Haftarah custom.

Raw schema

{
  "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

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.

Parameters1

parasha

string

required

Parasha name in English transliteration.

Raw schema

{
  "type": "object",
  "properties": {
    "parasha": {
      "type": "string",
      "description": "Parasha name in English transliteration."
    }
  },
  "required": [
    "parasha"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_topic

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.

Parameters4

slug	string	required	Topic slug, e.g. "shabbat", "prayer", "abraham".
max_sources	integer	optional
include_source_text	boolean	optional	Also fetch the text of the top sources (first 10).
include_related_topics	boolean	optional

Raw schema

{
  "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

List topics, optionally filtered by a word in the title. Without a filter returns the most prominent topics.

Parameters2

contains	string	optional
limit	integer	optional

Raw schema

{
  "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

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".

Parameters2

slug	string	required
link_type	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "link_type": {
      "type": "string"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

recommend_topics

Recommend topics relevant to one or more passages (e.g. for tagging a source sheet or finding themes in a set of verses).

Parameters1

refs

array

required

Raw schema

{
  "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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_seasonal_topic

Get the curated topic for the current parsha (kind "parasha") or the current/upcoming holiday (kind "holiday"), with description and key sources.

Parameters3

kind	string	required
date	string	optional	For holiday: date to check (default today).
israel	boolean	optional

Raw schema

{
  "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

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.

Parameters2

ids	array	required
max_sources	integer	optional

Raw schema

{
  "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

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).

Parameters5

ref	string	optional
user_id	integer	optional
sort_by	string	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "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

Source-sheet tags: "trending" (this week's trending tags), "all" (every tag, sorted by count or alphabetically), or a specific user's tags.

Parameters4

kind	string	optional
sort_by	string	optional
user_id	integer	optional
limit	integer	optional

Raw schema

{
  "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

Check whether a source sheet has been modified since a timestamp (ISO date/time).

Parameters2

id	any	required
since	string	required	ISO timestamp, e.g. 2026-01-01T00:00:00

Raw schema

{
  "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

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).

Parameters4

slug	string	optional
user_id	integer	optional
contains	string	optional
limit	integer	optional

Raw schema

{
  "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

Public profile of a library user/author of source sheets, by profile slug (e.g. "dovid-birk").

Parameters1

slug

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

todays_learning

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.

Parameters5

date	string	optional
israel	boolean	optional
timezone	string	optional
include_opening_text	boolean	optional	Include the first lines of each study item.
only	array	optional	Only these schedules, e.g. ["Daf Yomi", "Daily Rambam", "Parashat Hashavua"].

Raw schema

{
  "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

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.

Parameters7

date	string	optional	Any date — uses that week's Shabbat reading. Default: this week.
parasha	string	optional	Or a parsha name, e.g. "Vayera".
aliyah	integer	optional	Which aliyah's text to include.
commentator	string	optional
verses_of_commentary	integer	optional
israel	boolean	optional
vowels	string	optional

Raw schema

{
  "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

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".

Parameters3

holiday	string	optional	Holiday name; default is the next major/minor holiday from today.
max_sources	integer	optional
israel	boolean	optional

Raw schema

{
  "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

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.

Parameters7

location	string	optional	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.
latitude	number	optional	Latitude in decimal degrees (use with longitude + timezone instead of location).
longitude	number	optional	Longitude in decimal degrees.
timezone	string	optional	IANA timezone, required with latitude/longitude, e.g. "America/New_York".
date	string	optional	Any date in the week (default this week).
candle_minutes	integer	optional
havdalah_minutes	integer	optional

Raw schema

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

Install

Tools (49)

convert_dateget_jewish_calendarget_shabbat_timesget_zmanimget_torah_readingget_yahrzeit_datesfind_locationget_text

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://torah.kolsgo.xyz/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "torah-library": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://torah.kolsgo.xyz/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

MCP Server: xyz.kolsgo.torah/torah-library

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

convert_date

get_jewish_calendar

get_shabbat_times

get_zmanim

get_torah_reading

get_yahrzeit_dates

find_location

get_text

get_texts_bulk

resolve_name

parse_reference

find_references_in_text

get_task_status

search_library

get_commentaries

get_related_content

get_text_versions

list_translations

get_manuscripts

get_random_text

get_passage_context

get_text_image

browse_library

list_book_titles

get_book_info

get_book_raw_index

get_author_works

get_library_statistics

get_term

dictionary_lookup

dictionary_autocomplete

get_learning_schedules

get_parasha

get_topic

search_topics

get_topic_graph

recommend_topics

get_random_source_by_topic

get_seasonal_topic

get_source_sheet

list_source_sheets

get_sheet_tags

check_sheet_modified

get_collections

get_user_profile

todays_learning

parsha_study_pack

holiday_sources

shabbat_briefing

Install

Remote endpoint

Related servers