# Sefaria Torah Texts API MCP

> The Sefaria Torah Texts API gives your AI agent direct access to Jewish sacred literature, including the Bible (Torah), Talmud, and other texts. It lets you perform deep textual analysis without manual searching or citation guesswork. You can retrieve specific verses by reference, track daily reading schedules, audit the entire library index, or search across thousands of years of writings using natural language commands.

## Overview
- **Category:** knowledge-management
- **Price:** Free
- **Tags:** digital-library, textual-analysis, religious-studies, open-source, natural-language

## Description

You gotta know what the **Sefaria Torah Texts API** does before you even start querying it. This isn't just a search engine; it gives your AI agent direct, verifiable access to Jewish sacred literature—the Bible (Torah), Talmud, and tons of other texts. Instead of making your agent manually cross-reference dusty books or guessing citations, this server lets it act like a dedicated research assistant that pulls precise data instantly.

**Checking the System First**

Before you run anything complex, you'll want to confirm things are running right. Your agent can use `check_api_status` to immediately verify if the entire **Sefaria Torah Texts API** service is online and available for querying. That way, you don't waste time sending a request that hits a dead end.

**Handling Specific Scripture References**

The biggest thing it does is pull out exact verses. With `get_sacred_text`, your agent pulls the full text and translations for any specific scripture reference—for example, Genesis 1:1. You get both the Hebrew original and the English translation right in one package. This function requires you to specify the exact book and chapter number because it's built for pinpoint accuracy.

**Searching Across Everything**

Need something that isn't tied to a specific verse? Use `search_sacred_texts`. This tool runs a keyword search across the entire scope of the Sefaria library. When you give it phrases or keywords, it doesn't just find one match; it returns multiple relevant passages that align with your query, no matter how far back in history they were written. It searches every single corner of the database.

**Planning Your Study Schedule**

If you're planning a day of study, `get_daily_reading_calendar` pulls today's assigned reading schedule for you. This tells your agent what Parashah or Daf Yomi you should be looking at, helping you keep your learning plan current and organized.

**Understanding the Scope**

Sometimes you just need to know what's available. `list_library_index` lists all the major books, sections, and categories contained within the huge Sefaria database. You can use this to audit the full scope of literature before you start digging in, so you know exactly what corpus your agent is working with.

In short, if your goal is textual analysis that requires precision—whether you're checking the status, pulling a specific verse by its reference, searching across thousands of years of writing, getting today's reading schedule, or auditing the available literature index—this API gives your agent all the tools it needs. It handles all the heavy lifting so you just get the clean data.

## Tools

### check_api_status
Confirms whether the Sefaria API service is currently running and available.

### get_daily_reading_calendar
Retrieves today's assigned reading schedule, including Parashah or Daf Yomi details.

### get_sacred_text
Fetches the full text and translations for a specific scripture reference (e.g., Genesis 1:1).

### list_library_index
Lists all major books, sections, and categories available in the Sefaria database.

### search_sacred_texts
Searches for specified keywords or phrases across the entire depth of the Sefaria library.

## Prompt Examples

**Prompt:** 
```
Get text for 'Genesis 1:1' using Sefaria.
```

**Response:** 
```
I've retrieved the text for Genesis 1:1! In English: "In the beginning God created the heaven and the earth." In Hebrew: "בְּרֵאשִׁית בָּרָא אֱלֹהִים אֵת הַשָּׁמַיִם וְאֵת הָאָרֶץ". Would you like the full chapter metadata or the next verse?
```

**Prompt:** 
```
What is the Daf Yomi for today?
```

**Response:** 
```
I've retrieved the reading calendar for today! The current Daf Yomi is identified as [Tractate and Page]. I can provide the full text and commentary links for this section if you'd like.
```

**Prompt:** 
```
Search for texts about 'justice' in Sefaria.
```

**Response:** 
```
I've identified several passages about justice in the Sefaria library! Notable entries include verses from Deuteronomy and the Prophets. I can provide the full citations and bilingual text for each of these matches.
```

## Capabilities

### Retrieve specific scripture by reference
The agent gets the full text (Hebrew and English) for any verse using its exact book and chapter number.

### Search across all sacred texts
The agent runs a keyword search over Sefaria’s entire library, returning multiple relevant passages that match your query.

### Check today's study schedule
The agent pulls the current reading calendar (Parashah or Daf Yomi) to help you plan your day of study.

### Audit the available literature
The agent lists all books and major categories contained within the Sefaria database for scope checks.

### Verify service status
The agent confirms that the underlying Sefaria API is operational before running any complex queries.

## Use Cases

### Cross-referencing a concept in Talmudic law
A student needs to see how 'justice' was discussed across multiple texts. They ask their agent: 'Search for justice.' The agent runs `search_sacred_texts`, returns dozens of passages, and then uses `get_sacred_text` on the top three hits so the student can compare the context instantly.

### Verifying a citation for an academic paper
A researcher needs to confirm the exact wording of 'In the beginning God created...' The agent runs `get_sacred_text` using 'Genesis 1:1'. The system returns the full, verifiable text in both Hebrew and English, eliminating citation errors.

### Starting a new study cycle
A learner starts their week by asking, 'What's today's reading?' The agent runs `get_daily_reading_calendar`, tells the user the required Parashah, and provides links to that section of text.

### Mapping out a research project scope
Before writing a paper on Jewish law, an educator first asks the agent to `list_library_index`. This action shows them all the available books and categories, helping them narrow their focus from 'everything' to something manageable.

## Benefits

- Citation accuracy is instant. Instead of manually checking books for a verse, `get_sacred_text` pulls the exact text and bilingual version in one go.
- You stop guessing where to start research. Using `list_library_index` gives you an immediate map of thousands of years of literature before you write your first chapter.
- `search_sacred_texts` covers everything. You don't need to know the book or passage; just give it a keyword, and it finds every relevant match across the entire library.
- Study planning is simple. `get_daily_reading_calendar` shows you exactly what reading is due today, keeping your schedule perfectly aligned with traditional study cycles.
- Your workflow stays reliable. The `check_api_status` tool lets your agent confirm that the data source is online before running critical research queries.

## How It Works

The bottom line is that your agent handles all the API calls—you just talk naturally about the texts you need.

1. Subscribe to this server and connect your AI client (Claude, Cursor, etc.) through the MCP framework.
2. Your agent recognizes the available tools. When you ask a question like 'What does Genesis 1:1 say?', it knows it needs to call `get_sacred_text`.
3. The service returns structured data containing the full text, bilingual translations, and metadata for your research.

## Frequently Asked Questions

**How do I find a specific verse using `get_sacred_text`?**
You must provide the exact reference (Book Name and Chapter:Verse), like 'Genesis 1:1'. The tool returns both Hebrew and English text for that single passage.

**Can I search across all books using `search_sacred_texts`?**
Yes, `search_sacred_texts` is designed to query the entire Sefaria library. It doesn't limit results by book or category, giving you a comprehensive match list.

**What does `list_library_index` show me?**
`list_library_index` shows you the scope of the database—all the major books and thematic categories available. It’s like viewing the catalog before you start shopping.

**How do I check if this API is working with `check_api_status`?**
Running `check_api_status` provides a simple confirmation that the Sefaria service endpoint is operational. This prevents your agent from wasting time on failed queries.

**Can I use `get_daily_reading_calendar` for historical data?**
The tool focuses on the current schedule (Parashah or Daf Yomi). If you need past schedules, you'll have to manually provide those dates, as it reads live calendar data.

**Does `get_sacred_text` require an API key or authentication?**
No, it doesn't. The Sefaria service is free and open, meaning your agent only needs to connect to the MCP endpoint. You don't need to manage any credentials for basic text retrieval.

**When I use `get_sacred_text`, how does it handle bilingual data?**
The response always provides both languages in a structured payload. Expect separate fields containing the original Hebrew script and the standard English translation, which simplifies parsing for your AI client.

**Are there rate limits when I use `search_sacred_texts`?**
While the underlying service is open, rapid or excessive querying can trigger temporary rate limitations. For stable performance, implement backoff logic in your agent's workflow to manage query volume.

**Is an API Key required for Sefaria API?**
No. Sefaria provides a free public API for non-commercial use. This server works out of the box without any static credentials required.

**What languages are the texts available in?**
The Sefaria API primarily provides texts in their original Hebrew or Aramaic along with professional English translations.

**Can the agent show the weekly Parashah?**
Yes. The `get_daily_reading_calendar` tool retrieves the official weekly Torah portion (Parashah) and other daily study markers.