[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Free Use Bible passage](https://spiral.ai/integrations/codex/free-use-bible-passage)

# How to Use Free Use Bible passage in Codex

Returns Bible text for a passage in an available translation, with translation footnotes when requested. Use it to check exact wording, quote scripture, or compare how editions render a passage.

|  |  |
| --- | --- |
| Model | Free Use Bible passage |
| Available through | Alexandria |
| Category | Industry Data |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Free Use Bible passage in Codex

- Use Free Use Bible passage to retrieve John 3:16-21 in the BSB and add the returned wording to our project's passage display.
- Use Free Use Bible passage to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Free Use Bible passage and tell me what changed since last week.
- Check Free Use Bible passage and summarize what you find in three bullet points.
- Pull the newest data from Free Use Bible passage and give me the result as a table.

## How to set up Free Use Bible passage in Codex

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

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex 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.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Free Use Bible passage**: One request; the result comes back by polling or a webhook.

```bash
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": "bible-helloao-org/bible/get_passage",
    "input": {
      "book": "<book>"
    }
  }'
```

Then paste one of the prompts above: Codex finds Free Use Bible passage on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/codex

## Free Use Bible passage tools and prices

- [Free Use Bible API: Bible verses, translations and commentaries (bible.helloao.org) · Get passage](https://spiral.ai/tools/alexandria/bible-helloao-org/bible/get_passage) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| book |  | — | Book name, abbreviation or USFM code (John, Jn, JHN, 1 Corinthians, Song of Songs); use with chapter instead of reference. |
| chapter | 1 to 200 | — | Chapter number, with book. |
| reference |  | — | A Bible reference: book name or abbreviation, chapter and optional verse or range, e.g. "John 3:16", "Jn 3:16-18", "1 Cor 13", "Ps 23", "Rom 8:28-9:1", "Gen. 1:1". Single-chapter books take verses directly ("Jude 3"). Use this or book with chapter. |
| verse_end | 1 to 200 | — | Last verse, with verse_start; defaults to verse_start. |
| translation |  | — | Translation id or abbreviation: BSB (default), KJV, WEB, ASV, YLT, Darby, DRA, or an id from list_translations such as spa_bes. Ids are also matched case-insensitively and by short name. |
| verse_start | 1 to 200 | — | First verse, with book and chapter; omit for the whole chapter. |

## What can you do with Free Use Bible passage in Codex?

Build a Bible study view with scripture, published commentary, related references, and resource selectors. Use AO Lab's catalogs to populate choices and keep retrieved text separate from the application's explanations.

### Prepare a sermon research brief

For John 15:1-8, identify available translations and commentaries, retrieve the passage and published interpretation, and collect related references for the preacher to examine.

### Write a small-group study

Build a lesson on James 2:14-26 using an available edition, commentary notes, and related passages. Include the available resource choices so the leader can review the study's sources.

### Build a Bible study application

Populate edition and commentary selectors from the catalogs, display retrieved scripture and commentary separately, and offer related references beside the passage being read.

### Prepare a bilingual study handout

Find available English and Spanish editions for Luke 15, retrieve their wording, and add clearly attributed commentary and related references. List the source works used in the handout.

### Check a devotional's scripture claims

Compare a draft's quotation of Romans 8:28 with the retrieved text, then examine published commentary and related references before revising claims about the passage.

### Create a guided reading plan

Choose an available translation, retrieve each assigned chapter of Philippians, and add related references as optional further reading.

### Research connections across passages

Start with references related to Psalm 23, read the connected passages, and consult published commentary before explaining the relationship in a study note.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Codex guides](https://spiral.ai/integrations/codex)

## Free Use Bible passage in other agents

- [Amp](https://spiral.ai/integrations/amp/free-use-bible-passage)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/free-use-bible-passage)
- [Claude](https://spiral.ai/integrations/claude-desktop/free-use-bible-passage)
- [Claude Code](https://spiral.ai/integrations/claude-code/free-use-bible-passage)
- [Cline](https://spiral.ai/integrations/cline/free-use-bible-passage)
- [Cursor](https://spiral.ai/integrations/cursor/free-use-bible-passage)
- [Devin](https://spiral.ai/integrations/devin/free-use-bible-passage)
- [dots](https://spiral.ai/integrations/dots/free-use-bible-passage)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/free-use-bible-passage)
- [Gemini](https://spiral.ai/integrations/gemini/free-use-bible-passage)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/free-use-bible-passage)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/free-use-bible-passage)
- [goose](https://spiral.ai/integrations/goose/free-use-bible-passage)
- [Grok](https://spiral.ai/integrations/grok/free-use-bible-passage)
- [Grok Build](https://spiral.ai/integrations/grok-build/free-use-bible-passage)
- [Hermes](https://spiral.ai/integrations/hermes/free-use-bible-passage)
- [Instinct](https://spiral.ai/integrations/instinct/free-use-bible-passage)
- [Manus](https://spiral.ai/integrations/manus/free-use-bible-passage)
- [Muse](https://spiral.ai/integrations/muse/free-use-bible-passage)
- [Muse Code](https://spiral.ai/integrations/muse-code/free-use-bible-passage)
- [n8n](https://spiral.ai/integrations/n8n/free-use-bible-passage)
- [Notion](https://spiral.ai/integrations/notion/free-use-bible-passage)
- [OpenClaw](https://spiral.ai/integrations/openclaw/free-use-bible-passage)
- [opencode](https://spiral.ai/integrations/opencode/free-use-bible-passage)
- [Perplexity](https://spiral.ai/integrations/perplexity/free-use-bible-passage)
- [Raycast](https://spiral.ai/integrations/raycast/free-use-bible-passage)
- [VS Code](https://spiral.ai/integrations/vscode/free-use-bible-passage)
- [Windsurf](https://spiral.ai/integrations/windsurf/free-use-bible-passage)
- [Zapier](https://spiral.ai/integrations/zapier/free-use-bible-passage)

## More Codex guides

- [Free Use Bible commentary catalog](https://spiral.ai/integrations/codex/free-use-bible-commentary-catalog)
- [Free Use Bible translation catalog](https://spiral.ai/integrations/codex/free-use-bible-translation-catalog)
- [Free Use Bible commentary](https://spiral.ai/integrations/codex/free-use-bible-commentary)
- [JPL Horizons object details](https://spiral.ai/integrations/codex/jpl-horizons-object-details)
- [Canadian Nutrient File nutrient rankings](https://spiral.ai/integrations/codex/canadian-nutrient-file-nutrient-rankings)
- [JPL Horizons object lookup](https://spiral.ai/integrations/codex/jpl-horizons-object-lookup)

## Questions about Free Use Bible passage in Codex

**Can Codex use Free Use Bible passage?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Free Use Bible passage like any built-in tool.

**How much does Free Use Bible passage cost in Codex?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.

**Do I need an Alexandria account to use Free Use Bible passage in Codex?**

No. Spiral runs Free Use Bible passage on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Free Use Bible passage in Codex?**

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

**Does Codex wait while Free Use Bible passage runs?**

Free Use Bible passage runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

**How large is AO Lab's Bible collection?**

AO Lab advertises 1,505 translations. Its translation catalog reports coverage totals for individual editions, so the collection's size does not establish the book coverage of any particular edition.

**Does OpenBible supply cross references for every verse?**

AO Lab documents 344,799 references covering 29,364 source verses across 66 books. Coverage spans the Bible, but a reference list is not guaranteed for every verse.

**How are related passages ordered?**

AO Lab's OpenBible data stores references for each source verse in descending score order. Read the linked passages to assess the connection rather than treating the ranking as a conclusion about interpretation.

**Can I republish any translation in the collection?**

Each translation has its own license. The source documentation explicitly requires checking the edition's terms, so catalog availability alone does not establish permission to republish it.

**How much text does the underlying source retrieve at once?**

AO Lab's text and commentary content endpoints each retrieve one chapter from a specified book and work. A study spanning several chapters therefore draws on several source chapter files.

