Skip to main content
Glama

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*.

Related MCP server: bible-mcp

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"} then get_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_passage call; 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).

Available Tools

4 tools
get_passageGet KJV verse or passageA
Read-onlyIdempotent

Look up King James Version (1769, public domain) text by reference. Accepts single verses ('John 3:16'), ranges ('1 Cor 13:4-7', 'Gen 1:31-2:3'), whole chapters ('Psalm 23'), and several references separated by ';'. Common abbreviations work (Jn, Ps, 1 Cor, Rev). Max 200 verses per call.

Inputs: reference (required), italics.

list_booksList KJV booksA
Read-onlyIdempotent

The 66 books of the KJV protocanon with chapter counts and testament.

Inputs: no named parameters.

search_kjvSearch the KJVA
Read-onlyIdempotent

Find KJV verses containing a word or exact phrase (case-insensitive). Optional book filter. Returns total match count and up to limit verses in canonical order.

Inputs: query (required), book, limit, whole_word.

verse_of_the_dayKJV verse of the dayA
Read-onlyIdempotent

Deterministic verse for a date (same date always returns the same verse). pool='popular' picks from well-known encouraging verses; pool='all' picks from all 31,102 verses.

Inputs: date, pool.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool targets a clearly distinct access pattern: reference lookup (get_passage), keyword/phrase search (search_kjv), deterministic daily verse (verse_of_the_day), and canonical book metadata (list_books). An agent can pick the right tool from the name alone; the only near-overlap (passage vs. search) is actually a clean reference-vs-content split.

    Naming Consistency5/5

    All names are lowercase snake_case with a verb-first shape (get_, search_, list_) except verse_of_the_day, which is a domain-standard noun phrase but still readable and unambiguous. No mixed casing or vague verbs, so the surface feels uniform.

    Tool Count5/5

    Four tools is a tight, well-scoped surface for a single-translation scripture server — each tool covers a genuinely different query pattern and none is redundant. Nothing feels padded or conspicuously absent at this scale.

    Completeness4/5

    Reference lookup, text search, daily verse, and book listing cover the main workflows for a KJV reader, including ranges and multi-reference lookups. Minor gaps remain: no random-verse tool, no topical/thematic index beyond raw text search, and the 200-verse cap is undocumented as a fallback behavior (e.g., how to page a very long book).

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides comprehensive Biblical research tools including scripture lookup, interlinear Greek/Hebrew data, and Strong's concordance within a Protestant theological framework. It enables AI applications to perform full-text biblical searches, topical studies, and cross-referencing using authoritative theological data.
      4
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to look up Bible verses, search across translations, and compare different versions locally without API keys.
      1
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables semantic search of the KJV Bible and personal knowledge graph for scripture study, notes, prayers, and memory verses, all running locally with no cloud dependencies.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Offline command-line toolkit for biblical study, allowing AI agents to access original-language texts, perform morphological searches, cross-references, and more, with all results traceable to queries.
      55 npm
      7
      MIT