# API.Bible — how to use (mcp.ai)

Connect your API.Bible account and use 19 tools for developer tools straight from your AI agent. Connect with your own API key. API.Bible allows developers to integrate Scripture content into their applications or websites for non-commercial purposes.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_api_bible?ms=1787295840000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `api_bible_get_all_books`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/api_bible`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/api_bible/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/api_bible/get/all/books` — Retrieve all books for a specific Bible version. Requires a valid Bible version ID (obtainable from Get Supported Versions). Returns a list of books with their IDs, names, and abbreviations in the Bib
  - body: { bibleId: string }
- `POST https://api.mcp.ai/api/api_bible/get/audio/bible` — Tool to retrieve details of a specific audio Bible by its ID. Use when you need metadata about an audio Bible version.
  - body: { audioBibleId: string }
- `POST https://api.mcp.ai/api/api_bible/get/audio/book` — Tool to retrieve a single audio Book object for a given audio Bible ID and book ID. Use when you need metadata about a specific audio book.
  - body: { bookId: string, audioBibleId: string, include_chapters?: boolean }
- `POST https://api.mcp.ai/api/api_bible/get/audio/chapter` — Tool to retrieve a single audio chapter with mp3 resource URL. Use when you need to fetch audio content for a specific chapter of an audio Bible. The resourceUrl provided in the response is temporary 
  - body: { chapterId: string, audioBibleId: string }
- `POST https://api.mcp.ai/api/api_bible/get/bible` — 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'.
  - body: { bibleId: string }
- `POST https://api.mcp.ai/api/api_bible/get/book` — Tool to retrieve a single Book object for a given Bible version and book ID. Use when you need details about a specific book, optionally including its chapters.
  - body: { bookId: string, bibleId: string, include_chapters?: boolean }
- `POST https://api.mcp.ai/api/api_bible/get/chapter` — Retrieve a complete chapter with all verses from a Bible version. Use when you need to fetch an entire chapter's content including all verses, navigation to adjacent chapters, and copyright informatio
  - body: { bibleId: string, chapterId: string, parallels?: string, content-type?: string, include-notes?: boolean, include-titles?: boolean, include-verse-spans?: boolean, include-verse-numbers?: boolean, include-chapter-numbers?: boolean }
- `POST https://api.mcp.ai/api/api_bible/get/passage` — Retrieve a Bible passage by ID. A passage can represent a chapter, verse, or range of verses. Use when you need to fetch specific scripture content with configurable display options.
  - body: { bibleId: string, parallels?: string, passageId: string, use-org-id?: boolean, content-type?: string, include-notes?: boolean, include-titles?: boolean, include-verse-spans?: boolean, include-verse-numbers?: boolean, include-chapter-numbers?: boolean }
- `POST https://api.mcp.ai/api/api_bible/get/section` — Retrieve detailed content for a Bible section by ID. A section represents a thematic grouping of verses (e.g., 'The Genealogy of Jesus', 'The Sermon on the Mount'). First use Get Sections to obtain se
  - body: { bibleId: string, parallels?: string, sectionId: string, content-type?: string, include-notes?: boolean, include-titles?: boolean, include-verse-spans?: boolean, include-verse-numbers?: boolean, include-chapter-numbers?: boolean }
- `POST https://api.mcp.ai/api/api_bible/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.
  - body: { bookId: string, bibleId: string }
- `POST https://api.mcp.ai/api/api_bible/get/supported/versions` — Retrieve a list of available Bible versions (translations) from API.Bible. Use this tool to: - List all available Bible translations before searching for verses - Find Bible versions by language (e.g.
  - body: { name?: string, language?: string, abbreviation?: string, include_full_details?: boolean }
- `POST https://api.mcp.ai/api/api_bible/get/verse` — Retrieve a specific Bible verse by ID. Use this action when you need to fetch the content of a single verse from a specific Bible version. First use Get Supported Versions to obtain a valid bibleId, t
  - body: { bibleId: string, verseId: string, parallels?: string, use-org-id?: boolean, content-type?: string, include-notes?: boolean, include-titles?: boolean, include-verse-spans?: boolean, include-verse-numbers?: boolean, include-chapter-numbers?: boolean }
- `POST https://api.mcp.ai/api/api_bible/list/audio/bibles` — Tool to retrieve an array of audio Bible objects authorized for the current API Key. Use when you need to discover available audio Bible versions, filter by language, name, or abbreviation.
  - body: { ids?: string, name?: string, bibleId?: string, language?: string, abbreviation?: string, include_full_details?: boolean }
- `POST https://api.mcp.ai/api/api_bible/list/audio/books` — Tool to retrieve all books for a specific audio Bible version. Use when you need to list available audio books for a given audio Bible ID. Returns a list of books with their IDs, names, and abbreviati
  - body: { audioBibleId: string, include_chapters?: boolean, include_chapters_and_sections?: boolean }
- `POST https://api.mcp.ai/api/api_bible/list/audio/chapters` — Tool to retrieve a list of audio chapters for a specific book in an audio Bible version. Use after obtaining the audio Bible ID and book ID to view available audio chapters.
  - body: { bookId: string, audioBibleId: string }
- `POST https://api.mcp.ai/api/api_bible/list/chapter/sections` — Tool to retrieve an array of section objects for a specific chapter in a Bible version. Use after obtaining the Bible and chapter IDs to view sectional breakdown of a chapter.
  - body: { bibleId: string, chapterId: string }
- `POST https://api.mcp.ai/api/api_bible/list/chapters` — Tool to retrieve an array of Chapter objects for a given Bible version and book. Use after obtaining the Bible and book IDs to view all chapters available.
  - body: { bookId: string, bibleId: string }
- `POST https://api.mcp.ai/api/api_bible/list/verses` — Tool to retrieve an array of verses for a specific chapter in a Bible version. Use after obtaining Bible and chapter IDs to get all verses in that chapter.
  - body: { bibleId: string, chapterId: string }
- `POST https://api.mcp.ai/api/api_bible/search/verses` — Search for Bible verses containing specified keywords or passage references. This tool searches within a specific Bible version for verses matching your query. For keyword searches, all keywords must 
  - body: { limit?: integer, query: string, offset?: integer, bible_id: string }

## Example prompts
- "What can I do in API.Bible?"
- "Show me a summary of my API.Bible account"

## More
- Page: https://mcp.ai/api_bible
- Agent spec (llms.txt): https://mcp.ai/api_bible/llms.txt
- Postman collection: https://mcp.ai/api_bible/postman.json