[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Free Use Bible translation catalog](https://spiral.ai/integrations/opencode/free-use-bible-translation-catalog)

# How to Use Free Use Bible translation catalog in opencode

Lists available Bible editions with language information and coverage totals. Use it to find a translation for your audience and check its book coverage before requesting passages.

|  |  |
| --- | --- |
| Model | Free Use Bible translation catalog |
| 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 translation catalog in opencode

- Use Free Use Bible translation catalog to find Spanish editions and populate our project's edition selector with their names and coverage totals.
- Use Free Use Bible translation catalog 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 translation catalog and tell me what changed since last week.
- Check Free Use Bible translation catalog and summarize what you find in three bullet points.
- Pull the newest data from Free Use Bible translation catalog and give me the result as a table.

## How to set up Free Use Bible translation catalog in opencode

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

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

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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 translation catalog**: 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/list_translations",
    "input": {
      "limit": 1
    }
  }'
```

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

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

## Free Use Bible translation catalog tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| limit | 1 to 500 | — | Translations per page, default 50. |
| query |  | — | Case-insensitive text in the id, name, English name or short name (KJV, King James, Berean). |
| cursor |  | — | next_cursor from the previous page. |
| language |  | — | ISO 639-3 code (eng, spa), two-letter code (en, es) or language name in English or as the language writes it (Spanish, English). |
| include_noncommercial |  | — | Also list translations licensed for non-commercial use only (get_passage still refuses them). |

## What can you do with Free Use Bible translation catalog in opencode?

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.

### Choose resources for a course

Review available translations, their language and coverage totals, and the commentary catalog before selecting source works for a course on the Gospel of John.

### Create a guided reading plan

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

## Overview

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

## Free Use Bible translation catalog in other agents

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

## More opencode guides

- [Free Use Bible passage](https://spiral.ai/integrations/opencode/free-use-bible-passage)
- [JPL Horizons object details](https://spiral.ai/integrations/opencode/jpl-horizons-object-details)
- [Free Use Bible commentary catalog](https://spiral.ai/integrations/opencode/free-use-bible-commentary-catalog)
- [JPL Horizons object lookup](https://spiral.ai/integrations/opencode/jpl-horizons-object-lookup)
- [Free Use Bible commentary](https://spiral.ai/integrations/opencode/free-use-bible-commentary)
- [JPL Horizons observer ephemeris](https://spiral.ai/integrations/opencode/jpl-horizons-observer-ephemeris)

## Questions about Free Use Bible translation catalog in opencode

**Can opencode use Free Use Bible translation catalog?**

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

**How much does Free Use Bible translation catalog cost in opencode?**

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

**Do I need an Alexandria account to use Free Use Bible translation catalog in opencode?**

No. Spiral runs Free Use Bible translation catalog 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 translation catalog in opencode?**

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

**Does opencode wait while Free Use Bible translation catalog runs?**

Free Use Bible translation catalog runs in the background. opencode 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.

