BEREAN.AI Back to site

For Developers

Integrate the only AI biblical research tool backed by a dedicated vector knowledge base.

Unlike generic AI that relies on training data and can hallucinate, BEREAN.AI maintains a dedicated vector database of 2 million indexed scholarly passages. Every answer is grounded in retrieval-augmented generation (RAG) that searches real sources first. The AI never guesses — it searches, retrieves, and cites.

2M+ indexed passages 16+ Bible translations 396K Greek lexicon entries 228K commentary passages 26K+ church father passages 153K Jewish texts 15+ theological traditions

The Vector Knowledge Base

Tier 1 Factual & Linguistic Data

Objective, scholarly data presented as established fact. Includes:

NASB KJV (31,102 verses) ESV Translation Tags Latin Vulgate World English Bible LXX Septuagint ASV, BSB, DRC, LITV, YLT Full LSJ Greek (396K entries) Strong's Greek (5,523) Strong's Hebrew (8,674) BDB Hebrew Lexicon STEPBible Greek/Hebrew Lexicons MACULA Greek & Hebrew syntax MorphGNT morphology morphhb Hebrew morphology STEPBible TAGNT/TAHOT Treasury of Scripture Knowledge (30,321) Easton's Bible Dictionary Smith's Bible Dictionary Hitchcock's Bible Names Torrey's Topical Textbook Josephus — Antiquities, Wars, Against Apion Epic of Gilgamesh Code of Hammurabi Enuma Elish Dead Sea Scrolls (1QS, 1QM, 1QpHab, CD, 1QHa, 11QT, 4QMMT, 3Q15) Intertestamental (1 Enoch, Maccabees, Sirach, Tobit, etc.)

Tier 2 Interpretive Sources (always attributed)

Scholarly commentary and theology, always presented with tradition attribution. Includes:

Calvin (45 volumes, CCEL) — Reformed John Gill — Baptist/Reformed Matthew Henry — Puritan JFB — Presbyterian Adam Clarke — Methodist Keil & Delitzsch — Lutheran Chrysostom (NPNF, 5 vols) — Orthodox Rashi — Jewish Rabbinic Ibn Ezra — Jewish Rationalist Ramban — Jewish Kabbalistic Tyndale Open Study Notes — Academic
Aquinas — Summa Theologica (3,118 articles) Calvin — Institutes of the Christian Religion Hodge — Systematic Theology (3 vols)
Babylonian Talmud (153K+ passages) Mishnah (63 tractates) Midrash Rabbah Targum Onkelos & Jonathan Mishneh Torah (Maimonides)
Apostolic Fathers (1 & 2 Clement, Didache, Ignatius, Polycarp, etc.) ANF Vols 1-9 (Justin Martyr, Irenaeus, Tertullian, Origen, etc.) NPNF — Augustine, Chrysostom John of Damascus — Orthodox Faith Athanasius — Select Works
1 Enoch (Book of Enoch) Testament of the Twelve Patriarchs
Nicene Creed Westminster Confession Augsburg Confession Canons of Trent CCC 39 Articles 1689 Baptist Confession Wesley's 25 Articles

REST API

Two modes, both returning structured JSON. Free to use with fair-use limits.

Rate Limit: 20 requests per day per IP address. The limit resets every 24 hours. When you hit the limit, the API returns a clear JSON error message explaining the limit — your integration is not broken. Need higher limits for a production app? Contact [email protected].

POST /api/v1/question

Quick pastoral/theological answer (250-400 words). Best for life questions, doctrine overviews, practical faith guidance.

curl -X POST https://berean.ai/api/v1/question \
  -H "Content-Type: application/json" \
  -d '{"question": "What does the Bible say about anxiety?"}'
POST /api/v1/scholar

Deep academic answer with RAG search across the full vector database. Returns the answer plus source metadata. Best for Greek/Hebrew word studies, cross-tradition theology, exegetical questions.

curl -X POST https://berean.ai/api/v1/scholar \
  -H "Content-Type: application/json" \
  -d '{"question": "What does the Greek word agape mean in John?"}'

Response includes:

{
  "mode": "scholar",
  "question": "What does the Greek word agape mean in John?",
  "answer": "The Greek noun agapē (ἀγάπη) in John...",
  "sources_count": 30,
  "sources": [
    { "tier": 1, "collection": "lexicons", "source": "Thayer's Greek Lexicon", "text": "..." },
    { "tier": 2, "collection": "commentaries", "source": "Calvin", "tradition": "Reformed", "text": "..." }
  ],
  "model": "gemini-3.1-flash-lite",
  "elapsed_ms": 8500
}
GET /api/v1/openapi.json

OpenAPI 3.1 spec for ChatGPT Custom GPT Actions or any OpenAPI-compatible client.

GET /api/v1/info

Basic API information and available modes.

ChatGPT Integration

BEREAN.AI is available as a Custom GPT. Users can access it directly in ChatGPT on any device:

Open in ChatGPT

To build your own Custom GPT using BEREAN.AI, import the OpenAPI spec from https://berean.ai/api/v1/openapi.json in the GPT Builder Actions tab.

MCP Server

A live Model Context Protocol server for Claude Desktop, Cursor, and other MCP-aware AI clients. Streamable HTTP transport at https://berean.ai/mcp.

Available Tools

ask_question — Pastoral/theological answer (250-400 words) grounded in Reformed theology with Scripture references.

scholar_query — Academic research powered by RAG search across 2M+ indexed passages. Returns detailed answers with source citations from lexicons, commentaries, church fathers, Talmud, and more.

search_sources — Search the vector database directly. Returns raw source passages from the knowledge base without generating an AI answer. Useful for getting primary source data.

get_daily_devotion — Today's daily devotion: a Scripture reference, the verse text, and a devotional message. No parameters needed — updated daily.

get_daily_exposition — Today's One Year Bible reading exposition: OT, NT, Psalms, and Proverbs references with a full commentary on the passages. No parameters needed — updated daily.

Connect from Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "berean": {
      "url": "https://berean.ai/mcp"
    }
  }
}

Connect from Cursor

Add to your project's .cursor/mcp.json:

{
  "mcpServers": {
    "berean": {
      "url": "https://berean.ai/mcp"
    }
  }
}

Connect from any MCP client

Point your Streamable HTTP MCP client to:

https://berean.ai/mcp

The server supports session management, SSE streaming, and all standard MCP protocol features. Rate limited to 20 tool calls per day per IP (same as the REST API). Initialize/session requests are not counted against the limit.

Why This Matters

Every AI hallucinates about the Bible. BEREAN.AI doesn't — it searches 2 million indexed passages from real lexicons, commentaries, the Talmud, and manuscripts before answering. When it cites Calvin, it's quoting from an actual embedded copy of Calvin's 45-volume commentary set. When it analyzes Greek morphology, it's pulling from MorphGNT and MACULA word-level syntax data. When it presents the Orthodox perspective, it's drawing from Chrysostom's actual homilies in the NPNF collection. When it discusses rabbinic interpretation, it's searching the Babylonian Talmud, Mishnah, and Midrash from Sefaria.

This isn't a wrapper around ChatGPT. It's a dedicated retrieval-augmented generation pipeline with a curated, multi-tradition scholarly knowledge base that no other biblical AI tool has.