Talmud Scroller

Official8 tools

by GoodTurnStudio · JavaScript

Talmud a few lines a day, explained, with today's Daf Yomi, search and tractates in English.

io.github.GoodTurnStudio/talmud (MCP Server)

The io.github.GoodTurnStudio/talmud MCP server provides “Talmud a few lines a day” content explained in English. It includes today’s Daf Yomi for timely study, along with search capabilities and access to tractates. The server is focused on reading small segments and locating text by topic or tractate.

🛠️ Key Features

“A few lines a day” Talmud explanations
Today’s Daf Yomi
Search
Tractates in English

🚀 Use Cases

Daily Talmud study with short, explained passages
Checking today’s Daf Yomi
Searching within English tractate content
Browsing by tractate

⚡ Developer Benefits

Structured access to Daf Yomi, search, and tractate materials in English

⚠️ Limitations

Scope is limited to Talmud content as described (few lines daily, Daf Yomi, search, tractates in English)

Captured live from the server via tools/list.

get_today

Today's reading, line by line (same as the app shows today). Talmud: daily readings, plans, search and original text lookup; whole books from the Library, read a passage at a time.

Parameters1

date

string

optional

Optional day as YYYY-MM-DD. Defaults to today (UTC).

Raw schema

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Optional day as YYYY-MM-DD. Defaults to today (UTC)."
    }
  },
  "required": [],
  "additionalProperties": false
}

list_readings

All curated daily readings and plans. Talmud: daily readings, plans, search and original text lookup; whole books from the Library, read a passage at a time.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": [],
  "additionalProperties": false
}

get_reading

One reading or plan, line by line. Talmud: daily readings, plans, search and original text lookup; whole books from the Library, read a passage at a time.

Parameters1

string

required

A reading or plan id from list_readings, or a plan name such as "japji" or "The Gita in 18 Days".

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "A reading or plan id from list_readings, or a plan name such as \"japji\" or \"The Gita in 18 Days\"."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

search_readings

Search the curated readings, best match first. Talmud: daily readings, plans, search and original text lookup; whole books from the Library, read a passage at a time.

Parameters1

string

required

Words to search for, for example kindness or Shabbat.

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Words to search for, for example kindness or Shabbat."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

get_talmud_text

Original text of any Talmud page or passage, or a Mishnah such as Pirkei Avot 1:14, from Sefaria.

Parameters1

ref

string

required

A tractate and page, for example "Berakhot 2a", "Bava Metzia 59b" or "Shabbat 31a:6". Spoken forms such as "Bava Metzia page 59 b" also work.

Raw schema

{
  "type": "object",
  "properties": {
    "ref": {
      "type": "string",
      "description": "A tractate and page, for example \"Berakhot 2a\", \"Bava Metzia 59b\" or \"Shabbat 31a:6\". Spoken forms such as \"Bava Metzia page 59 b\" also work."
    }
  },
  "required": [
    "ref"
  ],
  "additionalProperties": false
}

get_card

Today's reading one line at a time, for voice.. Talmud: daily readings, plans, search and original text lookup; whole books from the Library, read a passage at a time.

Parameters3

n	integer	optional	Which card, starting at 1. Defaults to 1.
reading	string	optional	A reading or plan id from list_readings. Defaults to today's reading.
date	string	optional	Optional day as YYYY-MM-DD. Defaults to today (UTC).

Raw schema

{
  "type": "object",
  "properties": {
    "n": {
      "type": "integer",
      "minimum": 1,
      "description": "Which card, starting at 1. Defaults to 1."
    },
    "reading": {
      "type": "string",
      "description": "A reading or plan id from list_readings. Defaults to today's reading."
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "Optional day as YYYY-MM-DD. Defaults to today (UTC)."
    }
  },
  "required": [],
  "additionalProperties": false
}

list_books

The whole books in the Library that can be read a passage at a time. Talmud: daily readings, plans, search and original text lookup; whole books from the Library, read a passage at a time.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": [],
  "additionalProperties": false
}

read_book

Follow next for the next passage; it carries on into the next chapter. Talmud: daily readings, plans, search and original text lookup; whole books from the Library, read a passage at a time.

Parameters4

book	string	required	Book id or title from list_books, for example pirkei-avot, bekhorot.
section	string	optional	Chapter, book, poem, letter or daf to start at, as listed in the book (for example 5, "chapter 2", "havamal", or 10b for the second side of a daf). Defaults to the beginning; Bekhorot defaults to today's Daf Yomi page while the cycle is in it.
n	integer	optional	Passage within the section, starting at 1.
ref	string	optional	Optional: jump straight to a passage by its reference, for example "Havamal 139", "Meditations 4.3", "Gita 2.47", "Iliad 1.5" or "10b". Overrides section and n.

Raw schema

{
  "type": "object",
  "properties": {
    "book": {
      "type": "string",
      "description": "Book id or title from list_books, for example pirkei-avot, bekhorot."
    },
    "section": {
      "type": "string",
      "description": "Chapter, book, poem, letter or daf to start at, as listed in the book (for example 5, \"chapter 2\", \"havamal\", or 10b for the second side of a daf). Defaults to the beginning; Bekhorot defaults to today's Daf Yomi page while the cycle is in it."
    },
    "n": {
      "type": "integer",
      "minimum": 1,
      "description": "Passage within the section, starting at 1."
    },
    "ref": {
      "type": "string",
      "description": "Optional: jump straight to a passage by its reference, for example \"Havamal 139\", \"Meditations 4.3\", \"Gita 2.47\", \"Iliad 1.5\" or \"10b\". Overrides section and n."
    }
  },
  "required": [
    "book"
  ],
  "additionalProperties": false
}

README.md4 KBView on GitHub

goodturn-mcp

Remote MCP servers for 25 free, read-only everyday helpers by Good Turn Studio: money, health, jobs, travel, shopping, halal checks, football and scripture reading. One Cloudflare Worker turns each product's public OpenAPI spec into an MCP server, so any assistant that speaks MCP (Claude, ChatGPT, Alexa+, Cursor, VS Code and others) can use them.

One server per product: https://goodturn-mcp.pages.dev/<slug>/mcp
All products in one: https://goodturn-mcp.pages.dev/all/mcp (tool names start with the product slug)
Streamable HTTP, stateless JSON, MCP 2025-11-25 (and 2025-06-18, 2025-03-26), no sign-in
Every tool is read-only, with a title and annotations (readOnlyHint: true, destructiveHint: false, idempotentHint: true)
Nothing about the user is stored. Privacy: https://goodturn-mcp.pages.dev/privacy

Products

Product	Slug	What it does
Mizan	`mizan`	Shariah screening of US stocks under four standards, halal alternatives, purification, zakat
Halal or Not	`halalornot`	Halal checks for food, ingredients, medicines, stocks, funds and crypto
Fare Deals	`faredeals`	Cheap flights from any city, and the cheapest days to fly
Cheapest Price	`cheapestprice`	The lowest current price for a product, checked live
Spin My Day	`spinmyday`	A whole day out in any city, matched to weather, mood and diet
Cancel My Sub	`cancelmysub`	How to cancel US and UK subscriptions, and what a card charge is
Lower My Bill	`lowermybill`	Call scripts and low-cost plans to lower household bills
Price Drop Back	`pricedropback`	Store price-adjustment rules, deadlines and a claim message
Find My Money	`findmymoney`	Official unclaimed money searches in the US and UK
Supplement Check	`supplementcheck`	Supplement labels and doses against official upper limits
Plate Pal	`platepal`	Calories and nutrition for foods, chain meals and barcodes
Plan My Workout	`planmyworkout`	Workout plans and how to do any exercise
Med Bill Check	`medbillcheck`	US medical bills against Medicare rates, with dispute letters
Appeal My Claim	`appealmyclaim`	US health insurance denials, rights, deadlines and appeal letters
Job Spotter	`jobspotter`	Current US and UK job listings
Sync My Cycle	`syncmycycle`	Likely cycle phase today, with food and workout ideas
Wardrobe Connect	`wardrobeconnect`	Clothes that match a description or a picture
Form Guide	`formguide`	Football form, fixtures, results and tables
Books Like This	`bookslikethis`	Books like one you enjoyed, and screen adaptations
Talmud Scroller	`talmud`	Daily Talmud with Daf Yomi, and tractates in English
Scroll the Gurbani	`gurbani`	Daily Gurbani with English, any Ang or shabad
Gita Scroller	`gita`	Daily Bhagavad Gita verses with English
Scroll the Lore	`lore`	Greek and Norse myth, Homer, Hesiod and the Poetic Edda
Stoic Scroller	`stoics`	Marcus Aurelius, Epictetus and Seneca
Bible Swipe	`bible`	Daily Bible readings and any passage

How it works

build.py reads each product's live openapi.json and writes products.js: one tool per GET operation, named from its operationId, with inputs from its parameters. Descriptions are tidied into plain tool descriptions.
worker.mjs is the MCP server: initialize, tools/list and tools/call, which calls the product's own API and returns its answer. Answers with a say field carry a ready-made summary.
servers.json lists every server for the official MCP Registry (as io.github.GoodTurnStudio/<slug>). The Publish to the MCP Registry workflow logs in with GitHub OIDC and runs publish.py; publish.ps1 does the same from Windows.

Build and test

code

npm install
npm run build          # python3 build.py, then bundle to deploy/_worker.js
npm test               # every product through the worker, against the live APIs
npm run test:live      # every tool through the deployed servers with the MCP SDK client

Deploy deploy/ as a Cloudflare Pages project in advanced mode (_worker.js).

Licence

MIT for this code. Each product's API, data and answers belong to that product and are served under its own terms, linked from its page at https://goodturn-mcp.pages.dev/<slug>.

Install

Tools (8)

get_todaylist_readingsget_readingsearch_readingsget_talmud_textget_cardlist_booksread_book

Remote endpoint

Streamable HTTP

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

url

https://goodturn-mcp.pages.dev/talmud/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "talmud": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://goodturn-mcp.pages.dev/talmud/mcp"
      ]
    }
  }
}

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

io.github.GoodTurnStudio/talmud (MCP Server)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

get_today

list_readings

get_reading

search_readings

get_talmud_text

get_card

list_books

read_book

goodturn-mcp

Products

How it works

Build and test

Licence

Install

Remote endpoint

Related servers