KJV Verse MCP
Offline King James Version lookup for AI assistants, as an MCP server. Zero dependencies (Python standard library only), no API key, no network calls, no tracking. The full 1769 KJV text (31,102 verses, 66 books, public domain) ships inside the package (1.3 MB gzipped).
Tools
| Tool | What it does | Example input |
|---|---|---|
get_passage |
Verse, range, cross-chapter range, whole chapter, or several refs joined by ; |
{"reference": "Psalm 23; 1 Cor 13:4-7"} |
search_kjv |
Word / exact-phrase search, optional book filter, total count + first N hits | {"query": "living water", "book": "John"} |
verse_of_the_day |
Deterministic verse for a date (same date → same verse) | {"date": "2026-10-26"} |
list_books |
66 books with chapter counts and testament | {} |
All tools are read-only (readOnlyHint: true) and return both readable text and structuredContent JSON.
Every result is labelled with the reference and "(KJV)" so the assistant can cite it.
Reference parsing understands common abbreviations (Jn, Ps, 1 Cor, I Corinthians, Rev, Song),
: or . separators, en dashes, single-chapter books (Jude 3), and returns clear errors for
references that do not exist (John 22:1 → "John has 21 chapters").
italics option: the KJV prints translator-supplied words in italics (stored as [brackets]).
plain (default) removes the marks, brackets keeps them, markdown renders them as *word*.
Install
Requires Python 3.9+.
pip install . # from this folder (or: pipx install .)
kjv-verse-mcp # speaks MCP over stdio
Claude Desktop / Claude Code / Cursor / VS Code
{
"mcpServers": {
"kjv": { "command": "kjv-verse-mcp" }
}
}
Without installing: {"command": "python3", "args": ["-m", "kjv_verse_mcp"], "cwd": "/path/to/kjv-verse-mcp"}.
Example
You: What does the Bible say about worry? Quote KJV with references.
Assistant (calls
search_kjv {"query":"take no thought"}thenget_passage {"reference":"Matthew 6:33-34; Philippians 4:6-7"}):Matthew 6:34 (KJV): "Take therefore no thought for the morrow: for the morrow shall take thought for the things of itself. Sufficient unto the day is the evil thereof." …
Tests
python3 -m unittest discover -s tests -v # 12 tests: parsing, search, errors, full stdio JSON-RPC session
pip install mcp && python3 tests/sdk_interop.py # optional: drives the server with the official MCP Python SDK client
Notes and limits
- Text: eBible.org
eng-kjv2006(Crosswire), protocanon only (no Apocrypha). Psalm superscriptions are part of verse 1 in this edition (e.g. Psalm 23:1 begins "A Psalm of David."). - Max 200 verses per
get_passagecall; search returns at most 100 hits per call (total count always reported). - Protocol: MCP stdio, protocol versions 2025-06-18 / 2025-03-26 / 2024-11-05 (tested with MCP Python SDK 2.3.0).
License
Code: MIT (see LICENSE). Bible text: public domain (see LICENSE for the UK Crown-patent note).