Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Radar

Scalekit connector
Open markdown

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

Tools
39
What they doRead · write · destructive
23 · 12 · 423 read12 write4 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 Radar connection

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

    Each user opens the link once and enters their Radar 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
  • radar_address_validateValidate and normalize a postal address.Read-only

    Validate Address

    Validate and normalize a postal address. Returns the verified address with its components and a verification status. Use Forward Geocode to get coordinates for an address.

    Inputs

    citystringrequired
    The city name. Example: Brooklyn.
    country_codestringrequired
    The unique 2-letter country code (e.g., US). Example: US.
    postal_codestringrequired
    The postal or zip code. Plus 4 codes are accepted but not required. Example: 11201.
    state_codestringrequired
    The 2-letter state abbreviation (e.g., NY). Example: NY.
    address_labelstring
    The first line of the address, including the building number, street name, and unit number if applicable (e.g., 20 Jay St Apt 3). Required if number and street aren't provided. Example: 20 Jay St.
    numberstring
    The building or P.O. box number. Required with street if addressLabel isn't provided. Example: 20.
    streetstring
    The street name. Required with number if addressLabel isn't provided. Example: Jay St.
    unitstring
    The unit number, such as apartment or suite (e.g., Apt 3). Example: Apt 3.
  • radar_autocompleteAutocomplete a partial address or place name, preferring results near a location.Read-only

    Autocomplete

    Autocomplete a partial address or place name, preferring results near a location. Returns suggested addresses and places with coordinates and, with a session token, result IDs. Use Autocomplete Select to record the chosen result. Use Forward Geocode for complete addresses.

    Inputs

    querystringrequired
    The partial address or place name to autocomplete. Example: 20 Jay St Brooklyn.
    country_codestring
    An optional countries filter. A string of comma-separated countries, the unique 2-letter country code. Example: US.
    layersstring
    Optional layer filters. A string, comma-separated, including one or more of place, address, postalCode, locality, county, state, country, coarse, and fine. Note that coarse includes all of postalCode, locality, county, state, and country, whereas fine includes address and place. If not provided, results from address and coarse layers will be returned. Example: address.
    limitnumber
    The max number of addresses to return. A number between 1 and 100. Defaults to 10. Example: 10.
    nearstring
    The location to prefer search results near. A string in the format latitude,longitude. If not provided, the request IP geolocation will be used to anchor the search. Example: 40.7041,-73.9867.
    session_tokenstring
    A UUID grouping the requests from one address field. When provided, each result carries a resultId that can be reported to the autocomplete select endpoint. Example: 6f1c2a3b-4d5e-4f60-8a9b-0c1d2e3f4a5b.
  • radar_beacon_getGet one beacon by its Radar _id.Read-only

    Get Beacon

    Get one beacon by its Radar _id. Returns its tag, external ID, type, identifiers, location and metadata. Use List Beacons to find beacons.

    Inputs

    beacon_idstringrequired
    The beacon's Radar _id. Example: 6109a4b16dbfe3de2cb03924.
  • radar_beacons_listList Bluetooth beacons, filterable by tag, external ID and dates.Read-only

    List Beacons

    List Bluetooth beacons, filterable by tag, external ID and dates. Returns beacons with tag, external ID, type, identifiers, location and enabled flag. Use Get Beacon for one beacon.

    Inputs

    created_afterstring
    A cursor for use in pagination. Retrieves beacons updated after the specified datetime. A date or valid ISO date string. Example: 2026-11-01T00:00:00Z.
    created_beforestring
    A cursor for use in pagination. Retrieves beacons updated before the specified datetime. A date or valid ISO date string. Example: 2026-11-16T00:00:00Z.
    external_idstring
    Retrieves beacons with the specified externalId. Example: 123.
    limitnumber
    The max number of beacons to return. A number between 1 and 1000. Defaults to 100. Example: 10.
    tagstring
    Retrieves beacons with the specified tag. Example: store.
  • radar_fraud_action_getGet the status of a block or unblock action.Read-only

    Get Fraud Action Status

    Get the status of a block or unblock action. Returns the action's status and affected users and devices. Use the action ID from Block or Unblock Users or Devices.

    Inputs

    action_idstringrequired
    Action ID from the statusUrl returned by Block or Unblock. Example: act_123.
  • radar_geocode_forwardConvert a complete address into coordinates.Read-only

    Forward Geocode

    Convert a complete address into coordinates. Returns matching addresses with latitude, longitude, formatted address, components, confidence and time zone. Use Autocomplete for partial addresses or place names. Use Reverse Geocode for coordinates to address.

    Inputs

    querystringrequired
    The address to geocode. Example: 20 Jay St Brooklyn.
    countrystring
    An optional countries filter. A string of comma-separated countries, the unique 2-letter country code. Example: US.
    langstring
    Specifies the language for the results. A string, one of ar, de, en, es, fr, ja, ko, pt, ru, zh. Defaults to en. Example: en.one of ardeenesfrjakoptruzh
    layersstring
    Optional layer filters. A string, comma-separated, including one or more of place, address, postalCode, locality, county, state, country, coarse, and fine. Note that coarse includes all of postalCode, locality, county, state, and country, whereas fine includes address and place. If not provided, results from address and coarse layers will be returned. Example: address.
  • radar_geocode_reverseConvert coordinates into an address.Read-only

    Reverse Geocode

    Convert coordinates into an address. Returns addresses for the location with formatted address, components and time zone. Use Forward Geocode for address to coordinates.

    Inputs

    coordinatesstringrequired
    The coordinates to reverse geocode. A string in the format latitude,longitude. Example: [40.7041, -73.9867].
    layersstring
    Optional layer filters. A string, comma-separated, including one or more of place, address, postalCode, locality, county, state, country, coarse, and fine. Note that coarse includes all of postalCode, locality, county, state, and country, whereas fine includes address and place. If not provided, results from address and coarse layers will be returned. Example: address.
  • radar_geofence_getGet one geofence by its Radar _id.Read-only

    Get Geofence

    Get one geofence by its Radar _id. Returns its tag, external ID, description, type, geometry, metadata and settings. Use Get Geofence by External ID when you know the tag and external ID.

    Inputs

    geofence_idstringrequired
    The geofence's Radar _id. Example: 56db1f4613012711002229f5.