{"name":"Shafeh","version":"2026-10-25.1","description":"Shafeh: the Jewish calendar, the day's learning (Chitas, Rambam, Tehillim), and a library of Tanach, Mishnah, Talmud Bavli, Shulchan Aruch and the siddur.","mcp_endpoint":"https://shafeh.org/mcp","read_only_mcp_endpoint":"https://shafeh.org/mcp/read-only","mcp_tools":[{"name":"today","workflow":"today","read_only":true},{"name":"texts","workflow":"texts","read_only":true},{"name":"calendar","workflow":"calendar","read_only":true},{"name":"learning","workflow":"learning","read_only":false},{"name":"learning_read","workflow":"learning","read_only":true},{"name":"learning_write","workflow":"learning","read_only":false},{"name":"family","workflow":"family","read_only":false},{"name":"family_read","workflow":"family","read_only":true},{"name":"family_write","workflow":"family","read_only":false},{"name":"memorials","workflow":"memorials","read_only":false},{"name":"memorials_read","workflow":"memorials","read_only":true},{"name":"memorials_write","workflow":"memorials","read_only":false}],"rest":{"catalog":"https://shafeh.org/api/v1/agent/catalog","invoke":"https://shafeh.org/api/v1/agent/{workflow}","openapi":"https://shafeh.org/api/v1/agent/openapi.json"},"authentication":{"anonymous":"Open operations (marked requires_sign_in: false) need no token.","preferred":"oauth2_authorization_code_pkce","authorization_server_metadata":"https://shafeh.org/.well-known/oauth-authorization-server","protected_resource_metadata":"https://shafeh.org/.well-known/oauth-protected-resource/mcp","registration":{"dynamic_client_registration":"https://shafeh.org/oauth/register","client_id_metadata_documents":true},"code_challenge_methods":["S256"],"resource":"https://shafeh.org/mcp","manual_callback":"https://shafeh.org/oauth/manual_callback","access_token_lifetime_seconds":3600,"refresh_tokens":"rotated on every use — store the new one","fallback":"personal access token (shafeh_pat_…) created at https://shafeh.org/settings/connections","token_header":"Authorization: Bearer <token>","agent_attribution_header":"X-Agent-Name: <your client name>","idempotency_header":"Idempotency-Key: <unique per write>","sign_in_required_endpoint":"https://shafeh.org/mcp/account"},"workflows":[{"tool":"today","title":"Today","description":"Today's Jewish date, parsha, holidays and the day's learning (Chumash with Rashi, Tehillim, Tanya, Rambam, Hayom Yom), with full Hebrew text, plus zmanim for a place. Examples: \"what's today?\", \"today's Tanya\", \"tonight's Rambam 1 perek\", \"zmanim in Los Angeles tomorrow\".","read_only":true,"operations":[{"operation":"day_overview","title":"Today at a glance","description":"Hebrew date, parsha, holiday and special days, the Omer, multi-day periods, and the references for the day's learning. Add a place for zmanim.","requires_sign_in":false},{"operation":"daily_portion","title":"The day's learning text","description":"Text of one daily cycle: chitas_chumash (the day's aliyah with Rashi), shnayim_mikra (the whole parsha with Onkelos), tehillim (the monthly cycle), chitas_tanya, rambam (3 perakim), rambam_1 (1 perek), daf_yomi (both amudim of the day's daf), sefer_hamitzvos (English translation), hayom_yom. Overview rows indicate text availability and primary text languages.","requires_sign_in":false},{"operation":"zmanim","title":"Zmanim","description":"Halachic times for a date and place (alos, sunrise, latest Shema, chatzos, mincha, plag, candle lighting, shkiah, tzeis).","requires_sign_in":false}]},{"tool":"texts","title":"Texts","description":"Open any text in Shafeh's library by reference: Tanach (with Rashi), Tehillim, Mishnah, Talmud Bavli, Shulchan Aruch / Mishnah Berurah / Kitzur, the siddur, and haftaros. Examples: \"Berachos 2a\", \"Mishnah Avos 1\", \"Tehillim 23\", \"OC 1:1\", \"Mishnah Berurah 25\", \"mincha\".","read_only":true,"operations":[{"operation":"find_ref","title":"Resolve a reference","description":"Turn a free-text reference (\"Berachos 2a\", \"Avos 1:3\", \"OC 25\", \"תהלים כג\") into the exact operation and arguments, without fetching text.","requires_sign_in":false},{"operation":"tanach","title":"Tanach chapter or verse","description":"A chapter (or one verse) of Tanach in vocalized Hebrew. detail=full adds the JPS 1917 English and, for Chumash, Rashi.","requires_sign_in":false},{"operation":"tehillim","title":"Tehillim kapitel","description":"One kapitel of Tehillim (1–150), vocalized. detail=full adds English.","requires_sign_in":false},{"operation":"mishnah","title":"Mishnah perek","description":"A perek of Mishnah (Torat Emet, public domain), or a single mishnah in it.","requires_sign_in":false},{"operation":"shas","title":"Talmud Bavli amud","description":"One amud of Talmud Bavli (William Davidson edition, CC-BY-NC — attribution required, non-commercial).","requires_sign_in":false},{"operation":"rambam","title":"Mishneh Torah perek","description":"One perek of the Rambam's Mishneh Torah, halachos numbered. Slugs are hyphenated English hilchos names (e.g. sabbath, repentance, kings-and-wars).","requires_sign_in":false},{"operation":"halacha_works","title":"Halacha library","description":"The halacha works and their parts (Shulchan Aruch with the Rama, Mishnah Berurah, Shulchan Aruch HaRav, Kitzur) and the Orach Chayim topics.","requires_sign_in":false},{"operation":"halacha_siman","title":"Siman of a halacha work","description":"The se'ifim of one siman (optionally one se'if). The Rama's glosses in the Shulchan Aruch begin with הגה.","requires_sign_in":false},{"operation":"halacha_topic","title":"Halacha by topic","description":"An Orach Chayim topic (e.g. tzitzis, tefillin, shabbos) with the simanim in each work. Fetch a siman's text with halacha_siman.","requires_sign_in":false},{"operation":"davening","title":"Siddur","description":"A tefillah assembled for a date: the right inserts for Rosh Chodesh, fast days, the season and so on are included automatically.","requires_sign_in":false},{"operation":"haftarah","title":"Haftarah","description":"The haftarah for a parsha (this week's if none given), with its text.","requires_sign_in":false}]},{"tool":"calendar","title":"Calendar","description":"Convert dates between the Hebrew and civil calendars, see a month, find multi-day periods (the Three Weeks, the Omer…), and work out a Hebrew birthday or personal Tehillim kapitel from a birth date. Examples: \"15 Shevat 5787\", \"Hebrew date of 2019-03-10\", \"kapitel for someone born 2010-05-02 after sunset\".","read_only":true,"operations":[{"operation":"convert_date","title":"Convert a date","description":"Civil ↔ Hebrew date, with the parsha and any holiday. Give `date` (ISO), or `text` such as \"15 Shevat 5787\", \"ט״ו בשבט\", \"next Shabbos\".","requires_sign_in":false},{"operation":"month","title":"A civil month","description":"Every day of a civil month with its Hebrew date, holidays, parsha and Rosh Chodesh.","requires_sign_in":false},{"operation":"holiday_periods","title":"Multi-day periods","description":"The Three Weeks, the Nine Days, Sefiras HaOmer, Aseres Yemei Teshuva, Chanukah: which are active on a date and when each next falls.","requires_sign_in":false},{"operation":"personal_kapitel","title":"Personal Tehillim kapitel","description":"The kapitel to say by Hebrew age (the year being entered), from a birth date. Nothing is saved.","requires_sign_in":false},{"operation":"hebrew_birthday","title":"Hebrew birthday","description":"The Hebrew date of birth, the next Hebrew birthday, and the Bar/Bas Mitzvah date. Nothing is saved.","requires_sign_in":false}]},{"tool":"learning","title":"My learning","description":"Your learning history, bookmarks (continue where you left off) and preferences. Requires sign-in.","read_only":false,"operations":[{"operation":"me","title":"My account","description":"Who is signed in, what this connection may do, and a summary of learning, bookmarks and preferences.","requires_sign_in":true,"scope":"account:read"},{"operation":"preferences","title":"My preferences","description":"Defaults Shafeh uses for you: nusach, city/location for zmanim, Rambam track, language.","requires_sign_in":true,"scope":"account:read"},{"operation":"update_preferences","title":"Change preferences","description":"Set any of nusach, city (or latitude/longitude/timezone), rambam_track, language, or your name (first_name/last_name — shown when you claim memorial perakim). Unmentioned preferences are kept.","requires_sign_in":true,"scope":"account:write"},{"operation":"history","title":"Learning history","description":"What you've marked learned: the last day per daily track, and recent entries. Filter by track.","requires_sign_in":true,"scope":"learning:read"},{"operation":"mark_learned","title":"Mark learned","description":"Record that a daily portion was learned (e.g. today's Tanya). Shows up in the Shafeh apps too.","requires_sign_in":true,"scope":"learning:write"},{"operation":"unmark_learned","title":"Unmark learned","description":"Undo a mark_learned for a track and date.","requires_sign_in":true,"scope":"learning:write"},{"operation":"bookmarks","title":"Where I'm up to","description":"Your place in each library collection (Mishnayos, Shas, Tanach, Halacha, Rambam).","requires_sign_in":true,"scope":"learning:read"},{"operation":"set_bookmark","title":"Set my place","description":"Remember where you're up to: a reference like \"Berachos 5a\", \"Mishnah Shabbos 3\", \"Kitzur 12\", or a ref from a previous result (e.g. its next_ref).","requires_sign_in":true,"scope":"learning:write"},{"operation":"continue","title":"Continue learning","description":"Open the text where you're up to in a collection (or your most recent one). After learning it, call set_bookmark with its next_ref.","requires_sign_in":true,"scope":"learning:read"}]},{"tool":"family","title":"Family","description":"Your family's Hebrew names and birthdays: everyone's Tehillim kapitel today, upcoming Hebrew birthdays, and names for tefillah. Requires sign-in.","read_only":false,"operations":[{"operation":"list","title":"My family","description":"Everyone saved, with Hebrew birth dates, today's kapitel and tefillah names.","requires_sign_in":true,"scope":"family:read"},{"operation":"kapitels_today","title":"Everyone's kapitel today","description":"The personal Tehillim kapitel for each person (Hebrew age + 1). Open the text with texts → tehillim.","requires_sign_in":true,"scope":"family:read"},{"operation":"upcoming_birthdays","title":"Upcoming Hebrew birthdays","description":"Hebrew birthdays in the coming days (default 60), with the age being reached and Bar/Bas Mitzvahs.","requires_sign_in":true,"scope":"family:read"},{"operation":"tefillah_names","title":"Names for tefillah","description":"\"Ploni ben Plonis\" names for Tehillim or a Mi Shebeirach. Add extra names (e.g. cholim) for this list only.","requires_sign_in":true,"scope":"family:read"},{"operation":"add_or_update_member","title":"Add or update someone","description":"Save a family member (or your own details with relation self). Updates instead of duplicating when the same name and birth date are already saved; pass id to edit a specific person. Ask for missing details rather than guessing.","requires_sign_in":true,"scope":"family:write"},{"operation":"remove_member","title":"Remove someone","description":"Delete a saved family member. Returns a preview to confirm first.","requires_sign_in":true,"scope":"family:write","requires_review":true}]},{"tool":"memorials","title":"Learn in memory","description":"Mishnayos memorials: see progress, claim perakim and check off mishnayos. Viewing is open; claiming requires sign-in.","read_only":false,"operations":[{"operation":"list","title":"Memorials","description":"Published memorials, newest first; search by the niftar's name.","requires_sign_in":false},{"operation":"view","title":"A memorial","description":"One memorial: dedication, deadline, progress and who is learning what.","requires_sign_in":false},{"operation":"remaining","title":"Open perakim","description":"Perakim still unclaimed, in Shas order (optionally in one masechet), with the first few suggested.","requires_sign_in":false},{"operation":"stats","title":"Progress","description":"Completion by mishnayos and by words, and the daily pace needed to finish by the deadline.","requires_sign_in":false},{"operation":"mine","title":"My perakim","description":"Everything you've claimed across memorials, with the next mishnah to learn in each.","requires_sign_in":true,"scope":"memorials:read"},{"operation":"claim_perek","title":"Claim a perek","description":"Take one perek to learn for this memorial, under your name. Claiming the same perek again is a no-op.","requires_sign_in":true,"scope":"memorials:write"},{"operation":"claim_many","title":"Claim several perakim","description":"Claim several perakim at once — listed as portions (\"berachos:1\"), or the next `count` open ones (optionally in one masechet). Returns a preview to confirm.","requires_sign_in":true,"scope":"memorials:write","requires_review":true},{"operation":"check_off_mishnah","title":"Check off a mishnah","description":"Mark a mishnah learned in one of your claimed perakim (undo: true to unmark). Without mishnah, the whole perek.","requires_sign_in":true,"scope":"memorials:write"},{"operation":"release_claim","title":"Give back a perek","description":"Release a perek you claimed so someone else can take it. Returns a preview to confirm.","requires_sign_in":true,"scope":"memorials:write","requires_review":true},{"operation":"create_memorial","title":"Start a memorial","description":"Create a public memorial l'ilui nishmas someone, to share so others claim perakim. Returns a preview to confirm. If you started one for the same name recently, that one is returned instead.","requires_sign_in":true,"scope":"memorials:write","requires_review":true}]}],"prompts":[{"name":"todays_learning","title":"Today's learning","description":"Walk through today's Chitas and Rambam."},{"name":"my_kapitel","title":"My Tehillim kapitel","description":"Find and open your kapitel by Hebrew age."},{"name":"tehillim_for_family","title":"Tehillim for my family","description":"Everyone's kapitel today, with the text."},{"name":"learn_in_memory","title":"Learn in memory","description":"Take part in a Mishnayos memorial."},{"name":"explain_ref","title":"Learn a source","description":"Open a source and learn it together."}],"scopes":{"account:read":"See your Shafeh profile and preferences","account:write":"Change your Shafeh preferences","learning:read":"See your learning history and bookmarks","learning:write":"Mark learning done and move your bookmarks","family:read":"See the names and birthdays of your family","family:write":"Add or change your family's names and birthdays","memorials:read":"See your claimed Mishnayos in memorials","memorials:write":"Claim and check off Mishnayos in memorials"},"guides":{"claude":"https://shafeh.org/connect/claude","claude-code":"https://shafeh.org/connect/claude-code","chatgpt":"https://shafeh.org/connect/chatgpt","grok":"https://shafeh.org/connect/grok","muse":"https://shafeh.org/connect/muse","dots":"https://shafeh.org/connect/dots","generic":"https://shafeh.org/connect/generic"},"skills":"https://shafeh.org/skills"}