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

# How to Use OpenBible cross references in Hermes

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 Hermes

- Every Wednesday, use OpenBible cross references for the next verse in Psalm 23, starting with verse 1, and include five related references in my study brief.
- Every Monday at 9am: use OpenBible cross references to look this up and give me the result as a table.
- 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 Hermes

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

### Use the Spiral skill

1. **Send Hermes 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 Spiral's MCP server

1. **Add the server and sign in**: Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? \[Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.

```bash
hermes mcp add spiral \
  --url https://api.spiral.ai/mcp \
  --auth oauth \
  --connect-timeout 300
```

2. **Check it**: In a chat that was already open, run `/reload-mcp`.

```bash
hermes mcp list
hermes mcp test spiral
```

### 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: Hermes finds OpenBible cross references on Spiral, shows the price and runs it.

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

## 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 Hermes?

Have the next Bible study brief ready before each weekly meeting. Retrieve the assigned passage's source material on schedule and advance through the reading plan chapter by chapter.

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

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

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

## Questions about OpenBible cross references in Hermes

**Can Hermes use OpenBible cross references?**

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

**How much does OpenBible cross references cost in Hermes?**

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

**Do I need an Alexandria account to use OpenBible cross references in Hermes?**

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 Hermes?**

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

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

OpenBible cross references runs in the background. Hermes 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.

