[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [OpenBible cross references](https://spiral.ai/integrations/opencode/openbible-cross-references)

# How to Use OpenBible cross references in opencode

Returns related Bible references from OpenBible's cross-reference dataset, ordered by relevance score. Use it to find parallel passages and trace connections before reading the referenced text.

|  |  |
| --- | --- |
| Model | OpenBible cross references |
| 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 OpenBible cross references in opencode

- Use OpenBible cross references for Psalm 23:1 and build a related-passages component that preserves the returned order.
- Use OpenBible cross references to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from OpenBible cross references and tell me what changed since last week.
- Check OpenBible cross references and summarize what you find in three bullet points.
- Pull the newest data from OpenBible cross references and give me the result as a table.

## How to set up OpenBible cross references 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 OpenBible cross references**: 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_cross_references",
    "input": {
      "book": "<book>"
    }
  }'
```

Then paste one of the prompts above: opencode finds OpenBible cross references on Spiral, shows the price and runs it.

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

## OpenBible cross references tools and prices

- [Free Use Bible API: Bible verses, translations and commentaries (bible.helloao.org) · Get cross references](https://spiral.ai/tools/alexandria/bible-helloao-org/bible/get_cross_references) (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. |
| limit | 1 to 100 | — | Cross references per verse, highest score first; default 10. |
| chapter | 1 to 200 | — | Chapter number, with book. |
| min_score | -100 to 1000 | — | Keep only references with at least this many net votes. |
| 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. |

## What can you do with OpenBible cross references 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.

### 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 opencode guides](https://spiral.ai/integrations/opencode)

## OpenBible cross references in other agents

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

## More opencode guides

- [NIH 3D model search](https://spiral.ai/integrations/opencode/nih-3d-model-search)
- [STEP Bible lexicon entry](https://spiral.ai/integrations/opencode/step-bible-lexicon-entry)
- [NIH 3D model details](https://spiral.ai/integrations/opencode/nih-3d-model-details)
- [STEP Bible lexicon search](https://spiral.ai/integrations/opencode/step-bible-lexicon-search)
- [NIH 3D collections](https://spiral.ai/integrations/opencode/nih-3d-collections)
- [STEP Bible morphology explanations](https://spiral.ai/integrations/opencode/step-bible-morphology-explanations)

## Questions about OpenBible cross references in opencode

**Can opencode use OpenBible cross references?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run OpenBible cross references like any built-in tool.

**How much does OpenBible cross references 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 OpenBible cross references in opencode?**

No. Spiral runs OpenBible cross references on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up OpenBible cross references in opencode?**

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

**Does opencode wait while OpenBible cross references runs?**

OpenBible cross references 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.

