FHL Bible

Provides access to Faith, Hope, Love Bible API resources including verses, original word studies, commentaries, topic studies, and audio resources via MCP.

python

GitHub Stars

python

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "ytssamuel-fhl-mcp-server": {
      "command": "C:\\path\\to\\FHL_MCP_SERVER\\venv\\Scripts\\python.exe",
      "args": [
        "-m",
        "fhl_bible_mcp"
      ],
      "env": {
        "LOG_LEVEL": "INFO",
        "PYTHONPATH": "C:\\path\\to\\FHL_MCP_SERVER\\src",
        "FHL_CACHE_DIR": "C:\\path\\to\\FHL_MCP_SERVER\\.cache"
      }
    }
  }
}

You can access rich Bible study resources via the FHL Bible MCP Server, a Model Context Protocol (MCP) server that exposes a wide range of Bible data and study tools through a consistent interface. This server lets you query verses, explore original word studies, read commentaries, search topics, and more, enabling AI assistants to perform in-depth Bible study workflows efficiently.

How to use

You interact with the server through an MCP client that can start a local stdio server or connect to a remote HTTP MCP endpoint. Start the local server using the provided runtime configuration and then point your MCP client to the server by using the standard MCP connection method described in the setup steps. Once running, you can perform searches, fetch verses, analyze Greek/Hebrew words, retrieve commentaries, and explore topics. Use the client’s prompt templates to craft requests such as querying a verse, looking up a Strong’s dictionary entry, or fetching a topic study.

How to install

Prerequisites: You need Python installed and access to a terminal or command prompt. A virtual environment is recommended to isolate dependencies.

Option A: One-click install (recommended) involves cloning the project, running the installer script, and generating an interactive configuration.

# 1. Download the project
git clone https://github.com/ytssamuel/FHL_MCP_SERVER.git
cd FHL_MCP_SERVER

# 2. Run the one-click installer (Windows)
.\scripts\install.bat

# 2. Run the one-click installer (macOS/Linux)
chmod +x scripts/install.sh
bash scripts/install.sh

# 3. Generate configuration interactively
python scripts/generate_config.py

Option B: Manual install steps if you prefer to set things up yourself.

# 1. Download the project
git clone https://github.com/ytssamuel/FHL_MCP_SERVER.git
cd FHL_MCP_SERVER

# 2. Install dependencies into a virtual environment
# Windows
python -m venv venv
.\venv\Scripts\activate
pip install -e .

# macOS/Linux
python3 -m venv venv
source venv/bin/activate
pip install -e .

Generate or configure the MCP for your AI assistant by running the interactive generator or by manually adding the config shown below in the next section.
Start using the server with your MCP client once the configuration is in place.

Configuration and running the MCP server

The server can be run locally as a stdio MCP endpoint. Use Python from your virtual environment to load the module that exposes the MCP surface. The following examples show how the MCP server can be invoked from a terminal or integrated into your editor’s MCP client.

{
  "mcpServers": {
    "fhl-bible": {
      "command": "C:\\path\\to\\FHL_MCP_SERVER\\venv\\Scripts\\python.exe",
      "args": ["-m", "fhl_bible_mcp"],
      "env": {
        "PYTHONPATH": "C:\\path\\to\\FHL_MCP_SERVER\\src",
        "LOG_LEVEL": "INFO",
        "FHL_CACHE_DIR": "C:\\path\\to\\FHL_MCP_SERVER\\.cache"
      }
    }
  }
}

Windows and macOS/Linux configurations are shown separately to reflect path differences.

Notes on running and environment variables

Ensure you are using the Python executable from your virtual environment, not the system Python. - The environment variables control logging level and the location of cache data for faster startup and repeated queries.

Examples of common tasks

Query a Bible verse from a chosen version.
Look up a Strong’s dictionary entry for a Greek or Hebrew word.
Retrieve a commentary on a specific passage.
Search for a topic and see related verses and study materials.

Available tools

get_bible_verse

Query a specific verse from a chosen Bible version.

get_bible_chapter

Fetch the entire chapter of a specified book and chapter.

search_bible

Search for keywords across the Bible text.

get_word_analysis

Retrieve lexical information and word-level analysis for a verse.

lookup_strongs

Query Strong's dictionary for a Strong's number.

search_by_strongs

Find verses that match a Strong's number.

get_commentary

Retrieve a Bible commentary for a passage.

search_commentary

Search within available commentaries.

get_topic_study

Obtain topic-focused Bible study material.

get_apocrypha_verse

Query apocryphal/deuterocanonical verses.

search_apocrypha

Search apocryphal texts.

list_apocrypha_books

List all apocryphal books supported.

get_apostolic_fathers_verse

Query Apostolic Fathers writings.

search_apostolic_fathers

Search Apostolic Fathers content.

list_apostolic_fathers_books

List all Apostolic Fathers books.

get_footnote

Fetch footnotes for a verse.

search_fhl_articles

Search Faith Hope Love articles with optional content preview.

list_fhl_article_columns

List available article columns for structured results.

list_bible_versions

List all available Bible versions.

list_commentaries

List all available commentaries.

get_book_list

Retrieve the list of Bible books.

get_audio_bible

Get links to audio Bible resources.

Built by

VeilStrat

AI signals for GTM teams