Spiral gives your agent every tool with one account. Browse the tools →

VS Code · Industry Data

How to Use Sefaria passage text in VS Code

Fetch a cited passage from Sefaria’s Jewish library, with original text and English where available. Use it to check a quotation, read a chapter, or examine the wording behind a commentary.

Prompts to try with Sefaria passage text in VS Code

Copy an example into VS Code, or ask in your own words.

Use Sefaria passage text to retrieve Genesis 1:1-5 and populate the reading component in this project with the original text and available English.

Sefaria passage textVS Code
Try asking
  • Use Sefaria passage text to retrieve Psalm 23 and update the project's reading view to distinguish source wording from our explanatory notes.

  • Use Sefaria passage text to look this up and give me the result as a table. Save the result in ./assets.

  • Pull the latest numbers from Sefaria passage text and tell me what changed since last week.

  • Check Sefaria passage text and summarize what you find in three bullet points.

How to set up Sefaria passage text in VS Code

Pick the way that suits you. Each takes about two minutes.

Use Spiral's MCP server

  1. Add the hosted server

    Use Add to VS Code on the console's Agents & MCP page, or run:

    code --add-mcp '{"name":"spiral","type":"http","url":"https://api.spiral.ai/mcp"}'
  2. Sign in

    VS Code asks you to sign in when it first starts the server: sign in to Spiral and click Authorize. No API key. Run MCP: List Servers from the Command Palette to check that Spiral is running.

Use the Spiral skill

  1. Send VS Code this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use the Spiral CLI

  1. 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

  1. Create an API key

    In the console, under API keys.

  2. Run Sefaria passage text

    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_text",
        "input": {
          "ref": "<ref>"
        }
      }'

Then paste one of the prompts above: VS Code finds Sefaria passage text on Spiral, shows the price and runs it.

Sefaria passage text providers and prices

Spiral runs Sefaria passage text through Alexandria. Open a card for today's price, with every fee included.

AlexandriaIndustry Data

Settings you can ask for

Ask VS Code for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Languageboth, hebrew, or englishboth

both: Hebrew (or Aramaic) source and English side by side; hebrew or english: one side only.

Max segments1 to 1000200

At most this many segments; a whole book or tractate is cut here with truncated true.

Every API field of Sefaria: Hebrew Bible, Jewish commentaries and links (sefaria.org) · Get text is on its tool page: open its card above.

What can you do with Sefaria passage text in VS 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.

Questions about Sefaria passage text in VS Code

Can VS Code use Sefaria passage text?

Yes. Add Spiral to VS Code as an MCP server, and VS Code can find and run Sefaria passage text like any built-in tool.

How much does Sefaria passage text cost in VS 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 VS Code plan is separate.

Do I need an Alexandria account to use Sefaria passage text in VS Code?

No. Spiral runs Sefaria passage text 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 passage text in VS Code?

About two minutes: add the hosted server, then sign in.

Does VS Code wait while Sefaria passage text runs?

Sefaria passage text runs in the background. VS 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.

Get started

Start using Sefaria passage text in VS Code

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into VS Code:

Set up VS Code

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options