Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to LlamaParse

Scalekit connector
Open markdown

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

Tools
22
What they doRead · write · destructive
12 · 7 · 312 read7 write3 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 LlamaParse connection

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

    Each user opens the link once and enters their LlamaParse 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
  • llamaparse_classify_job_getGet a classify job's status and, when finished, the chosen document type with its confidence and reasoning.Read-only

    Get Classify Job

    Get a classify job's status and, when finished, the chosen document type with its confidence and reasoning. Returns id, status, error_message and the classification result. Use this to poll a classification and read the result.

    Inputs

    job_idstringrequired
    Classify job ID returned by llamaparse_classify_job_create or listed by llamaparse_classify_jobs_list. Example: clj-5b8e2f9c3a1d
    expandarray
    Extra fields to include: usage. Example: ["usage"]
  • llamaparse_classify_jobs_listList classify jobs in the project, optionally filtered by status and creation time.Read-only

    List Classify Jobs

    List classify jobs in the project, optionally filtered by status and creation time. Returns items (each with id, status and created_at) and next_page_token. Use this to find earlier classifications. Use llamaparse_classify_job_get for a result.

    Inputs

    created_at_on_or_afterstring
    Only jobs created at or after this time (ISO 8601). Example: 2026-11-01T00:00:00Z
    created_at_on_or_beforestring
    Only jobs created at or before this time (ISO 8601). Example: 2026-11-15T23:59:59Z
    page_sizeinteger
    Jobs per page, 1 to 100. Example: 20
    page_tokenstring
    Token from next_page_token of the previous response, to get the next page. Example: eyJvZmZzZXQiOjIwfQ
    statusstring
    Only return classify jobs in this status: PENDING, RUNNING, COMPLETED, FAILED, CANCELLED. Example: COMPLETEDone of PENDINGRUNNINGCOMPLETEDFAILEDCANCELLED
  • llamaparse_extract_job_getGet an extract job's status and, when finished, the extracted data.Read-only

    Get Extract Job

    Get an extract job's status and, when finished, the extracted data. Returns id, status, error_message and extract_result (data matching the schema), plus any expanded fields. Use this to poll an extraction and read the result.

    Inputs

    job_idstringrequired
    Extract job ID returned by llamaparse_extract_job_create or listed by llamaparse_extract_jobs_list. Example: exj-7f2c9d1a4b6e
    expandarray
    Extra fields to include: configuration, extract_metadata (citations and confidence scores), usage. Example: ["extract_metadata"]
  • llamaparse_extract_jobs_listList extract jobs in the project, optionally filtered by status, source document or creation time.Read-only

    List Extract Jobs

    List extract jobs in the project, optionally filtered by status, source document or creation time. Returns items (each with id, status, file_input and created_at) and next_page_token. Use this to find earlier extractions. Use llamaparse_extract_job_get for a job's result.

    Inputs

    created_at_on_or_afterstring
    Only jobs created at or after this time (ISO 8601). Example: 2026-11-01T00:00:00Z
    created_at_on_or_beforestring
    Only jobs created at or before this time (ISO 8601). Example: 2026-11-15T23:59:59Z
    file_inputstring
    Only jobs run on this parse job ID or file ID. Example: pjb-3k9x2m7q1v8c
    page_sizeinteger
    Jobs per page, 1 to 1000. Example: 20
    page_tokenstring
    Token from next_page_token of the previous response, to get the next page. Example: eyJvZmZzZXQiOjIwfQ
    statusstring
    Only return extract jobs in this status: PENDING, THROTTLED, RUNNING, COMPLETED, FAILED, CANCELLED. Example: COMPLETEDone of PENDINGTHROTTLEDRUNNINGCOMPLETEDFAILEDCANCELLED
  • llamaparse_extract_schema_validateCheck whether a JSON Schema can be used for extraction.Read-only

    Validate Extraction Schema

    Check whether a JSON Schema can be used for extraction. Returns the validated (normalized) schema, or a 422 error describing what is wrong. Use this before llamaparse_extract_job_create.

    Inputs

    data_schemaobjectrequired
    JSON Schema to check for use with extract jobs. Example: {"type": "object", "properties": {"total": {"type": "number"}}}
  • llamaparse_organizations_listList the LlamaCloud organizations the API key's user belongs to.Read-only

    List Organizations

    List the LlamaCloud organizations the API key's user belongs to. Returns items with id, name and created_at, plus next_page_token. Use this with llamaparse_projects_list to see account structure.

    Inputs

    namestring
    Only organizations with this name. Example: Acme Corp
    page_sizeinteger
    Organizations per page. Example: 20
    page_tokenstring
    Token from next_page_token of the previous response. Example: eyJvZmZzZXQiOjIwfQ
  • llamaparse_parse_job_getGet a parse job's status and, with expand, its parsed output as markdown, text, structured items or metadata.Read-only

    Get Parse Job

    Get a parse job's status and, with expand, its parsed output as markdown, text, structured items or metadata. Returns job (id, status, error_message) plus the requested outputs, for example markdown.pages[].markdown. Use this to poll a job and read the result. Use llamaparse_parse_jobs_list to find job IDs.

    Inputs

    job_idstringrequired
    Parse job ID returned by llamaparse_parse_job_create or listed by llamaparse_parse_jobs_list. Example: pjb-3k9x2m7q1v8c
    expandarray
    Output to include with the job: text, markdown, items, metadata, forms, job_metadata, usage, or one of the *_content_metadata fields (which carry presigned download URLs, for example images_content_metadata or xlsx_content_metadata). Without expand only the job status is returned. Example: ["markdown", "usage"]
    image_filenamesstring
    Comma-separated image filenames to include when expanding images_content_metadata. Example: image_0.png,image_1.jpg
  • llamaparse_parse_jobs_listList parse jobs in the project, newest first, optionally filtered by status and creation time.Read-only

    List Parse Jobs

    List parse jobs in the project, newest first, optionally filtered by status and creation time. Returns items (each with id, status, tier, created_at and the source) and next_page_token. Use this to find an earlier job. Use llamaparse_parse_job_get for a job's output.

    Inputs

    created_at_on_or_afterstring
    Only jobs created at or after this time (ISO 8601). Example: 2026-11-01T00:00:00Z
    created_at_on_or_beforestring
    Only jobs created at or before this time (ISO 8601). Example: 2026-11-15T23:59:59Z
    page_sizeinteger
    Jobs per page, 1 to 1000. Example: 20
    page_tokenstring
    Token from next_page_token of the previous response, to get the next page. Example: eyJvZmZzZXQiOjIwfQ
    statusstring
    Only return parse jobs in this status: PENDING, RUNNING, COMPLETED, FAILED, CANCELLED. Example: COMPLETEDone of PENDINGRUNNINGCOMPLETEDFAILEDCANCELLED