Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Strale

Scalekit connector
Open markdown

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

Tools
18
What they doRead · write · destructive
14 · 4 · 014 read4 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 Strale connection

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

    Each user opens the link once and enters their Strale 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
  • strale_capabilities_health_getGet a health summary of the capability catalog.Read-only

    Get Capability Health

    Get a health summary of the capability catalog. Returns a summary of capability health and availability. Use strale_capabilities_health_get to check whether capabilities are currently working.

    Inputs

    This tool takes no inputs.

  • strale_capabilities_listList every active Strale capability with its price and input schema.Read-only

    List Capabilities

    List every active Strale capability with its price and input schema. Returns capabilities[], each with slug, name, description, category, price_cents and input_schema. Use strale_capabilities_list to browse the whole catalog. Use strale_capabilities_suggest to find a capability for a task in plain language.

    Inputs

    This tool takes no inputs.

  • strale_capabilities_suggestFind the best capability or solution for a task described in plain language.Read-only

    Suggest Capability

    Find the best capability or solution for a task described in plain language. Returns an object with recommendation, alternatives, total_matches, query_understood_as. Use strale_capabilities_suggest to pick a capability for a task. Use strale_capabilities_typeahead for a fast keyword match on names.

    Inputs

    querystringrequired
    What you want to do, in plain language. Example: check if a company is on a sanctions list
    limitinteger
    Maximum number of alternatives to return. Example: 5
  • strale_capabilities_typeaheadAutocomplete capability and solution names from a keyword.Read-only

    Search Capabilities by Keyword

    Autocomplete capability and solution names from a keyword. Returns an object with matches. Use strale_capabilities_typeahead for a quick name lookup. Use strale_capabilities_suggest to match a full task description.

    Inputs

    qstringrequired
    Keyword to match, at least 2 characters (only the first 200 are used). Example: vat
    geostring
    Geography filter, such as a country code. Example: SE
    limitinteger
    Maximum matches to return, 1 to 10 (default 6). Example: 6
    typestring
    Limit matches to capabilities or solutions. One of: capability, solution. Example: capabilityone of capabilitysolution
  • strale_capability_getGet one capability by its slug, including its input and output schema, price and data source.Read-only

    Get Capability

    Get one capability by its slug, including its input and output schema, price and data source. Returns an object with slug, name, description, category, price_cents, input_schema, output_schema, transparency_tag, geography, data_source, and more. Use strale_capability_get before strale_capability_execute to learn which inputs a capability needs.

    Inputs

    slugstringrequired
    Capability slug from strale_capabilities_list or strale_capabilities_suggest. Example: iban-validate
  • strale_capability_limitations_getGet the documented limitations of one capability, such as coverage gaps and known failure cases.Read-only

    Get Capability Limitations

    Get the documented limitations of one capability, such as coverage gaps and known failure cases. Returns the JSON response from the API. Use strale_capability_limitations_get to judge whether a capability fits your input before running it.

    Inputs

    slugstringrequired
    Capability slug. Example: iban-validate
  • strale_solution_getGet one bundled solution by slug, including its steps, inputs and price.Read-only

    Get Solution

    Get one bundled solution by slug, including its steps, inputs and price. Returns an object with slug, name, description, category, price_cents, step_count, geography, transparency_tag, compliance_coverage, search_tags, and more. Use strale_solution_get before strale_solution_execute to learn which inputs a solution needs.

    Inputs

    slugstringrequired
    Solution slug from strale_solutions_list. Example: kyb-essentials-se
  • strale_solutions_listList active bundled solutions (multi-step workflows built from capabilities) with pricing and step counts.Read-only

    List Solutions

    List active bundled solutions (multi-step workflows built from capabilities) with pricing and step counts. Returns an object with solutions, total. Use strale_solutions_list to browse solutions. Use strale_capabilities_list for single capabilities.

    Inputs

    categorystring
    Category slug to filter by. Example: compliance