The API.Bible connector lets your AI agent act in each user's API.Bible account. Each user connects their own API.Bible API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 19 tools.
- Tools
- 19
- What they doRead · write · destructive
- 19 · 0 · 019 read0 write0 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the API.Bible connection
In AgentKit > Connections, create an API.Bible connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'apibible'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize API.Bible:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'apibible_audio_bibles_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "apibible"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize API.Bible:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="apibible_audio_bibles_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their API.Bible credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolapibible_audio_bible_getGet one audio Bible by ID.Read-onlyGet Audio Bible
Get one audio Bible by ID. Returns its name, language, copyright and related text Bible. Use apibible_audio_bibles_list to find the ID.
Inputs
bible_idstringrequired- Bible ID: a 16-character hex code, a dash and a 2-digit version, from apibible_bibles_list. Example: de4e12af7f28f599-02 (King James Version).
apibible_audio_bibles_listList the audio Bibles your key can access, optionally filtered by language, name or related text Bible.Read-onlyList Audio Bibles
List the audio Bibles your key can access, optionally filtered by language, name or related text Bible. Returns each audio Bible's id, name, language and dblId. Use this to find an audio Bible ID for the other audio tools.
Inputs
abbreviationstring- Bible abbreviation to search for. Example: KJV.
idsstring- Comma-separated Bible IDs to return. Example: de4e12af7f28f599-02,9879dbb7cfe39e4d-04.
include_full_detailsboolean- When true, include copyright and promotional details. Example: false.
languagestring- ISO 639-3 three-letter language code to filter by. Example: eng.
namestring- Bible name to search for. Example: King James.
text_bible_idstring- Only audio Bibles related to this text Bible ID. Example: de4e12af7f28f599-02.
apibible_audio_book_getGet one book of an audio Bible.Read-onlyGet Audio Book
Get one book of an audio Bible. Returns the book's id, name and, optionally, chapters. Use apibible_audio_books_list to find book IDs.
Inputs
bible_idstringrequired- Bible ID: a 16-character hex code, a dash and a 2-digit version, from apibible_bibles_list. Example: de4e12af7f28f599-02 (King James Version).
book_idstringrequired- Book ID: the 3-letter USFM book code, from apibible_books_list. Example: JHN for John, GEN for Genesis.
include_chaptersboolean- When true, returns available chapter information for each book. Defaults to false. Example: true.
apibible_audio_books_listList the books of an audio Bible.Read-onlyList Audio Books
List the books of an audio Bible. Returns each book's id, name and, optionally, chapters. Use this to get book IDs for audio chapters.
Inputs
bible_idstringrequired- Bible ID: a 16-character hex code, a dash and a 2-digit version, from apibible_bibles_list. Example: de4e12af7f28f599-02 (King James Version).
include_chaptersboolean- When true, returns available chapter information for each book. Defaults to false. Example: true.
include_chapters_and_sectionsboolean- When true, returns available chapter and section (if available) information for each book. Defaults to false. Example: true.
apibible_audio_chapter_getGet one audio chapter, including a short-lived presigned link to its MP3 file.Read-onlyGet Audio Chapter
Get one audio chapter, including a short-lived presigned link to its MP3 file. Returns the chapter reference, resourceUrl and its expiry time. Use the resourceUrl promptly; it expires.
Inputs
bible_idstringrequired- Bible ID: a 16-character hex code, a dash and a 2-digit version, from apibible_bibles_list. Example: de4e12af7f28f599-02 (King James Version).
chapter_idstringrequired- Chapter ID: book ID, a dot and the chapter number, from apibible_chapters_list. Example: JHN.3.
apibible_audio_chapters_listList the chapters of a book in an audio Bible.Read-onlyList Audio Chapters
List the chapters of a book in an audio Bible. Returns each chapter's id and reference. Use apibible_audio_chapter_get for the audio file link.
Inputs
bible_idstringrequired- Bible ID: a 16-character hex code, a dash and a 2-digit version, from apibible_bibles_list. Example: de4e12af7f28f599-02 (King James Version).
book_idstringrequired- Book ID: the 3-letter USFM book code, from apibible_books_list. Example: JHN for John, GEN for Genesis.
apibible_bible_getGet one Bible version by ID.Read-onlyGet Bible
Get one Bible version by ID. Returns its name, abbreviation, language, countries, copyright and info. Use apibible_bibles_list to find the Bible ID.
Inputs
bible_idstringrequired- Bible ID: a 16-character hex code, a dash and a 2-digit version, from apibible_bibles_list. Example: de4e12af7f28f599-02 (King James Version).
apibible_bibles_listList the Bible versions your API.Bible key can access, optionally filtered by language, abbreviation, name or IDs.Read-onlyList Bibles
List the Bible versions your API.Bible key can access, optionally filtered by language, abbreviation, name or IDs. Returns each Bible's id, name, abbreviation, language and description. Use this first to find a Bible ID for every other tool. Use apibible_bible_get for one Bible's details.
Inputs
abbreviationstring- Bible abbreviation to search for. Example: KJV.
idsstring- Comma-separated Bible IDs to return. Example: de4e12af7f28f599-02,9879dbb7cfe39e4d-04.
include_full_detailsboolean- When true, the returned Bibles will include additional Bible details (e.g. copyright and promo info). Defaults to false. Example: true.
languagestring- ISO 639-3 three-letter language code to filter by. Example: eng.
namestring- Bible name to search for. Example: King James.
apibible_book_getGet one book of a Bible by book ID.Read-onlyGet Book
Get one book of a Bible by book ID. Returns the book's id, name, abbreviation and, optionally, its chapters. Use apibible_books_list to find book IDs.
Inputs
bible_idstringrequired- Bible ID: a 16-character hex code, a dash and a 2-digit version, from apibible_bibles_list. Example: de4e12af7f28f599-02 (King James Version).
book_idstringrequired- Book ID: the 3-letter USFM book code, from apibible_books_list. Example: JHN for John, GEN for Genesis.
include_chaptersboolean- When true, returns available chapter information for each book. Defaults to false. Example: true.
apibible_book_sections_listList the titled sections (story headings) in a book of a Bible, where the Bible has them.Read-onlyList Book Sections
List the titled sections (story headings) in a book of a Bible, where the Bible has them. Returns each section's id, title and first and last verse. Use apibible_section_get to read a section.
Inputs
bible_idstringrequired- Bible ID: a 16-character hex code, a dash and a 2-digit version, from apibible_bibles_list. Example: de4e12af7f28f599-02 (King James Version).
book_idstringrequired- Book ID: the 3-letter USFM book code, from apibible_books_list. Example: JHN for John, GEN for Genesis.
apibible_books_listList the books of a Bible, optionally with their chapters and sections.Read-onlyList Books
List the books of a Bible, optionally with their chapters and sections. Returns each book's id (such as GEN or JHN), name and abbreviation. Use this to get book IDs. Use apibible_bibles_list to find the Bible ID.
Inputs
bible_idstringrequired- Bible ID: a 16-character hex code, a dash and a 2-digit version, from apibible_bibles_list. Example: de4e12af7f28f599-02 (King James Version).
include_chaptersboolean- When true, returns available chapter information for each book. Defaults to false. Example: true.
include_chapters_and_sectionsboolean- When true, returns available chapter and section (if available) information for each book. Defaults to false. Example: true.
apibible_chapter_getGet the full text of one chapter, as html, json or text.Read-onlyGet Chapter
Get the full text of one chapter, as html, json or text. Returns the chapter reference, content, verse count, copyright and next and previous chapter links. Use this to read a whole chapter. Use apibible_passage_get for a verse range and apibible_verse_get for one verse.
Inputs
bible_idstringrequired- Bible ID: a 16-character hex code, a dash and a 2-digit version, from apibible_bibles_list. Example: de4e12af7f28f599-02 (King James Version).
chapter_idstringrequired- Chapter ID: book ID, a dot and the chapter number, from apibible_chapters_list. Example: JHN.3.
content_typestring- Format of the verse content: html, json or text. API.Bible defaults to html. Example: text.one of
htmljsontext include_chapter_numbersboolean- When true, returns chapter numbers in verse content. Defaults to false. Example: true.
include_notesboolean- When true, returns footnotes in verse content. Defaults to false. Example: true.
include_titlesboolean- When true, returns section titles in verse content. Defaults to true. Example: true.
include_verse_numbersboolean- When true, returns verse numbers in verse content. Defaults to true. Example: true.
include_verse_spansboolean- When true, returns spans that wrap verse numbers and verse text in content. Defaults to false. Example: true.
parallelsstring- Comma-separated Bible IDs. When set, the same verses from these Bibles are returned alongside. Example: 9879dbb7cfe39e4d-04.
apibible_chapter_sections_listList the titled sections in one chapter of a Bible.Read-onlyList Chapter Sections
List the titled sections in one chapter of a Bible. Returns each section's id, title and first and last verse. Use apibible_section_get to read a section.
Inputs
bible_idstringrequired- Bible ID: a 16-character hex code, a dash and a 2-digit version, from apibible_bibles_list. Example: de4e12af7f28f599-02 (King James Version).
chapter_idstringrequired- Chapter ID: book ID, a dot and the chapter number, from apibible_chapters_list. Example: JHN.3.
apibible_chapter_verses_listList the verses in a chapter, without their text.Read-onlyList Chapter Verses
List the verses in a chapter, without their text. Returns each verse's id (such as JHN.3.16) and reference. Use this to get verse IDs. Use apibible_chapter_get or apibible_verse_get for the text.
Inputs
bible_idstringrequired- Bible ID: a 16-character hex code, a dash and a 2-digit version, from apibible_bibles_list. Example: de4e12af7f28f599-02 (King James Version).
chapter_idstringrequired- Chapter ID: book ID, a dot and the chapter number, from apibible_chapters_list. Example: JHN.3.
apibible_chapters_listList the chapters of a book in a Bible.Read-onlyList Chapters
List the chapters of a book in a Bible. Returns each chapter's id (such as JHN.3), number and reference. Use this to get chapter IDs for apibible_chapter_get.
Inputs
bible_idstringrequired- Bible ID: a 16-character hex code, a dash and a 2-digit version, from apibible_bibles_list. Example: de4e12af7f28f599-02 (King James Version).
book_idstringrequired- Book ID: the 3-letter USFM book code, from apibible_books_list. Example: JHN for John, GEN for Genesis.
apibible_passage_getGet the text of an arbitrary range of verses, such as JHN.3.16-JHN.3.18, as html, json or text.Read-onlyGet Passage
Get the text of an arbitrary range of verses, such as JHN.3.16-JHN.3.18, as html, json or text. Returns the passage reference, content and copyright. Use this for any verse range, including across chapters. Use apibible_verse_get for one verse.
Inputs
bible_idstringrequired- Bible ID: a 16-character hex code, a dash and a 2-digit version, from apibible_bibles_list. Example: de4e12af7f28f599-02 (King James Version).
passage_idstringrequired- Passage ID: a verse ID, or a range of two verse IDs joined by a dash. Example: JHN.3.16-JHN.3.18.
content_typestring- Format of the verse content: html, json or text. API.Bible defaults to html. Example: text.one of
htmljsontext include_chapter_numbersboolean- When true, returns chapter numbers in verse content. Defaults to false. Example: true.
include_notesboolean- When true, returns footnotes in verse content. Defaults to false. Example: true.
include_titlesboolean- When true, returns section titles in verse content. Defaults to true. Example: true.
include_verse_numbersboolean- When true, returns verse numbers in verse content. Defaults to true. Example: true.
include_verse_spansboolean- When true, returns spans that wrap verse numbers and verse text in content. Defaults to false. Example: true.
parallelsstring- Comma-separated Bible IDs. When set, the same verses from these Bibles are returned alongside. Example: 9879dbb7cfe39e4d-04.
use_org_idboolean- When true, uses the supplied id(s) to match the verse's orgId instead of its id. Defaults to false. Example: true.
apibible_searchSearch one Bible for verses containing all given keywords, or look up a passage reference such as John 3:16.Read-onlySearch Bible
Search one Bible for verses containing all given keywords, or look up a passage reference such as John 3:16. Returns matching verses (id, reference, text) and a total count, or passages for a reference query. Use this to find where words occur. Use apibible_passage_get when you already know the reference.
Inputs
bible_idstringrequired- Bible ID: a 16-character hex code, a dash and a 2-digit version, from apibible_bibles_list. Example: de4e12af7f28f599-02 (King James Version).
querystringrequired- Search keywords separated by commas, or a passage reference such as John 3:16. All keywords must appear in a verse. Wildcards: * matches any sequence, ? one character. Example: love,neighbor.
fuzzinessstring- Tolerance for misspellings: 0, 1, 2 or AUTO (the default, which depends on word length). Example: AUTO.one of
AUTO012 limitinteger- Maximum number of results, used with offset to paginate. Defaults to 10. Example: 10.
offsetinteger- Number of results to skip, used with limit to paginate. Defaults to 0. Example: 0.
rangestring- Comma-separated passage or book IDs to limit the search to. Example: MAT,MRK.
sortstring- Sorts search results. Defaults to relevance. Example: relevance.one of
relevancecanonicalreverse-canonical
apibible_section_getGet the text of one titled section, as html, json or text.Read-onlyGet Section
Get the text of one titled section, as html, json or text. Returns the section title, content and verse range. Get section IDs from apibible_book_sections_list or apibible_chapter_sections_list.
Inputs
bible_idstringrequired- Bible ID: a 16-character hex code, a dash and a 2-digit version, from apibible_bibles_list. Example: de4e12af7f28f599-02 (King James Version).
section_idstringrequired- Section ID, from apibible_book_sections_list or apibible_chapter_sections_list. Example: JHN.S1.
content_typestring- Format of the verse content: html, json or text. API.Bible defaults to html. Example: text.one of
htmljsontext include_chapter_numbersboolean- When true, returns chapter numbers in verse content. Defaults to false. Example: true.
include_notesboolean- When true, returns footnotes in verse content. Defaults to false. Example: true.
include_titlesboolean- When true, returns section titles in verse content. Defaults to true. Example: true.
include_verse_numbersboolean- When true, returns verse numbers in verse content. Defaults to true. Example: true.
include_verse_spansboolean- When true, returns spans that wrap verse numbers and verse text in content. Defaults to false. Example: true.
parallelsstring- Comma-separated Bible IDs. When set, the same verses from these Bibles are returned alongside. Example: 9879dbb7cfe39e4d-04.
apibible_verse_getGet the text of a single verse, as html, json or text.Read-onlyGet Verse
Get the text of a single verse, as html, json or text. Returns the verse reference, content and copyright. Use this for one verse. Use apibible_passage_get for a range.
Inputs
bible_idstringrequired- Bible ID: a 16-character hex code, a dash and a 2-digit version, from apibible_bibles_list. Example: de4e12af7f28f599-02 (King James Version).
verse_idstringrequired- Verse ID: book ID, chapter and verse joined with dots, from apibible_chapter_verses_list. Example: JHN.3.16.
content_typestring- Format of the verse content: html, json or text. API.Bible defaults to html. Example: text.one of
htmljsontext include_chapter_numbersboolean- When true, returns chapter numbers in verse content. Defaults to false. Example: true.
include_notesboolean- When true, returns footnotes in verse content. Defaults to false. Example: true.
include_titlesboolean- When true, returns section titles in verse content. Defaults to true. Example: true.
include_verse_numbersboolean- When true, returns verse numbers in verse content. Defaults to true. Example: true.
include_verse_spansboolean- When true, returns spans that wrap verse numbers and verse text in content. Defaults to false. Example: true.
parallelsstring- Comma-separated Bible IDs. When set, the same verses from these Bibles are returned alongside. Example: 9879dbb7cfe39e4d-04.
use_org_idboolean- When true, uses the supplied id(s) to match the verse's orgId instead of its id. Defaults to false. Example: true.
No tools match.