BibleGateway Verse of the Day MCP Server

by cmathgit

321 downloads
Not rated
GitHub

About

This is a MCP server for the BibleGateway Verse of the Day (Web Service Only)

Details

Author
cmathgit
Downloads
321
Categories
Other

- Fetches the Verse of the Day from BibleGateway.com daily.
- Supports over 300 translations across dozens of languages.
- Includes multiple standalone Python scripts (KJV, ESV, Spanish, global, etc.).
- All tools accept zero arguments and return structured JSON.
- Free and public – no API key or authentication needed.
- Compatible with Cursor, Roo Code, Cline, and Gemini-CLI.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name BibleGateway Verse of the Day MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Clone the repository, create a Python virtual environment with uv venv, install dependencies (uv add mcp[cli] httpx), then configure your IDE’s MCP settings (mcp.json) with the absolute paths to uv and the project directory. Query your AI agent with natural-language commands like “What is the verse of the day in the King James Version?”

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "biblegateway verse of the day mcp server": {
            "biblegateway-votd": {
                "command": "/ABSOLUTE/PATH/TO/PARENT/FOLDER/uv",
                "args": [
                    "--directory",
                    "/ABSOLUTE/PATH/TO/PARENT/FOLDER/biblegateway-votd-mcp",
                    "run",
                    "biblegateway-votd-basic.py"
                ]
            }
        }
    }
}

McpServers

{
    "biblegateway-votd": {
        "command": "/ABSOLUTE/PATH/TO/PARENT/FOLDER/uv",
        "args": [
            "--directory",
            "/ABSOLUTE/PATH/TO/PARENT/FOLDER/biblegateway-votd-mcp",
            "run",
            "biblegateway-votd-basic.py"
        ]
    }
}

📖 BibleGateway Verse of the Day — MCP Server

> "Thy word is a lamp unto my feet, and a light unto my path." — Psalm 119:105 (KJV) A Model Context Protocol (MCP) server that delivers the daily Word of God — sourced directly from BibleGateway.com — into any MCP-compatible AI development environment. This project was built to make Scripture accessible through modern AI tooling, ensuring that the Gospel of Jesus Christ can reach developers, researchers, and everyday users wherever they work. No API key is required. The BibleGateway VOTD endpoint is a free, publicly accessible web service. ---

✝️ Mission

This server exists not merely as a software utility, but as a vessel for the Great Commission. By integrating the living Word of God into AI-assisted workflows, developers may begin each session anchored in Scripture. Whether used in a personal devotional context or as a reference tool in professional environments, this MCP server ensures that the Gospel of Jesus Christ is never more than one tool-call away — available in over 300 translations across dozens of languages, reaching every nation and tongue. ---

🌍 What This Server Does

Each Python script in this repository is a standalone FastMCP server exposing one or more Bible translation tools. Each tool fetches the Verse of the Day (VOTD) from BibleGateway for a specific Bible version and returns a structured JSON response.

Included Scripts

| Script | Languages / Scope | |---|---| | biblegateway-votd.py | Primary: KJV, NIV, ESV, NLT, Arabic, Japanese, Chinese, Russian, French, and more | | biblegateway-votd-basic.py | Core English translations (KJV, AMP, MSG, CSB, ESV, NIV, NLT) | | biblegateway-votd-english.py | Full English translation suite (40+ versions) | | biblegateway-votd-spanish.py | Spanish translations (RVR, NVI, NTV, etc.) | | biblegateway-votd-alternate-languages.py | Global translations: Arabic, Bulgarian, Bengali, Cherokee, Thai, Ukrainian, Yoruba, and dozens more | ---

⚙️ Installation

This project uses uv for environment and dependency management, following the MCP Quickstart for Server Developers. ``bash

1. Clone the repository

git clone https://github.com/cmathgit/biblegateway-votd-mcp.git

2. Initialize the project

uv init biblegateway-votd-mcp cd biblegateway-votd-mcp

3. Create and activate the virtual environment

uv venv

Windows:

.venv\Scripts\activate

macOS/Linux:

source .venv/bin/activate

4. Install dependencies

uv add mcp[cli] httpx
`

Test a Server Locally

`bash uv run biblegateway-votd.py ` ---

🔧 MCP Configuration

Add the server to your IDE's MCP configuration file (
mcp.json). Supported IDEs include Cursor, Roo Code, Cline, and Gemini-CLI. `json { "mcpServers": { "biblegateway-votd": { "command": "/ABSOLUTE/PATH/TO/uv", "args": [ "--directory", "/ABSOLUTE/PATH/TO/biblegateway-votd-mcp", "run", "biblegateway-votd.py" ] } } } ` > Note for Cursor users: Cursor limits the combined length of server name + tool name to 60 characters. If tools fail to load, abbreviate the server name in mcp.json. > Recommendation: Load only the scripts containing the Bible versions you actively need. Some IDEs cap the total number of registered MCP tools in global context. ---

💬 Usage Examples

Once the server is running, query it through your AI agent using natural language:
` What is the verse of the day in the King James Version? What is the verse of the day in the Nueva Versión Internacional? What is the verse of the day in the bible version with ID: 278? What is the verse of the day in the Pobitro Bible? `` All tools accept zero arguments and return a structured JSON payload from BibleGateway. ---

🔗 References

- BibleGateway VOTD API Documentation - Full Bible Version & ID List - Model Context Protocol Documentation - uv Package Manager ---

📄 License

MIT License — © 2025 Cruz Macias. See LICENSE for details.
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.