Skip to main content

MCP server for WideBible — Bible verse lookup for AI assistants (Claude, Cursor, Windsurf)

Project description

widebible-mcp

PyPI Python License: MIT

MCP server for WideBible -- enables AI assistants to look up Bible verses, search scripture, explore biblical people and places, discover topical verses, follow cross-references, and browse reading plans. Powered by the WideBible REST API with 66 books, 4 public domain translations (KJV, ASV, BBE, YLT), 3,000+ biblical people, 942 geocoded places, and 432K cross-references.

Try the interactive tools at widebible.com -- Books | People | Places | Topics | Timeline

Table of Contents

Install

pip install widebible-mcp

Or run directly without installing:

uvx widebible-mcp

Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "widebible": {
      "command": "uvx",
      "args": ["widebible-mcp"]
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "widebible": {
      "command": "uvx",
      "args": ["widebible-mcp"]
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "widebible": {
      "command": "uvx",
      "args": ["widebible-mcp"]
    }
  }
}

Available Tools

Tool Description Parameters
get_verse Get a Bible verse by reference book (str), chapter (int), verse (int), translation (str, default "kjv")
search_bible Search Bible verses by keyword query (str), limit (int, default 10)
get_person Get information about a biblical person name (str) -- slug like "moses", "david", "paul"
get_place Get information about a biblical place name (str) -- slug like "jerusalem", "bethlehem"
get_topic Get Bible verses about a topic topic (str) -- slug like "love", "faith", "prayer"
get_cross_references Get cross-references for a verse book (str), chapter (int), verse (int)
get_reading_plan Get a reading plan with daily entries slug (str) -- plan identifier

All tools return formatted text optimized for LLM consumption.

Usage Examples

Ask your AI assistant natural language questions:

  • "Look up John 3:16" -- calls get_verse("john", 3, 16)
  • "Search the Bible for verses about forgiveness" -- calls search_bible("forgiveness")
  • "Tell me about Moses" -- calls get_person("moses")
  • "What does the Bible say about Jerusalem?" -- calls get_place("jerusalem")
  • "Find Bible verses about faith" -- calls get_topic("faith")
  • "Show me cross-references for Romans 8:28" -- calls get_cross_references("romans", 8, 28)
  • "What reading plans are available?" -- calls get_reading_plan("bible-in-a-year")

Available translations: KJV (King James Version), ASV (American Standard Version), BBE (Bible in Basic English), YLT (Young's Literal Translation).

Learn More About the Bible

WideHoly Scripture Platform

Part of the WideHoly multi-religion scripture platform.

Site Domain Focus
WideBible widebible.com 66 books, 4 translations (KJV, ASV, BBE, YLT), 3,000+ people, 942 places, 432K cross-references
WideQuran widequran.com 114 surahs, hadith collections, tafsir commentary, Quranic figures
WideTorah widetorah.com Tanakh, 54 parashot, Talmud tractates, Rashi commentary
WideGita widegita.com 18 Gita chapters, Upanishads, Yoga Sutras, Hindu deities
WideSutra widesutra.com Tipitaka, Mahayana sutras, Buddhist figures, core concepts
WideHoly wideholy.com Cross-religion search, verse comparison, religious calendar

Also Available

Platform Package Install
PyPI widebible pip install widebible
npm widebible npm install widebible
Go widebible-go go get github.com/dobestan/widebible-go
Rust widebible cargo add widebible
Ruby widebible gem install widebible
MCP widebible-mcp pip install widebible-mcp

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

widebible_mcp-0.1.1.tar.gz (6.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

widebible_mcp-0.1.1-py3-none-any.whl (7.5 kB view details)

Uploaded Python 3

File details

Details for the file widebible_mcp-0.1.1.tar.gz.

File metadata

  • Download URL: widebible_mcp-0.1.1.tar.gz
  • Upload date:
  • Size: 6.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.11 {"installer":{"name":"uv","version":"0.10.11","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for widebible_mcp-0.1.1.tar.gz
Algorithm Hash digest
SHA256 77a89fe493f04fbc311a2ccdf1a4d9080c6ec8afca30376a054933f052e37bd3
MD5 8f52b93e85162d92e1aa899fc3f62503
BLAKE2b-256 a813ce9fedc0c7d90eaad3b20f01c3353f14f04456bfd6ee9d35da74697ad0f0

See more details on using hashes here.

File details

Details for the file widebible_mcp-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: widebible_mcp-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 7.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.11 {"installer":{"name":"uv","version":"0.10.11","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for widebible_mcp-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 4440120398c7e4e1c0f98e288358a03ad5cc718c7d7321d283f9e3e3aec40606
MD5 37647b020b6eb3443762d529c73ed586
BLAKE2b-256 6f51572099e172d6bc01f4f3e48d15efacf455bd30cd55a550a45fd73df71e36

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page