> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Ambee

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.

**Authentication:** API Key
**Categories:** Analytics, Search
**Tools:** 19: 19 read, 0 write, 0 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=AMBEE)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".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](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   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)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_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.actions

   connection_name = "ambee"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_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 call
   result = actions.execute_tool(
       tool_input={},
       tool_name="ambee_air_quality_forecast_get",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Ambee credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'ambee_air_quality_forecast_get',
  toolInput: {},
  connector: 'ambee',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="ambee_air_quality_forecast_get",
    tool_input={},
    connection_name="ambee",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `ambee_air_quality_forecast_get`

Get Air Quality Forecast · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `accept_language` (`string`, optional): Response language as a language code; English by default. Example: es.
- `aqiStandard` (`string`, optional): AQI standard used for the AQI value and category: EPA (default), IN, UK, CN or CA. One of: `EPA`, `IN`, `UK`, `CN`, `CA`.
- `lat` (`number`, optional): Latitude of the location, -90 to 90. Give lat and lng, or place. Example: 12.9889055.
- `lng` (`number`, optional): Longitude of the location, -180 to 180. Give lat and lng, or place. Example: 77.574044.
- `locale` (`boolean`, optional): true adds the location's local time (localTime) to the response.
- `place` (`string`, optional): Place name to look up instead of lat/lng, such as a city, postal code or address. Example: Bengaluru.

Example input: `{}`

### `ambee_air_quality_history_get`

Get Air Quality History · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `from` (`string`, required): Start of the period, YYYY-MM-DD hh:mm:ss (UTC). Example: 2026-05-02 07:00:00.
- `to` (`string`, required): End of the period, YYYY-MM-DD hh:mm:ss (UTC). Example: 2026-05-04 07:00:00.
- `accept_language` (`string`, optional): Response language as a language code; English by default. Example: es.
- `aqiStandard` (`string`, optional): AQI standard used for the AQI value and category: EPA (default), IN, UK, CN or CA. One of: `EPA`, `IN`, `UK`, `CN`, `CA`.
- `lat` (`number`, optional): Latitude of the location, -90 to 90. Give lat and lng, or place. Example: 12.9889055.
- `lng` (`number`, optional): Longitude of the location, -180 to 180. Give lat and lng, or place. Example: 77.574044.
- `locale` (`boolean`, optional): true adds the location's local time (localTime) to the response.
- `place` (`string`, optional): Place name to look up instead of lat/lng, such as a city, postal code or address. Example: Bengaluru.

Example input: `{"from":"<from>","to":"<to>"}`

### `ambee_air_quality_latest_get`

Get Latest Air Quality · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `accept_language` (`string`, optional): Response language as a language code; English by default. Example: es.
- `aqiStandard` (`string`, optional): AQI standard used for the AQI value and category: EPA (default), IN, UK, CN or CA. One of: `EPA`, `IN`, `UK`, `CN`, `CA`.
- `lat` (`number`, optional): Latitude of the location, -90 to 90. Give lat and lng, or place. Example: 12.9889055.
- `lng` (`number`, optional): Longitude of the location, -180 to 180. Give lat and lng, or place. Example: 77.574044.
- `locale` (`boolean`, optional): true adds the location's local time (localTime) to the response.
- `place` (`string`, optional): Place name to look up instead of lat/lng, such as a city, postal code or address. Example: Bengaluru.

Example input: `{}`

### `ambee_disaster_polygon_get`

Get Disaster Polygon · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `eventId` (`string`, required): ID of the disaster event (event_id from a disasters list). Example: 23ec882e0609893d7ae26fda8e423465.

Example input: `{"eventId":"<eventId>"}`

### `ambee_disasters_by_continent_list`

List Disasters By Continent · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `continent` (`string`, required): Continent code: AFR, ANT, ASIA, AUS, EUR, NAR, SAR or Ocean. One of: `AFR`, `ANT`, `ASIA`, `AUS`, `EUR`, `NAR`, `SAR`, `Ocean`.
- `eventType` (`string`, optional): 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: `TN`, `EQ`, `TC`, `WF`, `FL`, `ET`, `DR`, `SW`, `SI`, `VO`, `LS`, `Misc`.
- `limit` (`integer`, optional): Number of events to return (default 1). Example: 10.
- `page` (`integer`, optional): Page of results, starting at 1. Example: 1.

Example input: `{"continent":"AFR"}`

### `ambee_disasters_by_coordinates_list`

List Disasters Near Coordinates · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `lat` (`number`, required): Latitude of the location, -90 to 90. Example: 12.9889055.
- `lng` (`number`, required): Longitude of the location, -180 to 180. Example: 77.574044.
- `eventType` (`string`, optional): 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: `TN`, `EQ`, `TC`, `WF`, `FL`, `ET`, `DR`, `SW`, `SI`, `VO`, `LS`, `Misc`.
- `limit` (`integer`, optional): Number of events to return (default 1). Example: 10.
- `page` (`integer`, optional): Page of results, starting at 1. Example: 1.

Example input: `{"lat":12.9889055,"lng":77.574044}`

### `ambee_disasters_by_country_list`

List Disasters By Country · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `countryCode` (`string`, required): Three-letter ISO country code. Example: USA.
- `eventType` (`string`, optional): 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: `TN`, `EQ`, `TC`, `WF`, `FL`, `ET`, `DR`, `SW`, `SI`, `VO`, `LS`, `Misc`.
- `limit` (`integer`, optional): Number of events to return (default 1). Example: 10.
- `page` (`integer`, optional): Page of results, starting at 1. Example: 1.

Example input: `{"countryCode":"<countryCode>"}`

### `ambee_fire_risk_by_coordinates_get`

Get Fire Risk By Coordinates · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `lat` (`number`, required): Latitude of the location, -90 to 90. Example: 12.9889055.
- `lng` (`number`, required): Longitude of the location, -180 to 180. Example: 77.574044.

Example input: `{"lat":12.9889055,"lng":77.574044}`

### `ambee_fire_risk_by_place_get`

Get Fire Risk By Place · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `place` (`string`, required): Place name to look up. Example: Leon, Mexico.

Example input: `{"place":"<place>"}`

### `ambee_geocode`

Geocode Place · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `place` (`string`, required): Place name or address. Example: 1600 Amphitheatre Parkway, Mountain View, CA.

Example input: `{"place":"<place>"}`

### `ambee_ili_forecast_get`

Get ILI Forecast · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `lat` (`number`, required): Latitude of the location, -90 to 90. Example: 12.9889055.
- `lng` (`number`, required): Longitude of the location, -180 to 180. Example: 77.574044.

Example input: `{"lat":12.9889055,"lng":77.574044}`

### `ambee_pollen_forecast_get`

Get Pollen Forecast · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `accept_language` (`string`, optional): Response language as a language code; English by default. Example: es.
- `horizon` (`string`, optional): Forecast length: 48hrs (hourly, default) or 120hrs. One of: `48hrs`, `120hrs`. Default: `48hrs`.
- `lat` (`number`, optional): Latitude of the location, -90 to 90. Give lat and lng, or place. Example: 12.9889055.
- `lng` (`number`, optional): Longitude of the location, -180 to 180. Give lat and lng, or place. Example: 77.574044.
- `locale` (`boolean`, optional): true adds the location's local time (localTime) to the response.
- `place` (`string`, optional): Place name to look up instead of lat/lng, such as a city, postal code or address. Example: Bengaluru.
- `speciesRisk` (`boolean`, optional): true adds sub-species risk levels where Ambee supports them.

Example input: `{}`

### `ambee_pollen_history_get`

Get Pollen History · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `from` (`string`, required): Start of the period, YYYY-MM-DD hh:mm:ss (UTC). Example: 2026-05-02 07:00:00.
- `to` (`string`, required): End of the period, YYYY-MM-DD hh:mm:ss (UTC). Example: 2026-05-04 07:00:00.
- `accept_language` (`string`, optional): Response language as a language code; English by default. Example: es.
- `lat` (`number`, optional): Latitude of the location, -90 to 90. Give lat and lng, or place. Example: 12.9889055.
- `lng` (`number`, optional): Longitude of the location, -180 to 180. Give lat and lng, or place. Example: 77.574044.
- `locale` (`boolean`, optional): true adds the location's local time (localTime) to the response.
- `place` (`string`, optional): Place name to look up instead of lat/lng, such as a city, postal code or address. Example: Bengaluru.
- `speciesRisk` (`boolean`, optional): true adds sub-species risk levels where Ambee supports them.

Example input: `{"from":"<from>","to":"<to>"}`

### `ambee_pollen_latest_get`

Get Latest Pollen · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `accept_language` (`string`, optional): Response language as a language code; English by default. Example: es.
- `lat` (`number`, optional): Latitude of the location, -90 to 90. Give lat and lng, or place. Example: 12.9889055.
- `lng` (`number`, optional): Longitude of the location, -180 to 180. Give lat and lng, or place. Example: 77.574044.
- `locale` (`boolean`, optional): true adds the location's local time (localTime) to the response.
- `place` (`string`, optional): Place name to look up instead of lat/lng, such as a city, postal code or address. Example: Bengaluru.
- `speciesRisk` (`boolean`, optional): true adds sub-species risk levels where Ambee supports them.

Example input: `{}`

### `ambee_reverse_geocode`

Reverse Geocode · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `lat` (`number`, required): Latitude of the location, -90 to 90. Example: 12.9889055.
- `lng` (`number`, required): Longitude of the location, -180 to 180. Example: 77.574044.

Example input: `{"lat":12.9889055,"lng":77.574044}`

### `ambee_solar_latest_get`

Get Solar Parameters · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `lat` (`number`, required): Latitude of the location, -90 to 90. Example: 12.9889055.
- `lng` (`number`, required): Longitude of the location, -180 to 180. Example: 77.574044.
- `locale` (`boolean`, optional): true adds the location's local time (localTime) to the response.

Example input: `{"lat":12.9889055,"lng":77.574044}`

### `ambee_weather_forecast_get`

Get Weather Forecast · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `accept_language` (`string`, optional): Response language as a language code; English by default. Example: es.
- `horizon` (`string`, optional): Forecast length: 48hrs (hourly, default) or 120hrs. One of: `48hrs`, `120hrs`. Default: `48hrs`.
- `lat` (`number`, optional): Latitude of the location, -90 to 90. Give lat and lng, or place. Example: 12.9889055.
- `lng` (`number`, optional): Longitude of the location, -180 to 180. Give lat and lng, or place. Example: 77.574044.
- `locale` (`boolean`, optional): true adds the location's local time (localTime) to the response.
- `place` (`string`, optional): Place name to look up instead of lat/lng, such as a city, postal code or address. Example: Bengaluru.
- `units` (`string`, optional): Set to si to get weather values in SI units instead of imperial. One of: `si`.

Example input: `{}`

### `ambee_weather_history_get`

Get Weather History · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `from` (`string`, required): Start of the period, YYYY-MM-DD hh:mm:ss (UTC). Example: 2026-05-02 07:00:00.
- `to` (`string`, required): End of the period, YYYY-MM-DD hh:mm:ss (UTC). Example: 2026-05-04 07:00:00.
- `accept_language` (`string`, optional): Response language as a language code; English by default. Example: es.
- `lat` (`number`, optional): Latitude of the location, -90 to 90. Give lat and lng, or place. Example: 12.9889055.
- `lng` (`number`, optional): Longitude of the location, -180 to 180. Give lat and lng, or place. Example: 77.574044.
- `locale` (`boolean`, optional): true adds the location's local time (localTime) to the response.
- `place` (`string`, optional): Place name to look up instead of lat/lng, such as a city, postal code or address. Example: Bengaluru.
- `units` (`string`, optional): Set to si to get weather values in SI units instead of imperial. One of: `si`.

Example input: `{"from":"<from>","to":"<to>"}`

### `ambee_weather_latest_get`

Get Latest Weather · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `accept_language` (`string`, optional): Response language as a language code; English by default. Example: es.
- `lat` (`number`, optional): Latitude of the location, -90 to 90. Give lat and lng, or place. Example: 12.9889055.
- `lng` (`number`, optional): Longitude of the location, -180 to 180. Give lat and lng, or place. Example: 77.574044.
- `locale` (`boolean`, optional): true adds the location's local time (localTime) to the response.
- `place` (`string`, optional): Place name to look up instead of lat/lng, such as a city, postal code or address. Example: Bengaluru.
- `units` (`string`, optional): Set to si to get weather values in SI units instead of imperial. One of: `si`.

Example input: `{}`

## Related

Other Analytics connectors ([all 177](/agentkit/connectors/?category=analytics)):

- [Google Sheets](/agentkit/connectors/googlesheets/): Scalekit connector, OAuth, 48 tools
- [HubSpot](/agentkit/connectors/hubspot/): Scalekit connector, OAuth, 457 tools
- [AWS Redshift](/agentkit/connectors/redshift/): Scalekit connector, Trusted identity provider, 10 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
