Bible MCP

🌐 English · Português (BR) · Español

Free, no-key Model Context Protocol server for the public Bible API. Read scripture across 35+ Bible versions in 9 language families from any MCP client — Claude, Cursor, and anything else that speaks MCP. Served from Cloudflare's edge. Powers mcp.midvash.com.

• No API key, no auth, no signup. Just point your client at the URL.
• HTTP Streamable transport (stateless JSON-RPC over POST).
• Built on Cloudflare Workers + R2, backed by the same content as api.midvash.com.
• Current MCP catalog: Portuguese, English, Spanish, Hebrew, Latin, French, Italian, Greek, and Portuguese (Portugal) versions.

Connecting a client

Generate your personal connection URL at mcp.midvash.com and add it to your MCP client. URLs look like:

https://mcp.midvash.com/mcp/{id}?v=nvi,kjv&lang=pt-br,en

• v — comma-separated version slugs to expose (optional; omit for all).
• lang — comma-separated languages to expose (optional; omit for all).

Example (Claude Desktop / mcp.json):

{
  "mcpServers": {
    "bible": {
      "url": "https://mcp.midvash.com/mcp/{id}?v=nvi,kjv&lang=pt-br,en"
    }
  }
}

Tools

Study tools return a summary of up to 500 characters plus a link to the full article on midvash.com. Beyond tools, the server exposes Resources — bible://{version}/{book}/{chapter} addresses the text directly — and four study Prompts: sermon preparation, a devotional, a word study, and a translation comparison. Book and version arguments support autocompletion.

Tools that return data also return structuredContent alongside the Markdown, so a client does not have to parse formatted text.

Limits

The server is public and unauthenticated, so every request is metered:

A batch costs one unit per tools/call, so batching cannot raise the per-IP ceiling. Tool responses are deterministic and public, so they are cached at the edge for 24 hours — a repeated call costs nothing and returns in a fraction of the time.

Current catalog

The MCP currently exposes the version catalog compiled in src/data/versions.ts: 35 versions across the language codes pt-br, en, es, he, la, fr, it, gr, and pt-pt.

The public URL can narrow that catalog per connection:

https://mcp.midvash.com/mcp/{id}?v=nvi,kjv&lang=pt-br,en

Where the data comes from

The D1 database belongs to this MCP alone. It is a copy, rebuilt by scripts/seed-mcp-search.sh, and the Worker only ever reads from it. Keeping it separate means the Cloudflare dashboard reports this server's usage on its own, and a D1 binding — which grants access to an entire database — reaches nothing but public Bible content.

Search is ranked per version. The five Hebrew texts (WLC, BHS, ALEPPO, MH, OSMH) are the exception: SQLite's tokenizer does not strip Hebrew vowel points, so those versions are scanned per book instead of ranked, and search_bible asks for a book filter when one of them is used.

Benchmark

The Bible MCP landscape has three useful patterns:

Midvash's edge is simplicity: remote, no key, no account, fast Cloudflare delivery, and an open ecosystem around the reader, API, apps, plugins, and data. The next improvements should preserve that low-friction experience while adding the discovery and study tools users expect from Bible-focused MCP servers.

Roadmap

• Expand the MCP catalog to match the broader Midvash data/API coverage.
• Extend the search index to the remaining versions and to the Hebrew, Greek, and Latin texts, which still fall back to a book-scoped scan.
• Improve compare_passage with richer formatting for long passages.
• Add cross-reference tools powered by bible-cross-references.
• Add study-oriented tools for original-language, lexicon, and morphology data where reliable open data is available.
• Add automated tests for reference parsing, catalog filters, and tool calls.

Development

npm install
npm run dev        # wrangler dev (local)
npm run typecheck  # tsc --noEmit

Deployment

Deploys to the Cloudflare Worker midvash-mcp (custom domain mcp.midvash.com) via GitHub Actions (.github/workflows/deploy.yml) — every push to main is type-checked and deployed automatically. Requires the repository secrets CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID. Manual deploy:

npm run deploy     # npx wrangler deploy

License

MIT © Midvash

The Midvash ecosystem

Part of Midvash — a free Bible reading & study platform. Everything is open and interlinks:

_{Free & open, built by Midvash · midvash.com · midvash.app}