[Integrations](https://spiral.ai/integrations) › [Windsurf](https://spiral.ai/integrations/windsurf) › [Free Use Bible commentary](https://spiral.ai/integrations/windsurf/free-use-bible-commentary)

# How to Use Free Use Bible commentary in Windsurf

Returns published commentary on a Bible passage from AO Lab's collection. Use it to add a commentator's interpretation to a study or sermon draft.

|  |  |
| --- | --- |
| Model | Free Use Bible commentary |
| 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 commentary in Windsurf

- Use Free Use Bible commentary for Romans 8:28-30 and add a commentary panel that identifies the returned source.
- Use Free Use Bible commentary 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 commentary and tell me what changed since last week.
- Check Free Use Bible commentary and summarize what you find in three bullet points.
- Pull the newest data from Free Use Bible commentary and give me the result as a table.

## How to set up Free Use Bible commentary in Windsurf

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

### Use Spiral's MCP server

1. **Add the server**: Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: `~/.config/devin/mcp_config.json` on macOS and Linux, `%APPDATA%\devin\mcp_config.json` on Windows. Add this:

```json
{
  "mcpServers": {
    "spiral": {
      "url": "https://api.spiral.ai/mcp"
    }
  }
}
```

2. **Sign in**: Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

```bash
devin mcp login spiral
```

3. **Check it**: Spiral is listed under This computer in Customize › MCPs. From the terminal:

```bash
devin mcp list
```

### Use the Spiral skill

1. **Send Windsurf 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 commentary**: 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_commentary",
    "input": {
      "commentary": "<commentary>"
    }
  }'
```

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

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

## Free Use Bible commentary tools and prices

- [Free Use Bible API: Bible verses, translations and commentaries (bible.helloao.org) · Get commentary](https://spiral.ai/tools/alexandria/bible-helloao-org/bible/get_commentary) (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. |
| verse_start | 1 to 200 | — | First verse, with book and chapter; omit for the whole chapter. |
| include_book_introduction |  | — | Also return the commentator's introduction to the whole book (can be long). |

## What can you do with Free Use Bible commentary in Windsurf?

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.

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

## Free Use Bible commentary in other agents

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

## More Windsurf guides

- [Canadian Nutrient File nutrient rankings](https://spiral.ai/integrations/windsurf/canadian-nutrient-file-nutrient-rankings)
- [Free Use Bible commentary catalog](https://spiral.ai/integrations/windsurf/free-use-bible-commentary-catalog)
- [Canadian Nutrient File nutrient dictionary](https://spiral.ai/integrations/windsurf/canadian-nutrient-file-nutrient-dictionary)
- [Free Use Bible passage](https://spiral.ai/integrations/windsurf/free-use-bible-passage)
- [Canadian Nutrient File food search](https://spiral.ai/integrations/windsurf/canadian-nutrient-file-food-search)
- [Free Use Bible translation catalog](https://spiral.ai/integrations/windsurf/free-use-bible-translation-catalog)

## Questions about Free Use Bible commentary in Windsurf

**Can Windsurf use Free Use Bible commentary?**

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

**How much does Free Use Bible commentary cost in Windsurf?**

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

**Do I need an Alexandria account to use Free Use Bible commentary in Windsurf?**

No. Spiral runs Free Use Bible commentary 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 commentary in Windsurf?**

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

**Does Windsurf wait while Free Use Bible commentary runs?**

Free Use Bible commentary runs in the background. Windsurf 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.

