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
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. 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>Create the Ambee connection
In AgentKit > Connections, create an Ambee connection. The name you give it is the
connection_nameyour code passes. See Configure connections.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.actionsconst connector = 'ambee'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'ambee_air_quality_forecast_get',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "ambee"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Ambee:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="ambee_air_quality_forecast_get",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach 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 toexecute_toolambee_air_quality_forecast_getGet the hourly air quality forecast for the next 48 hours for a location.Read-onlyGet 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-onlyGet 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-onlyGet 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-onlyGet 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-onlyList 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-onlyList 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-onlyList 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-onlyGet 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.
ambee_fire_risk_by_place_getGet the wildfire risk forecast for a place name.Read-onlyGet Fire Risk By Place
Get the wildfire risk forecast for a place name. Returns data[] of weekly fire risk forecasts (risk level and fire weather index) for the place. Use ambee_fire_risk_by_coordinates_get when you have coordinates.
Inputs
placestringrequired- Place name to look up. Example: Leon, Mexico.
ambee_geocodeConvert a place name or address to coordinates.Read-onlyGeocode Place
Convert a place name or address to coordinates. Returns matching places with lat, lng, formatted address, city, state, country and postal code. Use ambee_reverse_geocode for coordinates to place names.
Inputs
placestringrequired- Place name or address. Example: 1600 Amphitheatre Parkway, Mountain View, CA.
ambee_ili_forecast_getGet the influenza-like-illness (ILI) risk forecast for a latitude and longitude (beta, US coverage).Read-onlyGet ILI Forecast
Get the influenza-like-illness (ILI) risk forecast for a latitude and longitude (beta, US coverage). Returns data[] of forecast ILI risk levels by date for the location. Use for flu-season planning by location.
Inputs
latnumberrequired- Latitude of the location, -90 to 90. Example: 12.9889055.
lngnumberrequired- Longitude of the location, -180 to 180. Example: 77.574044.
ambee_pollen_forecast_getGet the pollen forecast for a location for the next 48 or 120 hours.Read-onlyGet Pollen Forecast
Get the pollen forecast for a location for the next 48 or 120 hours. Give either lat and lng or a place name. Returns data[] of forecasts with grass, tree and weed counts and risk levels. Use ambee_pollen_latest_get for current values.
Inputs
accept_languagestring- Response language as a language code; English by default. Example: es.
horizonstring- Forecast length: 48hrs (hourly, default) or 120hrs.one of
48hrs120hrsdefault48hrs 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.
speciesRiskboolean- true adds sub-species risk levels where Ambee supports them.
ambee_pollen_history_getGet hourly pollen counts and risk levels for a location over a past period.Read-onlyGet Pollen History
Get hourly pollen counts and risk levels for a location over a past period. Give either lat and lng or a place name. Returns data[] of hourly records with grass, tree and weed counts and risk levels. Use ambee_pollen_latest_get for current values.
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.
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.
speciesRiskboolean- true adds sub-species risk levels where Ambee supports them.
ambee_pollen_latest_getGet current pollen counts and risk levels for a location.Read-onlyGet Latest Pollen
Get current pollen counts and risk levels for a location. Give either lat and lng or a place name. Returns data with grass, tree and weed pollen counts, risk levels and optional species-level risk. Use ambee_pollen_history_get for past data and ambee_pollen_forecast_get for the forecast.
Inputs
accept_languagestring- Response language as a language code; English by default. Example: es.
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.
speciesRiskboolean- true adds sub-species risk levels where Ambee supports them.
ambee_reverse_geocodeConvert a latitude and longitude to nearby place names.Read-onlyReverse Geocode
Convert a latitude and longitude to nearby place names. Returns places near the point with address, city, state, country and postal code. Use ambee_geocode for place names to coordinates.
Inputs
latnumberrequired- Latitude of the location, -90 to 90. Example: 12.9889055.
lngnumberrequired- Longitude of the location, -180 to 180. Example: 77.574044.
ambee_solar_latest_getGet current solar irradiance parameters for a latitude and longitude.Read-onlyGet Solar Parameters
Get current solar irradiance parameters for a latitude and longitude. Returns data with global horizontal, direct normal and diffuse irradiance, solar elevation and related values. Use for solar energy estimates.
Inputs
latnumberrequired- Latitude of the location, -90 to 90. Example: 12.9889055.
lngnumberrequired- Longitude of the location, -180 to 180. Example: 77.574044.
localeboolean- true adds the location's local time (localTime) to the response.
ambee_weather_forecast_getGet the weather forecast for a location: hourly for 48 hours or 3-hourly for 120 hours.Read-onlyGet Weather Forecast
Get the weather forecast for a location: hourly for 48 hours or 3-hourly for 120 hours. Give either lat and lng or a place name. Returns data[] of forecasts with temperature, humidity, wind, precipitation and summary. Use ambee_weather_latest_get for current weather.
Inputs
accept_languagestring- Response language as a language code; English by default. Example: es.
horizonstring- Forecast length: 48hrs (hourly, default) or 120hrs.one of
48hrs120hrsdefault48hrs 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.
unitsstring- Set to si to get weather values in SI units instead of imperial.one of
si
ambee_weather_history_getGet hourly weather for a location over a past period.Read-onlyGet Weather History
Get hourly weather for a location over a past period. Give either lat and lng or a place name. Returns data[] of hourly records with temperature, humidity, pressure, wind and precipitation. Use ambee_weather_latest_get for current weather.
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.
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.
unitsstring- Set to si to get weather values in SI units instead of imperial.one of
si
ambee_weather_latest_getGet current weather for a location.Read-onlyGet Latest Weather
Get current weather for a location. Give either lat and lng or a place name. Returns data with temperature, apparent temperature, humidity, pressure, wind, cloud cover, visibility, precipitation and summary. Use ambee_weather_history_get for past data and ambee_weather_forecast_get for the forecast.
Inputs
accept_languagestring- Response language as a language code; English by default. Example: es.
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.
unitsstring- Set to si to get weather values in SI units instead of imperial.one of
si
No tools match.