Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to LLMWhisperer

Scalekit connector
Open markdown

The LLMWhisperer connector lets your AI agent act in each user's LLMWhisperer account. Each user connects their own LLMWhisperer API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 13 tools.

Tools
13
What they doRead · write · destructive
9 · 3 · 19 read3 write1 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 LLMWhisperer connection

    In AgentKit > Connections, create a LLMWhisperer 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 = 'llmwhisperer'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize LLMWhisperer:', 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: 'llmwhisperer_usage_info_get',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their LLMWhisperer 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
  • llmwhisperer_detail_getGet the details and metadata of an extraction job.Read-only

    Get Extraction Details

    Get the details and metadata of an extraction job. Returns mode, requested, processed and total pages, file size, tag, processing time and timestamps (plus token_usage for document insights jobs). Use this to audit a job; it does not return the text.

    Inputs

    whisper_hashstringrequired
    whisper_hash returned by llmwhisperer_extract when the job was accepted. Example: a1b2c3d4|0f9e8d7c6b5a49382716a5b4c3d2e1f0.
  • llmwhisperer_document_insights_retrieveRetrieve the handwritten signatures and table of contents found by a Document Insights job.Read-only

    Retrieve Document Insights

    Retrieve the handwritten signatures and table of contents found by a Document Insights job. The result can be retrieved only once. Returns signature_metadata keyed by page, a nested table_of_contents and whisper_metadata with token usage. Use this for jobs submitted to LLMWhisperer's Document Insights API; check llmwhisperer_status_get first.

    Inputs

    whisper_hashstringrequired
    whisper_hash returned when the Document Insights job was submitted. Example: a1b2c3d4|0f9e8d7c6b5a49382716a5b4c3d2e1f0.
  • llmwhisperer_highlights_getGet the bounding-box metadata of extracted lines, used to highlight text in the original document.Read-only

    Get Line Highlights

    Get the bounding-box metadata of extracted lines, used to highlight text in the original document. Returns, per line number, the page, base_y, height and page_height (absolute and percent). Works only for jobs started with add_line_nos true.

    Inputs

    linesstringrequired
    Lines to return, for example 1-5,7,21- for lines 1 to 5, 7 and 21 to the end. Example: 1-20.
    whisper_hashstringrequired
    whisper_hash returned by llmwhisperer_extract when the job was accepted. Example: a1b2c3d4|0f9e8d7c6b5a49382716a5b4c3d2e1f0.
  • llmwhisperer_pdf_to_images_status_getGet the status of a PDF-to-images conversion job.Read-only

    Get PDF To Images Status

    Get the status of a PDF-to-images conversion job. Returns status (accepted, processing, processed, error or retrieved), per-page progress, and page counts once processed. Use this for jobs submitted to LLMWhisperer's PDF to Images API. The ZIP download itself is not available through this connector.

    Inputs

    whisper_hashstringrequired
    whisper_hash returned when the PDF to Images job was submitted. Example: a1b2c3d4|0f9e8d7c6b5a49382716a5b4c3d2e1f0.
  • llmwhisperer_status_getGet the status of a text extraction job.Read-only

    Get Extraction Status

    Get the status of a text extraction job. Returns status (accepted, processing, processed, error or retrieved), a message and per-page detail. Poll this after llmwhisperer_extract. When status is processed, call llmwhisperer_text_retrieve.

    Inputs

    whisper_hashstringrequired
    whisper_hash returned by llmwhisperer_extract when the job was accepted. Example: a1b2c3d4|0f9e8d7c6b5a49382716a5b4c3d2e1f0.
  • llmwhisperer_text_retrieveRetrieve the extracted text of a finished job.Read-only

    Retrieve Extracted Text

    Retrieve the extracted text of a finished job. The text can be retrieved only once, so store it. Returns result_text plus confidence_metadata and metadata, or only the text when text_only is true. Call this once llmwhisperer_status_get reports processed. A second call returns an error.

    Inputs

    whisper_hashstringrequired
    whisper_hash returned by llmwhisperer_extract when the job was accepted. Example: a1b2c3d4|0f9e8d7c6b5a49382716a5b4c3d2e1f0.
    text_onlyboolean
    true to return only the text, false to include the metadata. Defaults to false. Example: false.
  • llmwhisperer_usage_info_getGet the page usage and quotas of your LLMWhisperer account.Read-only

    Get Usage Info

    Get the page usage and quotas of your LLMWhisperer account. Returns subscription_plan, monthly and daily quotas, page counts per mode, overage and today's page count (-1 means not applicable). Use this to check remaining quota. Use llmwhisperer_usage_stats_get for usage by tag.

    Inputs

    This tool takes no inputs.

  • llmwhisperer_usage_stats_getGet pages processed per mode for one audit tag over a date range (last 30 days by default).Read-only

    Get Usage By Tag

    Get pages processed per mode for one audit tag over a date range (last 30 days by default). Returns start_date, end_date, tag and usage (pages_processed per service_type). Use the tag passed to llmwhisperer_extract. Use llmwhisperer_usage_info_get for account totals.

    Inputs

    tagstringrequired
    Audit tag to report on. Example: invoices.
    from_datestring
    Start date, YYYY-MM-DD. Example: 2026-10-01.
    to_datestring
    End date, YYYY-MM-DD. Example: 2026-10-31.