Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Ambee

Scalekit connector
Open markdown

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

Tools
19
What they doRead · write · destructive
19 · 0 · 019 read0 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 Ambee connection

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

    Each user opens the link once and enters their Ambee 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
  • ambee_air_quality_forecast_getGet the hourly air quality forecast for the next 48 hours for a location.Read-only

    Get Air Quality Forecast

    Get the hourly air quality forecast for the next 48 hours for a location. Give either lat and lng or a place name. Returns data[] of hourly forecasts with AQI, category and pollutant concentrations. Use ambee_air_quality_latest_get for current conditions.

    Inputs

    accept_languagestring
    Response language as a language code; English by default. Example: es.
    aqiStandardstring
    AQI standard used for the AQI value and category: EPA (default), IN, UK, CN or CA.one of EPAINUKCNCA
    latnumber
    Latitude of the location, -90 to 90. Give lat and lng, or place. Example: 12.9889055.
    lngnumber
    Longitude of the location, -180 to 180. Give lat and lng, or place. Example: 77.574044.
    localeboolean
    true adds the location's local time (localTime) to the response.
    placestring
    Place name to look up instead of lat/lng, such as a city, postal code or address. Example: Bengaluru.
  • ambee_air_quality_history_getGet hourly air quality for a location over a past period.Read-only

    Get Air Quality History

    Get hourly air quality for a location over a past period. Give either lat and lng or a place name. Returns data[] of hourly records with AQI, category and pollutant concentrations. Use ambee_air_quality_latest_get for the current hour.

    Inputs

    fromstringrequired
    Start of the period, YYYY-MM-DD hh:mm:ss (UTC). Example: 2026-05-02 07:00:00.
    tostringrequired
    End of the period, YYYY-MM-DD hh:mm:ss (UTC). Example: 2026-05-04 07:00:00.
    accept_languagestring
    Response language as a language code; English by default. Example: es.
    aqiStandardstring
    AQI standard used for the AQI value and category: EPA (default), IN, UK, CN or CA.one of EPAINUKCNCA
    latnumber
    Latitude of the location, -90 to 90. Give lat and lng, or place. Example: 12.9889055.
    lngnumber
    Longitude of the location, -180 to 180. Give lat and lng, or place. Example: 77.574044.
    localeboolean
    true adds the location's local time (localTime) to the response.
    placestring
    Place name to look up instead of lat/lng, such as a city, postal code or address. Example: Bengaluru.
  • ambee_air_quality_latest_getGet the current-hour air quality for a location at about 500 m resolution.Read-only

    Get Latest Air Quality

    Get the current-hour air quality for a location at about 500 m resolution. Give either lat and lng or a place name. Returns stations[] with AQI, aqiInfo (pollutant and category) and concentrations of PM2.5, PM10, NO2, SO2, CO and O3. Use ambee_air_quality_history_get for past hours and ambee_air_quality_forecast_get for the next 48 hours.

    Inputs

    accept_languagestring
    Response language as a language code; English by default. Example: es.
    aqiStandardstring
    AQI standard used for the AQI value and category: EPA (default), IN, UK, CN or CA.one of EPAINUKCNCA
    latnumber
    Latitude of the location, -90 to 90. Give lat and lng, or place. Example: 12.9889055.
    lngnumber
    Longitude of the location, -180 to 180. Give lat and lng, or place. Example: 77.574044.
    localeboolean
    true adds the location's local time (localTime) to the response.
    placestring
    Place name to look up instead of lat/lng, such as a city, postal code or address. Example: Bengaluru.
  • ambee_disaster_polygon_getGet the geographic footprint polygon of one natural disaster event.Read-only

    Get Disaster Polygon

    Get the geographic footprint polygon of one natural disaster event. Returns the event's polygon geometry (GeoJSON-style coordinates) and event details. Get the event ID from one of the ambee_disasters_*_list tools.

    Inputs

    eventIdstringrequired
    ID of the disaster event (event_id from a disasters list). Example: 23ec882e0609893d7ae26fda8e423465.
  • ambee_disasters_by_continent_listList the latest natural disasters on a continent, optionally of one type.Read-only

    List Disasters By Continent

    List the latest natural disasters on a continent, optionally of one type. Returns result[] of events with event_id, event_type, event_name, date, location and severity. Use ambee_disasters_by_country_list to narrow to one country.

    Inputs

    continentstringrequired
    Continent code: AFR, ANT, ASIA, AUS, EUR, NAR, SAR or Ocean.one of AFRANTASIAAUSEURNARSAROcean
    eventTypestring
    Only this disaster type: TN (tsunami), EQ (earthquake), TC (tropical cyclone), WF (wildfire), FL (flood), ET (extreme temperature), DR (drought), SW (severe storm), SI (sea ice), VO (volcano), LS (landslide) or Misc.one of TNEQTCWFFLETDRSWSIVOLSMisc
    limitinteger
    Number of events to return (default 1). Example: 10.
    pageinteger
    Page of results, starting at 1. Example: 1.
  • ambee_disasters_by_coordinates_listList the latest natural disasters near a latitude and longitude, optionally of one type.Read-only

    List Disasters Near Coordinates

    List the latest natural disasters near a latitude and longitude, optionally of one type. Returns result[] of events with event_id, event_type, event_name, date, lat, lng, severity and details. Use ambee_disaster_polygon_get with an event_id for its footprint.

    Inputs

    latnumberrequired
    Latitude of the location, -90 to 90. Example: 12.9889055.
    lngnumberrequired
    Longitude of the location, -180 to 180. Example: 77.574044.
    eventTypestring
    Only this disaster type: TN (tsunami), EQ (earthquake), TC (tropical cyclone), WF (wildfire), FL (flood), ET (extreme temperature), DR (drought), SW (severe storm), SI (sea ice), VO (volcano), LS (landslide) or Misc.one of TNEQTCWFFLETDRSWSIVOLSMisc
    limitinteger
    Number of events to return (default 1). Example: 10.
    pageinteger
    Page of results, starting at 1. Example: 1.
  • ambee_disasters_by_country_listList the latest natural disasters in a country, optionally of one type.Read-only

    List Disasters By Country

    List the latest natural disasters in a country, optionally of one type. Returns result[] of events with event_id, event_type, event_name, date, location and severity. Use ambee_disasters_by_coordinates_list for a specific point.

    Inputs

    countryCodestringrequired
    Three-letter ISO country code. Example: USA.
    eventTypestring
    Only this disaster type: TN (tsunami), EQ (earthquake), TC (tropical cyclone), WF (wildfire), FL (flood), ET (extreme temperature), DR (drought), SW (severe storm), SI (sea ice), VO (volcano), LS (landslide) or Misc.one of TNEQTCWFFLETDRSWSIVOLSMisc
    limitinteger
    Number of events to return (default 1). Example: 10.
    pageinteger
    Page of results, starting at 1. Example: 1.
  • ambee_fire_risk_by_coordinates_getGet the wildfire risk forecast for a latitude and longitude.Read-only

    Get Fire Risk By Coordinates

    Get the wildfire risk forecast for a latitude and longitude. Returns data[] of weekly fire risk forecasts (risk level and fire weather index) for the location. Use ambee_fire_risk_by_place_get to look up by place name.

    Inputs

    latnumberrequired
    Latitude of the location, -90 to 90. Example: 12.9889055.
    lngnumberrequired
    Longitude of the location, -180 to 180. Example: 77.574044.