Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to API.Bible

Scalekit connector
Open markdown

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

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. 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>
  3. Create the API.Bible connection

    In AgentKit > Connections, create an API.Bible connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. 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.actions
    const connector = 'apibible'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { 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 call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'apibible_audio_bibles_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each 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 to execute_tool
Try in PlaygroundRequest a tool
  • apibible_audio_bible_getGet one audio Bible by ID.Read-only

    Get 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-only

    List 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-only

    Get 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-only

    List 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-only

    Get 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-only

    List 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-only

    Get 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-only

    List 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.