{
  "markdown": "# Bible MCP\n\n[![bible-mcp MCP server](https://glama.ai/mcp/servers/midvash/bible-mcp/badges/card.svg)](https://glama.ai/mcp/servers/midvash/bible-mcp)\n[![bible-mcp MCP score](https://glama.ai/mcp/servers/midvash/bible-mcp/badges/score.svg)](https://glama.ai/mcp/servers/midvash/bible-mcp)\n\n> 🌐 **English** · [Português (BR)](./README.pt-BR.md) · [Español](./README.es.md)\n\nFree, no-key [Model Context Protocol](https://modelcontextprotocol.io) server for\nthe public Bible API. Read scripture across **35+ Bible versions in 9 language\nfamilies** from any MCP client — Claude, Cursor, and anything else that speaks\nMCP. Served from Cloudflare's edge. Powers\n[mcp.midvash.com](https://mcp.midvash.com).\n\n- **No API key, no auth, no signup.** Just point your client at the URL.\n- **HTTP Streamable transport** (stateless JSON-RPC over `POST`).\n- Built on Cloudflare Workers + R2, backed by the same content as\n  [api.midvash.com](https://api.midvash.com).\n- Current MCP catalog: Portuguese, English, Spanish, Hebrew, Latin, French,\n  Italian, Greek, and Portuguese (Portugal) versions.\n\n## Connecting a client\n\nGenerate your personal connection URL at\n[mcp.midvash.com](https://mcp.midvash.com) and add it to your MCP client. URLs\nlook like:\n\n```\nhttps://mcp.midvash.com/mcp/{id}?v=nvi,kjv&lang=pt-br,en\n```\n\n- `v` — comma-separated version slugs to expose (optional; omit for all).\n- `lang` — comma-separated languages to expose (optional; omit for all).\n\nExample (Claude Desktop / `mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"bible\": {\n      \"url\": \"https://mcp.midvash.com/mcp/{id}?v=nvi,kjv&lang=pt-br,en\"\n    }\n  }\n}\n```\n\n## Tools\n\n| Tool | Description |\n|---|---|\n| `get_verse` | Fetch a single verse or a verse range. |\n| `get_chapter` | Fetch a full chapter. |\n| `get_passage` | Fetch a passage from a free-form reference (e.g. \"John 3:16-18\") — the most natural way to cite scripture. |\n| `search_bible` | Search the Bible text for words or an exact phrase, ranked by relevance (BM25) over an FTS5 index. Case- and accent-insensitive, optionally filtered by book or testament. |\n| `compare_passage` | Compare the same passage across multiple Bible versions. |\n| `list_versions` | List available Bible versions/translations. |\n| `list_books` | List the 66 books, optionally filtered by testament. |\n| `search_study` | Search the study library — chapter commentaries, Bible characters, dictionary entries and theology articles — in 9 languages. |\n| `get_commentary` | Fetch the commentary for the chapter a reference points to. All 1,189 chapters, in 9 languages. |\n| `get_cross_references` | Find other passages that relate to a verse, ranked by how widely the link is attested. 343,546 links. |\n| `get_strongs` | Look up a word in Strong's lexicon by number (\"H430\") or by the word itself. 14,197 entries, definitions in 9 languages. |\n\nStudy tools return a summary of up to 500 characters plus a link to the full\narticle on [midvash.com](https://midvash.com).\nBeyond tools, the server exposes **Resources** — `bible://{version}/{book}/{chapter}`\naddresses the text directly — and four study **Prompts**: sermon preparation, a\ndevotional, a word study, and a translation comparison. Book and version\narguments support autocompletion.\n\nTools that return data also return `structuredContent` alongside the Markdown,\nso a client does not have to parse formatted text.\n\n\n## Limits\n\nThe server is public and unauthenticated, so every request is metered:\n\n| Limit | Value |\n|---|---|\n| Tool calls per IP | 60 per minute |\n| JSON-RPC batch size | 5 messages |\n| Aggregate tool calls | 1,200 per minute per Cloudflare location |\n\nA batch costs one unit per `tools/call`, so batching cannot raise the per-IP\nceiling. Tool responses are deterministic and public, so they are cached at the\nedge for 24 hours — a repeated call costs nothing and returns in a fraction of\nthe time.\n\n## Current catalog\n\nThe MCP currently exposes the version catalog compiled in\n[`src/data/versions.ts`](./src/data/versions.ts): 35 versions across the\nlanguage codes `pt-br`, `en`, `es`, `he`, `la`, `fr`, `it`, `gr`, and `pt-pt`.\n\nThe public URL can narrow that catalog per connection:\n\n```\nhttps://mcp.midvash.com/mcp/{id}?v=nvi,kjv&lang=pt-br,en\n```\n\n## Where the data comes from\n\n| Store | Contents |\n|---|---|\n| R2 bucket `bible` | Chapter text, `{version}/{book}/{chapter}.json`, cached at the edge |\n| D1 `midvash-mcp-search` | FTS5 index: 1,224,921 verses and 18,792 study documents |\n\nThe D1 database belongs to this MCP alone. It is a copy, rebuilt by\n[`scripts/seed-mcp-search.sh`](./scripts/seed-mcp-search.sh), and the Worker\nonly ever reads from it. Keeping it separate means the Cloudflare dashboard\nreports this server's usage on its own, and a D1 binding — which grants access\nto an entire database — reaches nothing but public Bible content.\n\nSearch is ranked per version. The five Hebrew texts (WLC, BHS, ALEPPO, MH,\nOSMH) are the exception: SQLite's tokenizer does not strip Hebrew vowel points,\nso those versions are scanned per book instead of ranked, and `search_bible`\nasks for a `book` filter when one of them is used.\n\n## Benchmark\n\nThe Bible MCP landscape has three useful patterns:\n\n| Server | Strengths | What Midvash should learn from it |\n|---|---|---|\n| [`tuxr/bible-mcp`](https://glama.ai/mcp/servers/tuxr/bible-mcp) | Remote-capable lookup, search, navigation, multiple translations, Apocrypha. | Add first-class Bible search and richer navigation helpers. |\n| [`molpass/mcp-bible`](https://glama.ai/mcp/servers/molpass/mcp-bible) | Multi-version lookup, keyword/semantic search, cross-references, word studies, original-language lexicon data. | Add semantic/keyword search, cross-references, and optional study layers. |\n| [`djayatillake/studybible-mcp`](https://glama.ai/mcp/servers/djayatillake/studybible-mcp) | Lexicons, morphology, cross-references, contextual notes, deeper study workflow. | Keep Midvash simple by default, but expose advanced study tools when data is available. |\n| [`ytssamuel/FHL-MCP-Server`](https://glama.ai/mcp/servers/ytssamuel/FHL-MCP-Server) | Strong Chinese Bible study resources, commentaries, original-language analysis, Apocrypha, topical studies. | Treat language communities as first-class audiences, not just translation filters. |\n\nMidvash's edge is simplicity: remote, no key, no account, fast Cloudflare\ndelivery, and an open ecosystem around the reader, API, apps, plugins, and data.\nThe next improvements should preserve that low-friction experience while adding\nthe discovery and study tools users expect from Bible-focused MCP servers.\n\n## Roadmap\n\n- Expand the MCP catalog to match the broader Midvash data/API coverage.\n- Extend the search index to the remaining versions and to the Hebrew, Greek,\n  and Latin texts, which still fall back to a book-scoped scan.\n- Improve `compare_passage` with richer formatting for long passages.\n- Add cross-reference tools powered by\n  [`bible-cross-references`](https://github.com/midvash/bible-cross-references).\n- Add study-oriented tools for original-language, lexicon, and morphology data\n  where reliable open data is available.\n- Add automated tests for reference parsing, catalog filters, and tool calls.\n\n## Development\n\n```bash\nnpm install\nnpm run dev        # wrangler dev (local)\nnpm run typecheck  # tsc --noEmit\n```\n\n## Deployment\n\nDeploys to the Cloudflare Worker `midvash-mcp` (custom domain\n`mcp.midvash.com`) via **GitHub Actions** ([`.github/workflows/deploy.yml`](.github/workflows/deploy.yml)) —\nevery push to `main` is type-checked and deployed automatically. Requires the\nrepository secrets `CLOUDFLARE_API_TOKEN` and `CLOUDFLARE_ACCOUNT_ID`. Manual\ndeploy:\n\n```bash\nnpm run deploy     # npx wrangler deploy\n```\n\n## License\n\n[MIT](./LICENSE) © Midvash\n\n## The Midvash ecosystem\n\nPart of [**Midvash**](https://midvash.com) — a free Bible reading & study platform. Everything is open and interlinks:\n\n| | |\n|---|---|\n| 📖 **Reader (web)** | [midvash.com](https://midvash.com) — 9 languages |\n| 📱 **iOS app** | [midvash.app/ios](https://midvash.app/ios) |\n| 🔌 **API** | [api.midvash.com](https://api.midvash.com) · [`bible-api`](https://github.com/midvash/bible-api) |\n| 🤖 **MCP server** | [mcp.midvash.com](https://mcp.midvash.com) · [`bible-mcp`](https://github.com/midvash/bible-mcp) |\n| 🧩 **WordPress plugin** | [midvash.app/wordpress-plugin](https://midvash.app/wordpress-plugin) · [`bible-wordpress-plugin`](https://github.com/midvash/bible-wordpress-plugin) |\n| 🧩 **EmDash plugin** | [midvash.app/emdash-plugin](https://midvash.app/emdash-plugin) · [`emdash-plugin-bible`](https://github.com/midvash/emdash-plugin-bible) |\n| 🌐 **Chrome extension** | [midvash.app/chrome-extension](https://midvash.app/chrome-extension) · [`bible-chrome-extension`](https://github.com/midvash/bible-chrome-extension) |\n| 📦 **Open data** | [`bible-data`](https://github.com/midvash/bible-data) · [`bible-data-js`](https://github.com/midvash/bible-data-js) · [`bible-cross-references`](https://github.com/midvash/bible-cross-references) |\n\n<sub>Free & open, built by [Midvash](https://midvash.com) · [midvash.com](https://midvash.com) · [midvash.app](https://midvash.app)</sub>\n",
  "bytes": 9188,
  "sha": "7fdd3ea2bf1cd44032697b95dabde366a78692dee7912d46c9be6fadab2feeca",
  "repo_slug": "midvash/bible-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_midvash_bible_fbc868cb/readme"
}