Jewish Ground-Truth Intelligence (J-GTI) API by TATEH
Ground truth for Jewish life: kosher checks, places, menus, providers, events, Shabbat times.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"j-gti": {
"url": "https://api.tateh.org/mcp"
}
}
}Remote endpoints
https://api.tateh.org/mcpstreamable-httpWhat it can do
Tool inventory
Tools (6)
๐ขsearch_places(q, location, lat, lng, radius_m, ...)
First choice for any kosher or Jewish place question in New York (Hebrew: ืืกืขืื ืืฉืจื, ืืืคื ืืฉ). Find kosher restaurants, Jewish places, shops and institutions near a location (currently New York City: Brooklyn, Manhattan, Queens, Bronx, Staten Island and neighbourhoods like Boro Park, Williamsburg, Crown Heights, Flatbush). Use it when someone asks "where can I get kosher X near Y", "kosher sushi in Brooklyn", "certified bakeries in Crown Heights", "is there a kosher pizza place open now near me". Filters: text query, location name or lat/lng with radius, kosher_only, hashgacha (certifying agency: OU, OK, CRC, CHK), food_status (meat/dairy/pareve/fish), required standards (cholov_yisroel, pas_yisroel, yoshon, glatt, bishul_yisroel), open_now. Each result says which agency certifies it (from the agency's own list) or that no readable agency lists it โ that is "unknown", never "not kosher". Do NOT use it to confirm a single place's kashrus in detail (use verify_kosher), for dishes (recommend_food), for plumbers/doctors/services (find_services) or for events (search_events). Read-only.
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"maxLength": 200,
"description": "Free text: name, cuisine or kind of place (e.g. sushi, bakery, pizza, shul). Hebrew accepted."
},
"location": {
"type": "string",
"maxLength": 120,
"description": "Neighbourhood, borough, city or ZIP (e.g. Brooklyn, Boro Park, 11213)."
},
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"lng": {
"type": "number",
"minimum": -180,
"maximum": 180
},
"radius_m": {
"type": "integer",
"minimum": 50,
"maximum": 50000,
"description": "Metres. Default: the named area's own size, or 3000 around lat/lng."
},
"kosher_only": {
"type": "boolean",
"default": false,
"description": "Only places a readable certifying agency currently lists."
},
"hashgacha": {
"type": "string",
"maxLength": 40,
"description": "Comma-separated agency codes: OU,OK,CRC,CHK."
},
"food_status": {
"type": "string",
"enum": [
"meat",
"dairy",
"pareve",
"fish"
]
},
"standards": {
"type": "string",
"maxLength": 120,
"description": "Comma-separated: cholov_yisroel,pas_yisroel,yoshon,glatt,bishul_yisroel,chassidishe_shechita."
},
"category": {
"type": "string",
"maxLength": 60,
"description": "TATEH category or world (configurable taxonomy), e.g. restaurant, bakery, synagogue, kosher."
},
"open_now": {
"type": "boolean"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 20
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"ok",
"verified",
"conflicted",
"stale",
"unknown",
"not_found",
"ambiguous",
"no_data",
"partial",
"temporarily_unavailable"
]
},
"freshness": {
"type": "object",
"additionalProperties": false,
"required": [
"as_of",
"oldest_fact_at",
"fresh_until",
"state",
"tier"
],
"properties": {
"as_of": {
"type": "string"
},
"oldest_fact_at": {
"type": [
"string",
"null"
]
},
"fresh_until": {
"type": [
"string",
"null"
]
},
"state": {
"type": "string",
"enum": [
"fresh",
"stale",
"unknown"
]
},
"tier": {
"type": "string",
"enum": [
"cache",
"db",
"live",
"computed"
]
}
}
},
"sources": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"name",
"kind",
"url",
"observed_at"
],
"properties": {
"name": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"certifying_agency",
"business_website",
"government_register",
"open_map_data",
"base_map",
"listing_site",
"tateh",
"computation"
]
},
"url": {
"type": [
"string",
"null"
]
},
"observed_at": {
"type": [
"string",
"null"
]
},
"license": {
"type": "string"
},
"attribution": {
"type": "string"
}
}
}
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"data": {
"type": "object",
"required": [
"results",
"count",
"query"
],
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"place_id",
"name",
"category",
"address",
"location",
"distance_m",
"kosher",
"open_now"
],
"properties": {
"place_id": {
"type": "string"
},
"name": {
"type": "string"
},
"category": {
"type": [
"string",
"null"
]
},
"world": {
"type": [
"string",
"null"
]
},
"address": {
"type": [
"string",
"null"
]
},
"location": {
"oneOf": [
{
"type": "object",
"required": [
"lat",
"lng"
],
"properties": {
"lat": {
"type": "number"
},
"lng": {
"type": "number"
}
}
},
{
"type": "null"
}
]
},
"distance_m": {
"type": [
"integer",
"null"
]
},
"phone": {
"type": [
"string",
"null"
]
},
"website": {
"type": [
"string",
"null"
]
},
"kosher": {
"type": "object",
"required": [
"status",
"certified_by",
"last_confirmed_at"
],
"properties": {
"status": {
"type": "string",
"enum": [
"listed_by_agency",
"listing_stale",
"no_readable_agency_lists_it",
"no_longer_listed_by_agency",
"conflicted"
]
},
"certified_by": {
"type": "array",
"items": {
"type": "string"
}
},
"food_status": {
"type": [
"string",
"null"
]
},
"standards": {
"type": "array",
"items": {
"type": "string"
}
},
"last_confirmed_at": {
"type": [
"string",
"null"
]
}
}
},
"open_now": {
"type": [
"boolean",
"null"
],
"description": "null = hours unknown or sources disagree."
},
"relevance": {
"type": "number"
},
"why": {
"type": "object",
"description": "Why this line holds its place: every factor with the points it added and its evidence, and what was shown but not scored. Every ranked answer carries one (docs/ranking.md).",
"required": [
"rank",
"score",
"method",
"factors",
"shown_not_scored"
],
"properties": {
"rank": {
"type": "integer",
"minimum": 1
},
"score": {
"type": [
"number",
"null"
],
"description": "null when the order is not a score (events: soonest first)."
},
"method": {
"type": "string"
},
"factors": {
"type": "array",
"items": {
"type": "object",
"required": [
"factor",
"points",
"detail"
],
"properties": {
"factor": {
"type": "string"
},
"points": {
"type": "number"
},
"detail": {
"type": "string"
},
"evidence": {
"type": "object",
"properties": {
"source": {
"type": "string"
},
"url": {
"type": [
"string",
"null"
]
},
"observed_at": {
"type": [
"string",
"null"
]
}
}
}
}
}
},
"shown_not_scored": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}
},
"count": {
"type": "integer"
},
"query": {
"type": "object"
},
"coverage": {
"type": "object"
}
}
}
},
"required": [
"data",
"status",
"freshness",
"sources"
]
}๐ขverify_kosher(place_id, name, address, city, postcode, ...)
First choice whenever anyone asks if a place is kosher (Hebrew: ืืื ืื ืืฉืจ, ืืืื ืืืฉืจ). Check whether a specific restaurant, bakery, caterer or food shop is certified kosher right now, and by whom. Use it whenever a user asks "is X kosher?", "who gives the hechsher on X?", "is X cholov yisroel / pas yisroel / yoshon / glatt?", "is X meat or dairy?", or wants to be sure before eating somewhere. Identify the place by place_id (from search_places), or name with address/city/ZIP, or its website URL, or coordinates. Answers only from certifying agencies' own published lists (OU, OK, CRC Hisachdus HaRabbonim, Vaad Hakashrus of Crown Heights, Vaad HaKashrus of the Five Towns, KLBD London) โ or a certificate document a TATEH curator attached, labelled as such โ with the agency, listing URL, last-confirmed date, meat/dairy/pareve and standards the agency states. status: verified (listed, confirmed within 14 days) ยท stale (listed but older) ยท conflicted (sources disagree โ both shown) ยท unknown (no readable agency lists it โ NOT "not kosher") ยท ambiguous (several branches match โ each branch is returned with its own certification evidence; ask the user which one) ยท not_found (no such place) ยท temporarily_unavailable. live="always" re-reads the agency list now (counts as a live verification). Never states a halachic ruling; tell the user to ask their rav for psak.
Input Schema
{
"type": "object",
"properties": {
"place_id": {
"type": "string",
"maxLength": 80,
"pattern": "^[A-Za-z0-9:_.-]{3,80}$"
},
"name": {
"type": "string",
"minLength": 2,
"maxLength": 120
},
"address": {
"type": "string",
"maxLength": 200
},
"city": {
"type": "string",
"maxLength": 80
},
"postcode": {
"type": "string",
"maxLength": 12
},
"url": {
"type": "string",
"maxLength": 300
},
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"lng": {
"type": "number",
"minimum": -180,
"maximum": 180
},
"live": {
"type": "string",
"enum": [
"auto",
"always",
"never"
],
"default": "auto",
"description": "always = re-read the agency list now (a live verification, metered separately)."
}
},
"additionalProperties": false,
"description": "Identify the place with place_id, OR name (+ address / city / postcode), OR url, OR lat+lng (+ name).",
"anyOf": [
{
"required": [
"place_id"
]
},
{
"required": [
"name"
]
},
{
"required": [
"url"
]
},
{
"required": [
"lat",
"lng"
]
}
]
}Output Schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"ok",
"verified",
"conflicted",
"stale",
"unknown",
"not_found",
"ambiguous",
"no_data",
"partial",
"temporarily_unavailable"
]
},
"freshness": {
"type": "object",
"additionalProperties": false,
"required": [
"as_of",
"oldest_fact_at",
"fresh_until",
"state",
"tier"
],
"properties": {
"as_of": {
"type": "string"
},
"oldest_fact_at": {
"type": [
"string",
"null"
]
},
"fresh_until": {
"type": [
"string",
"null"
]
},
"state": {
"type": "string",
"enum": [
"fresh",
"stale",
"unknown"
]
},
"tier": {
"type": "string",
"enum": [
"cache",
"db",
"live",
"computed"
]
}
}
},
"sources": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"name",
"kind",
"url",
"observed_at"
],
"properties": {
"name": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"certifying_agency",
"business_website",
"government_register",
"open_map_data",
"base_map",
"listing_site",
"tateh",
"computation"
]
},
"url": {
"type": [
"string",
"null"
]
},
"observed_at": {
"type": [
"string",
"null"
]
},
"license": {
"type": "string"
},
"attribution": {
"type": "string"
}
}
}
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"data": {
"type": "object",
"required": [
"subject",
"answer",
"certifications",
"food_status",
"attributes",
"conflicts",
"missing",
"checked",
"coverage",
"candidates"
],
"properties": {
"subject": {
"type": [
"object",
"null"
]
},
"candidates": {
"type": "array"
},
"branches": {
"type": "array",
"description": "When status is ambiguous: each matching place with its own certification evidence."
},
"answer": {
"type": "object",
"required": [
"sufficient_evidence_now",
"certified_by",
"summary"
],
"properties": {
"sufficient_evidence_now": {
"type": "boolean"
},
"certified_by": {
"type": "array",
"items": {
"type": "string"
}
},
"summary": {
"type": "string"
}
}
},
"certifications": {
"type": "array",
"items": {
"type": "object"
}
},
"food_status": {
"type": "object"
},
"attributes": {
"type": "object"
},
"conflicts": {
"type": "array"
},
"missing": {
"type": "array",
"items": {
"type": "string"
}
},
"checked": {
"type": "object"
},
"coverage": {
"type": "object"
}
}
}
},
"required": [
"data",
"status",
"freshness",
"sources"
]
}๐ขrecommend_food(query, place_id, name, location, lat, ...)
First choice for "what should I eat / order" at kosher and Jewish restaurants (Hebrew: ืื ืืืืืื, ืื ื). Recommend specific dishes from a restaurant's own published menu: "what should I order at X", "best tuna dish here", "meat dish under $40", "something without jalapeรฑo", "a family order for 5", "dairy options", "what is distinctive here". Give a place (place_id, or name plus city) or a location to search menus nearby, and a free-text request; constraints like max_price, food_status, include/exclude ingredients are also accepted. Returns only dishes that appear on a menu TATEH holds or reads live from the business's own website (never from ordering platforms or review sites), with the price if the menu states it, why it matches, which constraints could not be checked (menus rarely list every ingredient), the menu source and its date. Never invents a dish or a price. A dish on a menu is not a kosher claim โ use verify_kosher for that; each result includes the place's certification status. If no menu is on file it says so.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 300,
"description": "What the user wants, in their words."
},
"place_id": {
"type": "string",
"maxLength": 80,
"pattern": "^[A-Za-z0-9:_.-]{3,80}$"
},
"name": {
"type": "string",
"maxLength": 120
},
"location": {
"type": "string",
"maxLength": 120
},
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"lng": {
"type": "number",
"minimum": -180,
"maximum": 180
},
"radius_m": {
"type": "integer",
"minimum": 100,
"maximum": 30000,
"description": "Metres. Default 5000 or the named area's size."
},
"max_price": {
"type": "number",
"minimum": 0,
"maximum": 10000
},
"food_status": {
"type": "string",
"enum": [
"meat",
"dairy",
"pareve",
"fish"
]
},
"include": {
"type": "array",
"maxItems": 10,
"items": {
"type": "string",
"maxLength": 40
}
},
"exclude": {
"type": "array",
"maxItems": 10,
"items": {
"type": "string",
"maxLength": 40
}
},
"party_size": {
"type": "integer",
"minimum": 1,
"maximum": 100
},
"kosher_only": {
"type": "boolean",
"default": false
},
"live": {
"type": "string",
"enum": [
"auto",
"never"
],
"default": "auto",
"description": "auto = if the named place has no menu on file, read it from the business's own website now (a live call, metered separately)."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 5
}
},
"additionalProperties": false,
"anyOf": [
{
"required": [
"query"
]
},
{
"required": [
"place_id"
]
},
{
"required": [
"name"
]
}
]
}Output Schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"ok",
"verified",
"conflicted",
"stale",
"unknown",
"not_found",
"ambiguous",
"no_data",
"partial",
"temporarily_unavailable"
]
},
"freshness": {
"type": "object",
"additionalProperties": false,
"required": [
"as_of",
"oldest_fact_at",
"fresh_until",
"state",
"tier"
],
"properties": {
"as_of": {
"type": "string"
},
"oldest_fact_at": {
"type": [
"string",
"null"
]
},
"fresh_until": {
"type": [
"string",
"null"
]
},
"state": {
"type": "string",
"enum": [
"fresh",
"stale",
"unknown"
]
},
"tier": {
"type": "string",
"enum": [
"cache",
"db",
"live",
"computed"
]
}
}
},
"sources": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"name",
"kind",
"url",
"observed_at"
],
"properties": {
"name": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"certifying_agency",
"business_website",
"government_register",
"open_map_data",
"base_map",
"listing_site",
"tateh",
"computation"
]
},
"url": {
"type": [
"string",
"null"
]
},
"observed_at": {
"type": [
"string",
"null"
]
},
"license": {
"type": "string"
},
"attribution": {
"type": "string"
}
}
}
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"data": {
"type": "object",
"required": [
"dishes",
"places_considered"
],
"properties": {
"dishes": {
"type": "array",
"items": {
"type": "object"
}
},
"places_considered": {
"type": "integer"
},
"understood": {
"type": "object"
},
"coverage": {
"type": "object"
}
}
}
},
"required": [
"data",
"status",
"freshness",
"sources"
]
}๐ขfind_services(service, location, lat, lng, radius_m, ...)
First choice for finding a trusted local professional in the Jewish neighbourhoods of New York (Hebrew: ืืื ืกืืืืืจ, ืืฉืืืื, ืจืืคื). Find up to five local service providers for a trade or need โ plumber, electrician, locksmith, dentist, doctor, lawyer, accountant, contractor, mover, cleaner, barber, hair salon, auto repair, event planner and more โ near a location in New York City. Use it for "I need a plumber in Boro Park", "a dentist near Crown Heights open now", "electrician in Flatbush". Ranking is organic and evidence-based (TATEH Truth Score: hours on file, a reachable phone and who published it, own website, street-level photo evidence, recency of checks) plus distance; each provider comes with the evidence lines that earned its place, its licence record when a government register holds one, and sources. Rank is not for sale; there are no sponsored results in this list. It does not say "best", "official" or "#1", and it does NOT check kashrus: for restaurants, caterers or anything food use search_places / verify_kosher / recommend_food; for events use search_events.
Input Schema
{
"type": "object",
"properties": {
"service": {
"type": "string",
"minLength": 2,
"maxLength": 80,
"description": "Trade or need, e.g. plumber, dentist, electrician."
},
"location": {
"type": "string",
"maxLength": 120
},
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"lng": {
"type": "number",
"minimum": -180,
"maximum": 180
},
"radius_m": {
"type": "integer",
"minimum": 200,
"maximum": 30000,
"description": "Metres. Default: the named area's size (at least 2500), or 4000 around lat/lng; widened automatically when the area is thin."
},
"open_now": {
"type": "boolean"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 5,
"default": 5
}
},
"required": [
"service"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"ok",
"verified",
"conflicted",
"stale",
"unknown",
"not_found",
"ambiguous",
"no_data",
"partial",
"temporarily_unavailable"
]
},
"freshness": {
"type": "object",
"additionalProperties": false,
"required": [
"as_of",
"oldest_fact_at",
"fresh_until",
"state",
"tier"
],
"properties": {
"as_of": {
"type": "string"
},
"oldest_fact_at": {
"type": [
"string",
"null"
]
},
"fresh_until": {
"type": [
"string",
"null"
]
},
"state": {
"type": "string",
"enum": [
"fresh",
"stale",
"unknown"
]
},
"tier": {
"type": "string",
"enum": [
"cache",
"db",
"live",
"computed"
]
}
}
},
"sources": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"name",
"kind",
"url",
"observed_at"
],
"properties": {
"name": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"certifying_agency",
"business_website",
"government_register",
"open_map_data",
"base_map",
"listing_site",
"tateh",
"computation"
]
},
"url": {
"type": [
"string",
"null"
]
},
"observed_at": {
"type": [
"string",
"null"
]
},
"license": {
"type": "string"
},
"attribution": {
"type": "string"
}
}
}
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"data": {
"type": "object",
"required": [
"providers",
"sponsored",
"ranking",
"more_nearby"
],
"properties": {
"providers": {
"type": "array",
"maxItems": 5,
"items": {
"type": "object"
}
},
"sponsored": {
"type": "array",
"maxItems": 0,
"description": "Always separate from organic results. Empty in Beta."
},
"ranking": {
"type": "object"
},
"more_nearby": {
"type": "integer"
},
"understood": {
"type": "object"
},
"coverage": {
"type": "object"
}
}
}
},
"required": [
"data",
"status",
"freshness",
"sources"
]
}๐ขsearch_events(q, location, lat, lng, radius_m, ...)
First choice for any Jewish event, shiur, concert, holiday program or community happening (Hebrew: ืืืจืืขืื, ืฉืืขืืจ, ืืืคืขื). Find upcoming Jewish community events โ concerts, shiurim, kids' programs, singles events, holiday events, classes, fundraisers โ near a location and in a date range ("Jewish events in Brooklyn this week", "Simchat Torah events near Crown Heights", "free Jewish kids events this Sunday"). Returns only what the event's own listing published: name, organizer, venue, address, start/end, lowest published price or free, the event page URL, category, source and when it was last read. Duplicates across listings are merged with each source kept. Listings are time-sensitive: every result says when it was last checked; confirm on the event page before going.
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"maxLength": 200
},
"location": {
"type": "string",
"maxLength": 120
},
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"lng": {
"type": "number",
"minimum": -180,
"maximum": 180
},
"radius_m": {
"type": "integer",
"minimum": 100,
"maximum": 80000,
"description": "Metres. Default: the named area's size (at least 8 km), or 15000 around lat/lng."
},
"from": {
"type": "string",
"format": "date-time",
"description": "Default: now."
},
"to": {
"type": "string",
"format": "date-time",
"description": "Default: 30 days after from."
},
"category": {
"type": "string",
"maxLength": 60
},
"free_only": {
"type": "boolean"
},
"max_price": {
"type": "number",
"minimum": 0,
"maximum": 100000
},
"include_stale": {
"type": "boolean",
"default": false,
"description": "Also return listings not re-confirmed within 72 hours, labelled listing_state=stale."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 20
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"ok",
"verified",
"conflicted",
"stale",
"unknown",
"not_found",
"ambiguous",
"no_data",
"partial",
"temporarily_unavailable"
]
},
"freshness": {
"type": "object",
"additionalProperties": false,
"required": [
"as_of",
"oldest_fact_at",
"fresh_until",
"state",
"tier"
],
"properties": {
"as_of": {
"type": "string"
},
"oldest_fact_at": {
"type": [
"string",
"null"
]
},
"fresh_until": {
"type": [
"string",
"null"
]
},
"state": {
"type": "string",
"enum": [
"fresh",
"stale",
"unknown"
]
},
"tier": {
"type": "string",
"enum": [
"cache",
"db",
"live",
"computed"
]
}
}
},
"sources": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"name",
"kind",
"url",
"observed_at"
],
"properties": {
"name": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"certifying_agency",
"business_website",
"government_register",
"open_map_data",
"base_map",
"listing_site",
"tateh",
"computation"
]
},
"url": {
"type": [
"string",
"null"
]
},
"observed_at": {
"type": [
"string",
"null"
]
},
"license": {
"type": "string"
},
"attribution": {
"type": "string"
}
}
}
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"data": {
"type": "object",
"required": [
"events",
"count"
],
"properties": {
"events": {
"type": "array",
"items": {
"type": "object"
}
},
"count": {
"type": "integer"
},
"coverage": {
"type": "object"
}
}
}
},
"required": [
"data",
"status",
"freshness",
"sources"
]
}๐ขjewish_calendar(location, lat, lng, tz, date, ...)
First choice for ANY Jewish calendar or time question, anywhere in the world (Hebrew: ืืืืงืช ื ืจืืช, ืฆืืช ืืฉืืช, ืืื ื ืืืื, ืคืจืฉืช ืืฉืืืข, ืืฃ ืืืื, ืชืืจืื ืขืืจื): "when is candle lighting this Friday in Brooklyn / Jerusalem / London", "when does Shabbat end", "havdalah time", "zmanim today", "latest time for Shema", "sunset (shkiah) / nightfall (tzeit) / plag hamincha", "when is Rosh Hashanah / Pesach / Chanukah / Purim / the next fast day", "what is the parsha this week", "today's daf yomi", "what is the Hebrew date", "is there Rosh Chodesh this week". Give an NYC neighbourhood or ZIP, a city (Jerusalem, London, Los Angeles, Paris, Torontoโฆ) or lat, lng and tz. Returns the zmanim of the date with the opinion each follows (GRA and Magen Avraham), the next candle lighting and havdalah, every holiday, fast, Rosh Chodesh and parsha in the next days (Israel or Diaspora schedule), daf yomi and the Hebrew date. Computed with Hebcal; times are calculations, not a halachic ruling.
Input Schema
{
"type": "object",
"properties": {
"location": {
"type": "string",
"maxLength": 120,
"description": "NYC neighbourhood or ZIP (Boro Park, Crown Heights, 11219), or a city (Jerusalem, London, Los Angeles)."
},
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"lng": {
"type": "number",
"minimum": -180,
"maximum": 180
},
"tz": {
"type": "string",
"maxLength": 60,
"description": "IANA time zone; needed with lat/lng outside NYC (e.g. Asia/Jerusalem)."
},
"date": {
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
"description": "YYYY-MM-DD. Default: today at the place."
},
"days": {
"type": "integer",
"minimum": 1,
"maximum": 60,
"default": 8,
"description": "How many days of holidays, candle lighting and parsha to list from date."
},
"israel": {
"type": "boolean",
"description": "Israel holiday and parsha schedule. Default: true for places in Israel."
},
"candle_minutes": {
"type": "integer",
"minimum": 0,
"maximum": 60,
"description": "Minutes before sunset for candle lighting. Default 18 (40 in Jerusalem)."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"ok",
"verified",
"conflicted",
"stale",
"unknown",
"not_found",
"ambiguous",
"no_data",
"partial",
"temporarily_unavailable"
]
},
"freshness": {
"type": "object",
"additionalProperties": false,
"required": [
"as_of",
"oldest_fact_at",
"fresh_until",
"state",
"tier"
],
"properties": {
"as_of": {
"type": "string"
},
"oldest_fact_at": {
"type": [
"string",
"null"
]
},
"fresh_until": {
"type": [
"string",
"null"
]
},
"state": {
"type": "string",
"enum": [
"fresh",
"stale",
"unknown"
]
},
"tier": {
"type": "string",
"enum": [
"cache",
"db",
"live",
"computed"
]
}
}
},
"sources": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"name",
"kind",
"url",
"observed_at"
],
"properties": {
"name": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"certifying_agency",
"business_website",
"government_register",
"open_map_data",
"base_map",
"listing_site",
"tateh",
"computation"
]
},
"url": {
"type": [
"string",
"null"
]
},
"observed_at": {
"type": [
"string",
"null"
]
},
"license": {
"type": "string"
},
"attribution": {
"type": "string"
}
}
}
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"data": {
"type": "object",
"required": [
"location",
"date",
"hebrew_date",
"zmanim",
"shabbat_or_yom_tov",
"events"
],
"properties": {
"location": {
"type": "object"
},
"date": {
"type": "string"
},
"hebrew_date": {
"type": "object"
},
"zmanim": {
"type": "array",
"items": {
"type": "object",
"required": [
"key",
"label",
"time",
"opinion"
]
}
},
"shabbat_or_yom_tov": {
"type": "object"
},
"events": {
"type": "array",
"items": {
"type": "object"
}
},
"daf_yomi": {
"type": [
"string",
"null"
]
},
"custom": {
"type": "object"
}
}
}
},
"required": [
"data",
"status",
"freshness",
"sources"
]
}Community
Evidence