Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to TaxJar

Scalekit connector
Open markdown

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

Tools
21
What they doRead · write · destructive
12 · 6 · 312 read6 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 TaxJar connection

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

    Each user opens the link once and enters their TaxJar 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
  • taxjar_address_validateValidate a US customer address and return the matching standardized addresses.Read-only

    Validate Address

    Validate a US customer address and return the matching standardized addresses. Needs a TaxJar Professional or higher plan. Returns addresses[] with zip (ZIP+4), street, state, country and city. Use taxjar_address_validate to clean an address before taxjar_tax_calculate. Provide a street with zip, or street with city and state, or the full address in street.

    Inputs

    citystring
    City. Example: Gilbert
    countrystring
    Two-letter country code; only US addresses can be validated. Example: US
    statestring
    Two-letter state code. Example: AZ
    streetstring
    Street address, or the whole address as one freeform line. Example: 3301 South Greenfield Rd
    zipstring
    Postal code (5-digit ZIP or ZIP+4). Example: 85297
  • taxjar_categories_listList TaxJar's product categories and their product tax codes.Read-only

    List Product Categories

    List TaxJar's product categories and their product tax codes. Returns categories[] with name, product_tax_code and description. Use taxjar_categories_list to find the product_tax_code for line items in taxjar_tax_calculate or transactions.

    Inputs

    This tool takes no inputs.

  • taxjar_customer_getGet one customer created through the API, with exemption details.Read-only

    Get Customer

    Get one customer created through the API, with exemption details. Returns customer with customer_id, exemption_type, exempt_regions, name and address. Use taxjar_customer_get with an ID from taxjar_customers_list.

    Inputs

    customer_idstringrequired
    Your unique ID for the customer to get. Example: 123
  • taxjar_customers_listList the IDs of exempt customers created through the API.Read-only

    List Customers

    List the IDs of exempt customers created through the API. Returns customers[], an array of customer ID strings. Use taxjar_customers_list to find IDs, then taxjar_customer_get for details.

    Inputs

    This tool takes no inputs.

  • taxjar_nexus_regions_listList the regions where the TaxJar account has nexus.Read-only

    List Nexus Regions

    List the regions where the TaxJar account has nexus. Returns regions[] with country_code, country, region_code and region. Use taxjar_nexus_regions_list to see where the account collects tax.

    Inputs

    This tool takes no inputs.

  • taxjar_order_getGet one order transaction by its transaction ID.Read-only

    Get Order

    Get one order transaction by its transaction ID. Returns order with transaction_id, transaction_date, addresses, amount, shipping, sales_tax and line_items. Use taxjar_order_get with an ID from taxjar_orders_list.

    Inputs

    transaction_idstringrequired
    Your unique ID for the order transaction (letters, numbers, _ and - only). Example: 123
    providerstring
    Source the transactions were recorded from, such as api, amazon, shopify or ebay. Defaults to api. Example: api
  • taxjar_orders_listList the IDs of order transactions recorded through the API, for one date or a date range.Read-only

    List Orders

    List the IDs of order transactions recorded through the API, for one date or a date range. Returns orders[], an array of transaction ID strings. Use taxjar_orders_list to find IDs, then taxjar_order_get for details.

    Inputs

    from_transaction_datestring
    Start of the date range. Example: 2026/11/01
    providerstring
    Source the transactions were recorded from, such as api, amazon, shopify or ebay. Defaults to api. Example: api
    to_transaction_datestring
    End of the date range. Example: 2026/11/30
    transaction_datestring
    List transactions recorded on this date (yyyy/mm/dd or yyyy-mm-dd). Use it alone, or use the from/to range instead. Example: 2026/11/15
  • taxjar_rates_getGet the combined sales tax rate and its state, county, city and special district parts for a location.Read-only

    Get Tax Rates for Location

    Get the combined sales tax rate and its state, county, city and special district parts for a location. Returns rate with zip, state, county, city, combined_rate and each component rate (EU and Canada locations return their own fields). Use taxjar_rates_get for a quick rate lookup. Use taxjar_tax_calculate for an order, since rates do not apply nexus, sourcing or product rules.

    Inputs

    zipstringrequired
    Postal code of the location (5-digit ZIP or ZIP+4). Example: 90404
    citystring
    City. Example: Santa Monica
    countrystring
    Two-letter ISO country code. Example: US
    statestring
    Two-letter state code. Example: CA
    streetstring
    Street address, for rooftop accuracy. Example: 312 Hurricane Lane