Metadata-Version: 2.4
Name: widebible-mcp
Version: 0.1.1
Summary: MCP server for WideBible — Bible verse lookup for AI assistants (Claude, Cursor, Windsurf)
Project-URL: Homepage, https://widebible.com
Project-URL: Repository, https://github.com/dobestan/widebible-mcp
Author: WideHoly
License-Expression: MIT
License-File: LICENSE
Keywords: ai-tools,bible,bible-api,claude,cursor,kjv,mcp,model-context-protocol,scripture,verse,windsurf
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Religion
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: mcp>=1.0
Description-Content-Type: text/markdown

# widebible-mcp

[![PyPI](https://img.shields.io/pypi/v/widebible-mcp)](https://pypi.org/project/widebible-mcp/)
[![Python](https://img.shields.io/pypi/pyversions/widebible-mcp)](https://pypi.org/project/widebible-mcp/)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

[MCP](https://modelcontextprotocol.io/) server for [WideBible](https://widebible.com) -- 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](https://widebible.com)** -- [Books](https://widebible.com/) | [People](https://widebible.com/people/) | [Places](https://widebible.com/places/) | [Topics](https://widebible.com/topics/) | [Timeline](https://widebible.com/timeline/)

## Table of Contents

- [Install](#install)
- [Configuration](#configuration)
  - [Claude Desktop](#claude-desktop)
  - [Cursor](#cursor)
  - [Windsurf](#windsurf)
- [Available Tools](#available-tools)
- [Usage Examples](#usage-examples)
- [Learn More About the Bible](#learn-more-about-the-bible)
- [WideHoly Scripture Platform](#wideholy-scripture-platform)
- [Also Available](#also-available)
- [License](#license)

## Install

```bash
pip install widebible-mcp
```

Or run directly without installing:

```bash
uvx widebible-mcp
```

## Configuration

### Claude Desktop

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

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

### Cursor

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

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

### Windsurf

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

```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

- **Books**: [Old Testament](https://widebible.com/) | [New Testament](https://widebible.com/)
- **Study**: [People](https://widebible.com/people/) | [Places](https://widebible.com/places/) | [Topics](https://widebible.com/topics/)
- **History**: [Timeline](https://widebible.com/timeline/) | [Glossary](https://widebible.com/glossary/)
- **API**: [REST API Docs](https://widebible.com/developers/) | [OpenAPI Spec](https://widebible.com/api/schema/)

## WideHoly Scripture Platform

Part of the [WideHoly](https://wideholy.com) multi-religion scripture platform.

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

## Also Available

| Platform | Package | Install |
|----------|---------|---------|
| **PyPI** | [widebible](https://pypi.org/project/widebible/) | `pip install widebible` |
| **npm** | [widebible](https://www.npmjs.com/package/widebible) | `npm install widebible` |
| **Go** | [widebible-go](https://pkg.go.dev/github.com/dobestan/widebible-go) | `go get github.com/dobestan/widebible-go` |
| **Rust** | [widebible](https://crates.io/crates/widebible) | `cargo add widebible` |
| **Ruby** | [widebible](https://rubygems.org/gems/widebible) | `gem install widebible` |
| **MCP** | [widebible-mcp](https://pypi.org/project/widebible-mcp/) | `pip install widebible-mcp` |

## License

MIT
