# Bible Study API

Source-backed Bible text API over HTTP and MCP.

Use this service for Bible references, witnesses, textual variants, lexical data, source provenance, source inventories and auditability. It is not a devotional app and it does not generate passage pages.

Primary docs:
- https://bible.grod.es/
- https://bible.grod.es/docs
- https://bible.grod.es/openapi.json
- https://bible.grod.es/llms-full.txt
- https://bible.grod.es/api/skill
- https://bible.grod.es/auth.md

MCP endpoint: https://bible.grod.es/mcp
MCP Server Card: https://bible.grod.es/.well-known/mcp/server-card.json

Commands: study, search, inspect, compare, diff, map, notable, timeline, audit, sources, status.

Caveats: DSS is fragmentary; LXX GreekResources is lemma-level; no full proprietary critical apparatus is shipped; runtime HTTP and MCP calls do not call LLM or embedding APIs.

## Recommended agent workflow
1. Prefer /openapi.json for parameter schemas.
2. Use /docs/commands/{command} for human-readable examples and caveats.
3. Connect MCP clients to https://bible.grod.es/mcp and use /.well-known/mcp/server-card.json for MCP discovery.
4. Use /api/skill for MCP-style operating instructions.
5. Do not crawl raw /api/* responses for passage indexing. Use docs and OpenAPI for discovery.

## Commands

### study
Synthesize a reference, word, entity, topic, or source object through the main bounded aggregator.
HTTP: GET https://bible.grod.es/api/study?depth=2&include_semantic=true&min_confidence_score=0.6&target=Deut+32%3A8
MCP tool: bible_study
CLI: bible study --depth 2 --include-semantic --min-confidence-score 0.6 Deut 32:8
Parameters: target, limit, depth, include_semantic, min_confidence_score

### search
Find text, lexical data, resources, entities, and optional precomputed semantic neighbors.
HTTP: GET https://bible.grod.es/api/search?include_semantic=true&kinds=refs&kinds=lexicon&kinds=resources&query=covenant
MCP tool: bible_search
CLI: bible search --kinds refs,lexicon,resources --include-semantic covenant
Parameters: query, limit, domain, kinds, scope, resource_type, include_semantic, query_vector, query_vector_id

### inspect
Prove claims by inspecting exact objects and source-backed rows.
HTTP: GET https://bible.grod.es/api/inspect?kind=apparatus&provenance=full&raw=true&review_status=any&target=John+7%3A53
MCP tool: bible_inspect
CLI: bible inspect --kind apparatus --provenance full --raw --review-status any John 7:53
Parameters: target, limit, depth, kind, include, provenance, raw, resource_type, min_confidence_score, review_status

### compare
Compare readings across selected sources, witnesses, or traditions.
HTTP: GET https://bible.grod.es/api/compare?include=alignment&include=signals&sources=MT&sources=LXX&target=Deut+32%3A8
MCP tool: bible_compare
CLI: bible compare --sources MT,LXX --include alignment,signals Deut 32:8
Parameters: target, limit, depth, sources, traditions, include, provenance

### diff
Show exact textual changes between two aligned sources or witnesses.
HTTP: GET https://bible.grod.es/api/diff?include=alignment-ops&left=MT&normalize=light&right=LXX&target=Deut+32%3A8
MCP tool: bible_diff
CLI: bible diff --left MT --right LXX --normalize light --include alignment-ops Deut 32:8
Parameters: target, limit, left, right, normalize, include

### map
Map relationships, paths, and neighborhoods with bounded depth.
HTTP: GET https://bible.grod.es/api/map?depth=3&include_semantic=true&kinds=entities&kinds=topics&kinds=refs&max_path_length=5&target=entity%3APaul&view=graph
MCP tool: bible_map
CLI: bible map --depth 3 --view graph --kinds entities,topics,refs --max-path-length 5 --include-semantic entity:Paul
Parameters: target, targets, limit, depth, view, kinds, scope, scope_unit, max_path_length, include_semantic, query_vector, query_vector_id

### notable
Discover notable signals for a target or scope.
HTTP: GET https://bible.grod.es/api/notable?domain=textual&include_semantic=true&min_impact=70&target=Mark+16&view=ranked
MCP tool: bible_notable
CLI: bible notable --view ranked --domain textual --include-semantic --min-impact 70 Mark 16
Parameters: target, scope, limit, view, domain, include_semantic, min_confidence_score, min_impact, strong, resource_type

### timeline
Build chronology for textual, historical, witness, or source events.
HTTP: GET https://bible.grod.es/api/timeline?include=witnesses&include=history&target=John&view=layered
MCP tool: bible_timeline
CLI: bible timeline --view layered --include witnesses,history John
Parameters: target, limit, view, include

### audit
Audit trust: coverage, provenance, gaps, limits, and review status.
HTTP: GET https://bible.grod.es/api/audit?depth=2&include=coverage&provenance=full&scope=corpus
MCP tool: bible_audit
CLI: bible audit --scope corpus --depth 2 --include coverage --provenance full
Parameters: target, scope, limit, depth, include, provenance

### sources
Inventory source provenance, capabilities, and coverage.
HTTP: GET https://bible.grod.es/api/sources?depth=1&kind=ancient_translation&language=grc&sources=LXX
MCP tool: bible_sources
CLI: bible sources --depth 1 --kind ancient_translation --language grc --sources LXX
Parameters: limit, depth, kind, language, status, sources

### status
Report local health, runtime safety, command inventory, and semantic capability.
HTTP: GET https://bible.grod.es/api/status?include=schema&include=semantic&include=sources
MCP tool: bible_status
CLI: bible status --include schema,semantic,sources
Parameters: limit, include