How to Use Sefaria text connections in Claude Code
Find Sefaria’s known connections between a passage and commentary, Talmud, Midrash, or other texts. Use it to discover sources worth reading before choosing a specific commentary or passage.
Prompts to try with Sefaria text connections in Claude Code
Copy an example into Claude Code, or ask in your own words.
Use Sefaria text connections for Exodus 12:2 and build a results table of the returned source citations and categories.
Use Sefaria text connections for Genesis 1:1 and add the returned commentary citations to the project's source picker.
Use Sefaria text connections to look this up and give me the result as a table. Save the result in ./assets.
Pull the latest numbers from Sefaria text connections and tell me what changed since last week.
Check Sefaria text connections and summarize what you find in three bullet points.
How to set up Sefaria text connections in Claude Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
This adds Spiral to the current project. Add --scope user to use it in every project.
claude mcp add --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start claude, type /mcp, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.
Use the Spiral skill
- Send Claude Code this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Sefaria text connections
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "alexandria", "model": "sefaria-org/bible/get_links", "input": { "ref": "<ref>" } }'
Then paste one of the prompts above: Claude Code finds Sefaria text connections on Spiral, shows the price and runs it.
Sefaria text connections providers and prices
Spiral runs Sefaria text connections through Alexandria. Open a card for today's price, with every fee included.
$0.00873 per call.
Settings you can ask for
Ask Claude Code for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Limit | 1 to 200 | 50 | Links per page. |
Every API field of Sefaria: Hebrew Bible, Jewish commentaries and links (sefaria.org) · Get links is on its tool page: open its card above.
What can you do with Sefaria text connections in Claude Code?
Build a study screen that places a cited passage beside commentary and recorded connections. A coding agent can use Sefaria readings to populate the project and preserve the citations behind each explanation.
Prepare a lesson on a biblical passage
Build a lesson around Genesis 1:1-5 using the passage, a named commentary, and connected sources. Give students citations for each reading and questions that distinguish the verse from its interpretation.
Check a Torah essay's sources
Verify quoted verses and commentary against Sefaria, then inspect recorded connections for supporting passages. Flag claims that the retrieved sources do not establish.
Compare interpretations of one verse
Find commentators connected to Genesis 1:1, retrieve selected discussions, and compare them against the verse itself. Present each interpretation with its own citation.
Build a passage study screen
Show a cited passage, a selected commentary, and a list of recorded connections. Keep source wording and the app's explanation visually distinct.
Prepare a weekly study handout
Use an assigned passage list to assemble readings, commentary excerpts, and connected citations for discussion. Check each edition's license before reproducing its wording.
Trace how a passage is interpreted
Start with Exodus 12:2, inspect its recorded connections, and read selected commentary beside the biblical text. Create an annotated reading path that explains what each source contributes.
More on Sefaria text connections and Claude Code
Overview
Sefaria text connections in other agents
Questions about Sefaria text connections in Claude Code
Can Claude Code use Sefaria text connections?
Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Sefaria text connections like any built-in tool.
How much does Sefaria text connections cost in Claude Code?
$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.
Do I need an Alexandria account to use Sefaria text connections in Claude Code?
No. Spiral runs Sefaria text connections on its own Alexandria account. You sign in to Spiral once and never paste a key.
How long does it take to set up Sefaria text connections in Claude Code?
About two minutes: add the hosted server, then sign in.
Does Claude Code wait while Sefaria text connections runs?
Sefaria text connections runs in the background. Claude Code starts the run, checks on it and gives you the json when it's ready.
Does Sefaria cover more than the Hebrew Bible?
Yes. Its library has 14 highest-level categories, including Tanakh, Talmud, and Mishnah, so its texts and connections extend beyond biblical passages.
Is every source available in English?
No. Sefaria can have the original text without a translation, and an available translation can cover only part of a work.
Where do Sefaria's translations come from?
Sefaria distinguishes two sources: community translations and printed editions. Identify which edition you are reading before comparing its wording with another translation.
Can Sefaria's wording change between visits?
Yes. Registered users continually update community translations, so a passage from a community edition can change.
Do Sefaria's connections include every reference to a passage?
The source describes these results as known connections. They show relationships recorded by Sefaria, rather than establishing an exhaustive list of everything written about a passage.
Start using Sefaria text connections in Claude Code
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Claude Code:
set up https://spiral.ai/SKILL.md


