developer-toolsapi_key

API.Bible

API.Bible allows developers to integrate Scripture content into their applications or websites for non-commercial purposes.

Verdict

API.Bible gives your team direct access to hundreds of Bible translations and their full text through Switchy. @mention it to search verses, compare translations side-by-side, or pull chapter content into research notes. Writers drafting devotionals, researchers analyzing textual variants, and content teams localizing scripture references get the most value. You'll need an API key from API.Bible (free tier available), and search results return verse text only — no commentary or study notes.

Common use cases

  • Compare translations of a disputed passage
  • Pull sermon text into meeting notes
  • Search topical verses across multiple versions
  • Verify citation accuracy in draft content
  • Catalog books and chapters for curriculum planning

Integration

Vendor
API.Bible
Category
developer-tools
Auth
API_KEY
Tools
6
Composio slug
api_bible

Tools

  • Get All Books

    Tool to retrieve a list of all books in the bible. use when you need a catalog of every biblical book.

  • Get Bible by ID

    Tool to retrieve details of a specific bible version by its id. use when you need full metadata after listing versions. example prompt: 'get metadata for bibleid de4e12af7f28f599-01'.

  • Get Section

    Tool to retrieve detailed content for a single section by id. use after listing sections.

  • Get Sections

    Tool to retrieve a list of sections for a specific book in a bible version. use after obtaining the bible and book ids to view sectional breakdown.

  • Get Supported Bible Versions

    Tool to retrieve supported bible versions. use when you need to list all available bible translations.

  • Search Verses

    Tool to search for verses containing a specified query within a version.

Setup

Setup guide

  1. 11. Visit api.bible and create a free account to generate your API key. 2. In Switchy, open your workspace settings and navigate to the MCP Integrations tab. 3. Click 'Add Integration', select API.Bible from the list, and paste your API key when prompted. 4. Click 'Connect' — Switchy validates the key and confirms the connection. 5. Open any Space and type '@API.Bible list all available bible versions' to test; you should see a catalog of translations (KJV, NIV, ESV, and hundreds more). 6. To invoke a tool, @mention API.Bible in a message, describe what you need (e.g. 'search for verses about faith in the ESV'), and the AI routes your request to the appropriate endpoint.

What teammates see: by default, memories from API.Bible are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

List All Translations

@API.Bible show me all supported bible versions with their language and abbreviation
Open in a Space →

Search Topical Verses

@API.Bible search the ESV for verses containing 'grace' and return the top 10 results with their references
Open in a Space →

Compare Translation Variants

@API.Bible retrieve John 3:16 from the KJV, NIV, and ESV and display them in a comparison table
Open in a Space →

Get Chapter Breakdown

@API.Bible show me all sections in the book of Romans from the NIV translation
Open in a Space →

Fetch Full Passage Text

@API.Bible get the full text of Psalm 23 from the ESV including verse numbers
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@API.Bible search for verses containing 'faith' in the King James Version and summarize the top 5 results

Output

I found 231 verses containing 'faith' in the KJV. Here are the top 5 results: (1) Hebrews 11:1 – 'Now faith is the substance of things hoped for, the evidence of things not seen.' (2) Romans 10:17 – 'So then faith cometh by hearing, and hearing by the word of God.' (3) Galatians 5:22 – 'But the fruit of the Spirit is love, joy, peace, longsuffering, gentleness, goodness, faith.' (4) Ephesians 2:8 – 'For by grace are ye saved through faith; and that not of yourselves: it is the gift of God.' (5) James 2:17 – 'Even so faith, if it hath not works, is dead, being alone.' These verses emphasize faith as foundational to belief and action.

Notes

This example demonstrates the search capability paired with AI summarization. You'll need a valid API key and the correct Bible version ID (e.g., 'de4e12af7f28f599-01' for KJV). Search results vary by query and version; large result sets may require pagination or filtering to avoid rate limits.

Prompt

@API.Bible list all available Bible translations and tell me which ones include the Apocrypha

Output

I retrieved 42 supported Bible versions from API.Bible. Here are translations that include the Apocrypha: (1) New Revised Standard Version (NRSV) – includes deuterocanonical books. (2) Revised Standard Version Catholic Edition (RSVCE) – full Catholic canon. (3) Common English Bible with Apocrypha (CEBA) – includes additional texts. (4) New American Bible Revised Edition (NABRE) – Catholic translation with complete Apocrypha. Most Protestant translations (KJV, NIV, ESV) do not include these books. Let me know if you need section details for any of these versions.

Notes

This example shows the catalog retrieval tool combined with AI filtering logic. The actual list of versions depends on API.Bible's current offerings and may change over time. No write operations occur here, so this is safe for exploratory queries without side effects.

Prompt

@API.Bible get all sections in the book of Psalms from the English Standard Version and count how many are labeled as prayers

Output

I retrieved 150 sections from Psalms in the ESV (Bible ID: '06125adad2d5898a-01'). After reviewing section titles and content metadata, 57 sections are explicitly labeled or thematically identified as prayers (e.g., Psalm 17: 'A Prayer of David', Psalm 86: 'A Prayer of David'). The remaining sections include hymns, laments, and wisdom literature. This breakdown illustrates the diversity of Psalms beyond its common classification as a prayer book.

Notes

This example combines the 'Get Sections' tool with AI analysis to extract thematic patterns. You must first obtain the Bible ID and Book ID before calling this tool. Section metadata quality varies by translation; some versions provide richer annotations than others, affecting classification accuracy.

Use-case deep-dives

Sermon prep for small church staff

When API.Bible beats manual concordance lookup for weekly prep

A 3-person church staff preparing Sunday messages spends 2-3 hours each week cross-referencing verses across translations. API.Bible's search and version tools let them query 20+ translations in seconds instead of flipping between browser tabs. The workflow: search a keyword or phrase, pull matching verses, then use Get Bible by ID to confirm translation metadata before citing. The trade-off: if your team only uses one translation (ESV or NIV), a static reference site is faster. But if you're comparing Greek nuances or preaching to a multilingual congregation, the API key setup pays off by week two. Best for teams that cite 5+ translations per message or run midweek studies where participants bring different Bibles.

Bible app feature development

Why this MCP is the right call for prototyping devotional features

A 2-person dev team building a daily devotional app needs structured Bible content without licensing a full SDK. API.Bible's 6 tools cover the core read path: list versions, get books, retrieve sections, search verses. They can prototype a "verse of the day" feature or topical search in a weekend sprint without negotiating publisher contracts. The catch: if you're shipping a production app with offline reading or custom formatting, you'll hit rate limits and need to cache aggressively or move to a licensed dataset. This MCP shines for MVPs, internal tools, or low-traffic side projects where you need canonical text fast. Once you're serving 10k+ daily users, budget for a commercial license and treat this as the scaffolding layer.

Academic research text mining

When API.Bible works for small-scale biblical corpus analysis

A graduate student analyzing word frequency across Bible translations needs programmatic access to multiple versions without manual copy-paste. API.Bible's Search Verses and Get Sections tools let them pull every occurrence of a Greek loanword (like "agape") across 15 English translations, then export to a spreadsheet for statistical comparison. The workflow is clean for datasets under 5,000 verses—run the search, parse JSON, done. The boundary: if you're analyzing the entire corpus (31k+ verses) or need lemmatized Hebrew/Greek, the API's rate limits and lack of linguistic tagging become friction. For thesis chapters or conference papers with targeted queries (under 100 API calls), this beats scraping BibleGateway. For dissertation-scale work, you want a downloadable corpus with morphological data.

Frequently asked

What does the API.Bible MCP do in Switchy?

It lets your AI assistant search and retrieve Bible verses, chapters, and metadata from hundreds of translations. You can ask for specific passages, compare versions, or search by keyword across different languages. The MCP handles six core operations: listing translations, fetching book catalogs, retrieving sections, and searching verses. Useful for research, content creation, or theological work without leaving your workspace.

Do I need an API.Bible account to use this MCP?

Yes. You need to register at API.Bible and generate an API key. The MCP uses API_KEY authentication, so you'll paste that key into Switchy's connection settings. No OAuth flow or admin permissions required—just the key from your API.Bible dashboard. Free tier limits apply based on API.Bible's rate limits, not Switchy's.

Can the MCP retrieve entire books or just individual verses?

It retrieves sections and verses, not full books in one call. You'll use Get Sections to see a book's structure, then Get Section to pull specific passages. For bulk text, you'll need multiple requests. The Search Verses tool finds matches across a translation, but returns snippets—not complete chapters. If you need a full Bible download, use API.Bible's bulk endpoints directly.

How is this different from just using API.Bible's REST API?

The MCP wraps API.Bible's endpoints so your AI assistant can call them conversationally. Instead of writing curl commands or parsing JSON yourself, you ask "compare John 3:16 in NIV and ESV" and the assistant handles the tool calls. You lose some advanced filtering options, but gain natural-language access. For scripted workflows, stick with the raw API.

Who on the team should connect this MCP?

Anyone who needs Bible text in their prompts. The API key isn't sensitive beyond rate-limit abuse, so you can share one key across the team or have each member use their own. Switchy doesn't enforce role-based access here—if someone can see the workspace, they can use the MCP. Track usage through API.Bible's dashboard if you're on a paid plan.

Data last verified 607 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.