Metadata-Version: 2.4
Name: widetorah-mcp
Version: 0.1.1
Summary: MCP server for WideTorah — Torah verses, Talmud, Rashi commentary, parashot, and Jewish holidays for Claude, Cursor, and Windsurf
Project-URL: Homepage, https://widetorah.com
Project-URL: Repository, https://github.com/dobestan/widetorah-mcp
Author: WideHoly
License-Expression: MIT
License-File: LICENSE
Keywords: ai-tools,claude,cursor,jewish-holidays,jewish-studies,mcp,model-context-protocol,parashah,rashi,talmud,torah,windsurf
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Religion
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: mcp[cli]<2.0,>=1.0
Description-Content-Type: text/markdown

# widetorah-mcp

[![PyPI](https://img.shields.io/pypi/v/widetorah-mcp)](https://pypi.org/project/widetorah-mcp/)
[![Python](https://img.shields.io/pypi/pyversions/widetorah-mcp)](https://pypi.org/project/widetorah-mcp/)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

MCP server for [WideTorah](https://widetorah.com) -- query Torah verses, Talmud folios, Rashi commentary, weekly parashot, and Jewish holidays directly from Claude, Cursor, and Windsurf. Built on the [Model Context Protocol](https://modelcontextprotocol.io) with 6 tools covering 24 books, 69,616 verses, 2,121 Talmud daf, and 3,901 Rashi entries.

All data is served from the [widetorah.com](https://widetorah.com) REST API -- free, no authentication required, JSON responses with CORS enabled.

> **Explore Torah at [widetorah.com](https://widetorah.com)** -- [Torah](https://widetorah.com/) | [Talmud](https://widetorah.com/talmud/) | [Parashot](https://widetorah.com/parashot/) | [Holidays](https://widetorah.com/holidays/)

## Table of Contents

- [Install](#install)
- [Configure](#configure)
  - [Claude Desktop](#claude-desktop)
  - [Cursor](#cursor)
  - [Windsurf](#windsurf)
- [Tools](#tools)
  - [get_verse](#get_verse)
  - [search_torah](#search_torah)
  - [get_parashah](#get_parashah)
  - [get_talmud_daf](#get_talmud_daf)
  - [get_rashi](#get_rashi)
  - [get_holiday](#get_holiday)
- [What You Can Query](#what-you-can-query)
  - [Torah Text](#torah-text)
  - [Talmud](#talmud)
  - [Rashi Commentary](#rashi-commentary)
  - [Weekly Parashot](#weekly-parashot)
  - [Jewish Holidays](#jewish-holidays)
- [Learn More About Torah](#learn-more-about-torah)
- [WideHoly Scripture Platform](#wideholy-scripture-platform)
- [License](#license)

## Install

```bash
pip install widetorah-mcp
```

Or run directly with uvx (no install needed):

```bash
uvx widetorah-mcp
```

## Configure

### Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "widetorah": {
      "command": "uvx",
      "args": ["widetorah-mcp"]
    }
  }
}
```

### Cursor

Add to `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "widetorah": {
      "command": "uvx",
      "args": ["widetorah-mcp"]
    }
  }
}
```

### Windsurf

Add to `~/.windsurf/mcp.json`:

```json
{
  "mcpServers": {
    "widetorah": {
      "command": "uvx",
      "args": ["widetorah-mcp"]
    }
  }
}
```

## Tools

### get_verse

Get a specific Torah verse by book, chapter, and verse number.

```
get_verse(book="genesis", chapter=1, verse=1, translation="jps-1917")
```

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `book` | `str` | required | Book slug (genesis, exodus, leviticus, numbers, deuteronomy) |
| `chapter` | `int` | required | Chapter number |
| `verse` | `int` | required | Verse number |
| `translation` | `str` | `"jps-1917"` | Translation code |

### search_torah

Search Torah text by keyword or phrase.

```
search_torah(query="covenant", limit=10)
```

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `query` | `str` | required | Search term (e.g. "covenant", "Moses", "Sinai") |
| `limit` | `int` | `10` | Maximum results |

### get_parashah

Get weekly Torah portion (parashah) information.

```
get_parashah(slug="bereshit")
```

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `slug` | `str` | required | Parashah slug (e.g. "bereshit", "noach", "lech-lecha") |

### get_talmud_daf

Get a Talmud folio page by tractate, page number, and side.

```
get_talmud_daf(tractate="berakhot", daf=2, side="a")
```

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `tractate` | `str` | required | Tractate slug (e.g. "berakhot", "shabbat", "pesachim") |
| `daf` | `int` | required | Page number |
| `side` | `str` | `"a"` | Page side -- "a" (amud aleph) or "b" (amud bet) |

### get_rashi

Get Rashi commentary for a Torah chapter.

```
get_rashi(book="genesis", chapter=1)
```

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `book` | `str` | required | Book slug |
| `chapter` | `int` | required | Chapter number |

### get_holiday

Get information about a Jewish holiday or observance.

```
get_holiday(slug="passover")
```

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `slug` | `str` | required | Holiday slug (e.g. "shabbat", "passover", "rosh-hashanah", "yom-kippur") |

## What You Can Query

### Torah Text

The five books of Moses (Chumash) with 69,616 verses across 24 Tanakh books. Query individual verses or search across the entire text with full-text search.

- **5 Books of Moses**: Genesis, Exodus, Leviticus, Numbers, Deuteronomy
- **Translations**: JPS 1917 Tanakh and additional translations
- **Full-text search**: Search by keyword across all Torah text

### Talmud

2,121 daf (folio pages) from the Babylonian Talmud, organized by tractate. Each daf includes amud aleph (side a) and amud bet (side b).

- **63 Tractates**: Berakhot, Shabbat, Eruvin, Pesachim, and more
- **Daf Yomi**: Look up today's page in the daily study cycle

### Rashi Commentary

3,901 entries of Rabbi Shlomo Yitzchaki's (Rashi) commentary on the Torah -- the most widely studied Torah commentary in Jewish tradition, known for its concise explanations of difficult passages.

### Weekly Parashot

54 weekly Torah portions (parashot) that make up the annual Torah reading cycle. Each parashah includes the reading reference, book, and summary.

### Jewish Holidays

Major and minor Jewish holidays and observances including Shabbat, Passover, Rosh Hashanah, Yom Kippur, Sukkot, Hanukkah, Purim, and more. Each holiday includes Hebrew name, category, date, Torah readings, and observance details.

## Learn More About Torah

- **Scripture**: [Torah Books](https://widetorah.com/) | [Parashot](https://widetorah.com/parashot/) | [Talmud](https://widetorah.com/talmud/)
- **Commentary**: [Rashi](https://widetorah.com/talmud/) | [Study Tools](https://widetorah.com/)
- **Calendar**: [Jewish Holidays](https://widetorah.com/holidays/) | [Daf Yomi](https://widetorah.com/talmud/)
- **API**: [REST API Docs](https://widetorah.com/developers/) | [OpenAPI Spec](https://widetorah.com/api/schema/)

## WideHoly Scripture Platform

Part of the [WideHoly](https://wideholy.com) multi-religion scripture platform.

| Site | Domain | Focus |
|------|--------|-------|
| WideBible | [widebible.com](https://widebible.com) | 66 books, 4 translations (KJV, ASV, BBE, YLT), 3,000+ people, 432K cross-references |
| WideQuran | [widequran.com](https://widequran.com) | 114 surahs, hadith collections, tafsir commentary, Quranic figures |
| **WideTorah** | [widetorah.com](https://widetorah.com) | **24 books, 69,616 verses, 2,121 Talmud daf, 3,901 Rashi entries** |
| WideGita | [widegita.com](https://widegita.com) | 18 Gita chapters, Upanishads, Yoga Sutras, Hindu deities |
| WideSutra | [widesutra.com](https://widesutra.com) | Tipitaka, Mahayana sutras, Buddhist figures, core concepts |
| WideHoly | [wideholy.com](https://wideholy.com) | Cross-religion search, verse comparison, religious calendar |

## License

MIT
