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
- 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 LLMWhisperer connection
In AgentKit > Connections, create a LLMWhisperer 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 = 'llmwhisperer'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'llmwhisperer_usage_info_get',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 = "llmwhisperer"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize LLMWhisperer:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="llmwhisperer_usage_info_get",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach 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 toexecute_toolllmwhisperer_detail_getGet the details and metadata of an extraction job.Read-onlyGet 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-onlyRetrieve 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-onlyGet 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-onlyGet 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-onlyGet 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-onlyRetrieve 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-onlyGet 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-onlyGet 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.
llmwhisperer_webhook_getGet a registered webhook by name.Read-onlyGet Webhook
Get a registered webhook by name. Returns the webhook's url, auth_token and webhook_name. Use this to check a webhook before passing its name as use_webhook.
Inputs
webhook_namestringrequired- Name the webhook was registered under. Example: extraction-done.
llmwhisperer_extractStart converting a document (PDF, scanned image, Office file or spreadsheet) at a public URL into LLM-ready text, asynchronously.WriteExtract Text From Document URL
Start converting a document (PDF, scanned image, Office file or spreadsheet) at a public URL into LLM-ready text, asynchronously. Returns a whisper_hash and status processing; the text is not in this response. Poll llmwhisperer_status_get until status is processed, then call llmwhisperer_text_retrieve once. Pass use_webhook to be called back instead of polling.
Inputs
urlstringrequired- Public URL of the document to process. It must be downloadable without authentication. Example: https://example.com/files/invoice.pdf.
add_line_nosboolean- Add line numbers to the text and save line positions for llmwhisperer_highlights_get. Defaults to false. Example: true.
allow_rotated_textboolean- Keep rotated text such as watermarks. form, high_quality and table modes only. Defaults to true. Example: true.
file_namestring- Audit file name stored with the job in usage reports. Example: invoice-2026-001.pdf.
gaussian_blur_radiusinteger- Gaussian blur radius for noise removal, low_cost mode only. Defaults to 0. Example: 0.
horizontal_stretch_factornumber- Horizontal stretch to apply, for example 1.1 for 10 percent, when columns merge. Defaults to 1.0. Example: 1.1.
include_cell_bordersboolean- For Excel files: draw the workbook's cell borders as box-drawing characters. Defaults to true. Example: false.
include_line_confidenceboolean- Add a confidence value per line in the line metadata. Needs add_line_nos true and layout_preserving. Defaults to false. Example: false.
line_splitter_strategystring- Advanced line-splitting strategy. Defaults to left-priority. Example: left-priority.
line_splitter_tolerancenumber- Fraction of average character height above or below the baseline at which text moves to the next line. Defaults to 0.4. Example: 0.4.
mark_horizontal_linesboolean- Reproduce horizontal lines. Needs mark_vertical_lines true; not for native_text. Defaults to false. Example: false.
mark_vertical_linesboolean- Reproduce vertical lines from the document. Not for native_text. Defaults to false. Example: false.
median_filter_sizeinteger- Median filter size for noise removal, low_cost mode only. Defaults to 0. Example: 0.
modestring- Processing mode. native_text for digital PDFs and Office files, low_cost for clean scans, high_quality for handwriting or poor scans, form for forms and checkboxes, table for dense tables. LLMWhisperer defaults to form. Example: form.one of
native_textlow_costhigh_qualityformtable output_modestring- layout_preserving keeps the document layout for LLMs; text returns plain text. LLMWhisperer defaults to layout_preserving. Example: layout_preserving.one of
layout_preservingtext page_separatorstring- String placed between pages in the output. LLMWhisperer defaults to <<<. Example: <<<.
pages_to_extractstring- Pages to extract, for example 1-5,7,21- for pages 1 to 5, 7 and 21 to the end. All pages by default. Example: 1-5,7.
tagstring- Audit tag stored with the job, used to filter llmwhisperer_usage_stats_get. Defaults to default. Example: invoices.
use_webhookstring- Name of a webhook registered with llmwhisperer_webhook_create to call when extraction finishes. Example: extraction-done.
webhook_metadatastring- Text passed through verbatim to the webhook. Example: order-4471.
word_confidence_thresholdnumber- Minimum OCR confidence, 0 to 1, for a word to be kept. form, high_quality and table modes only. Defaults to 0.3. Example: 0.3.
llmwhisperer_webhook_createRegister a webhook that LLMWhisperer calls with the extracted text when a job finishes.WriteRegister Webhook
Register a webhook that LLMWhisperer calls with the extracted text when a job finishes. A test payload is sent first; the URL must answer 200. Returns a confirmation message. Then pass webhook_name as use_webhook in llmwhisperer_extract.
Inputs
auth_tokenstringrequired- Bearer token LLMWhisperer sends to your endpoint. Use an empty string if the endpoint has no authentication. Example: my-webhook-secret.
urlstringrequired- URL LLMWhisperer POSTs the result to. It must return 200 to the test payload sent on registration. Example: https://example.com/hooks/llmwhisperer.
webhook_namestringrequired- Name of the webhook. Pass it as use_webhook when calling llmwhisperer_extract. Example: extraction-done.
llmwhisperer_webhook_updateChange the URL or auth token of an existing webhook, identified by name.WriteUpdate Webhook
Change the URL or auth token of an existing webhook, identified by name. Returns a confirmation message. Use llmwhisperer_webhook_create for a new webhook.
- Idempotent
Inputs
auth_tokenstringrequired- Bearer token LLMWhisperer sends to your endpoint. Use an empty string if the endpoint has no authentication. Example: my-webhook-secret.
urlstringrequired- URL LLMWhisperer POSTs the result to. It must return 200 to the test payload sent on registration. Example: https://example.com/hooks/llmwhisperer.
webhook_namestringrequired- Name of the webhook. Pass it as use_webhook when calling llmwhisperer_extract. Example: extraction-done.
llmwhisperer_webhook_deleteDelete a registered webhook by name.DestructiveDelete Webhook
Delete a registered webhook by name. Returns a confirmation message. Jobs that name this webhook in use_webhook will no longer call it.
- Idempotent
Inputs
webhook_namestringrequired- Name the webhook was registered under. Example: extraction-done.
No tools match.