Ambient Weather API

Name: Ambient Weather API API
Brand: Ambient Weather API
Availability: InStock

✓ Official Vendor SpecIOTSensor DataapiKey2 EndpointsREST

For Agents

Lets agents list a user's Ambient Weather stations and pull historical readings (temperature, wind, rain, humidity, UV) from a specific station by MAC address using paired applicationKey and apiKey query parameters.

Quickstart

Get started with Ambient Weather API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"list my Ambient Weather stations"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Ambient Weather API API.

List every Ambient Weather station registered to a user account along with its MAC address and metadata

Pull historical observations from a single station identified by MAC address over a chosen end-date window

Aggregate readings across multiple personal stations belonging to the same account

Surface station telemetry (indoor and outdoor temperature, humidity, wind speed, gust, rain, UV, solar radiation) into a dashboard

GET STARTED

Start building with Ambient Weather API API

Explore with Jentic

View OpenAPI Spec

Use for: I need to list every weather station on my Ambient Weather account, Get the latest temperature and humidity reading from a specific station MAC address, Retrieve the last 24 hours of rain data from my backyard station, Check whether wind gusts on my station exceeded 30 mph today

Not supported: Does not handle weather forecasts, severe-weather alerts, or non-Ambient hardware — use for personal Ambient Weather station observations only.

The Ambient Weather API exposes data from personal weather stations connected to the Ambient Weather network. Two GET endpoints let an integration list the stations linked to an account and pull historical or near-real-time observations from a specific station by MAC address. Authentication uses paired query-string keys (applicationKey identifying the integration plus apiKey identifying the user) sent against rt.ambientweather.net/v1. Typical consumers are home-automation dashboards, hyperlocal weather services, and research projects that piggyback on the network's hardware.

Use Cases

Patterns agents use Ambient Weather API API for, with concrete tasks.

★ Hyperlocal Weather Dashboard

Owners of Ambient Weather stations can build a personal dashboard that polls GET /devices for their station list, then iterates through GET /devices/{macAddress} to chart temperature, humidity, wind, and rain over the last day. The two-call flow keeps the integration trivial — each call needs only the paired applicationKey and apiKey. Most home dashboards are wired in within an afternoon.

Call GET /devices to list stations, then call GET /devices/{macAddress} for the first station and return the latest tempf and humidity values

Hyperlocal Forecast Augmentation

Hyperlocal weather services and research projects can supplement model forecasts with ground-truth observations from Ambient Weather's network of personal stations. A single GET /devices/{macAddress} call returns the station's recent observation history, which the service can ingest alongside other sensor feeds to refine micro-climate predictions for a neighbourhood or property.

Call GET /devices/{macAddress} with endDate set to the current ISO timestamp and return the last 12 observation records

Smart-Home Irrigation and Outdoor Automations

Smart-home platforms can use a backyard Ambient Weather station to skip a sprinkler cycle when rain has already fallen or to retract awnings when wind picks up. The agent polls the device endpoint at a fixed interval, reads the rain and windgustmph fields, and triggers the right home rule. The two-endpoint surface keeps the polling loop simple.

Poll GET /devices/{macAddress} every 10 minutes and trigger an irrigation skip rule when the dailyrainin value is greater than 0.25

AI Agent Weather Sensor Lookups

Smart-home or operations agents can query Ambient Weather through Jentic without storing the user's apiKey or the integration's applicationKey. The agent searches Jentic for a station-data intent, loads the operation schema, and Jentic injects both keys at execution time. Useful when the same agent already calls calendar, climate-control, or notification APIs.

Search Jentic for 'list my Ambient Weather stations', execute the operation backed by GET /devices, and return the macAddress for the station named 'Backyard'

Key Endpoints

2 endpoints — the ambient weather api exposes data from personal weather stations connected to the ambient weather network.

METHOD

PATH

DESCRIPTION

GET

/devices

List all stations on the user's account

GET

/devices/{macAddress}

Get historical observations for a specific station

GET

/devices

List all stations on the user's account

GET

/devices/{macAddress}

Get historical observations for a specific station

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The Ambient Weather applicationKey and apiKey pair is stored encrypted in the Jentic vault. Agents receive scoped execution capability — neither key enters the agent's context, prompts, or logs.

Intent-based discovery

Agents search Jentic by intent (e.g. 'list my weather stations' or 'get station observations') and Jentic returns the matching Ambient Weather operation with its input schema, so the agent calls the right endpoint without browsing the apiary docs.

Time to first call

Direct Ambient Weather integration: 2-4 hours for key handling, polling, and rate-limit management. Through Jentic: under 15 minutes — search, load schema, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

OpenWeatherMap

Model-based current and forecast weather without requiring a personal station

Choose OpenWeatherMap when there is no physical station; choose Ambient Weather for ground-truth readings from the user's own hardware

Alternative

WeatherAPI

Global current, forecast, and historical weather from model and station blends

Pick WeatherAPI for any-location coverage; pick Ambient Weather when the user owns a station and wants their own data

Complementary

Weatherbit

Forecast and air-quality data to pair with on-site station observations

Use alongside Ambient Weather when an agent needs both ground-truth and forecast data for the same property

Complementary

Visual Crossing Weather

Long-range historical and forecast weather to extend a station's short observation window

Use Visual Crossing when more than 24 hours of historical data is needed; use Ambient Weather for the live station feed

FAQs

Specific to using Ambient Weather API API through Jentic.

What authentication does the Ambient Weather API use?

Ambient Weather uses a paired-key scheme: applicationKey (issued to the integration) and apiKey (issued to the end user) both sent as query parameters on every request. There is no OAuth flow. Through Jentic, both keys are stored encrypted in the vault and injected at execution time, so the agent never sees them.

Can I list all the weather stations on my account?

Yes. GET /devices returns the array of stations linked to the apiKey, including each station's MAC address, info block, and the latest observations. Use that MAC address to call GET /devices/{macAddress} for historical detail.

What are the rate limits for the Ambient Weather API?

Ambient Weather caps at 1 request per second per applicationKey and apiKey pair. Bursts above that return HTTP 429. Plan polling intervals around this — most home dashboards poll every 30-60 seconds, well under the limit.

How do I get a station's recent observations through Jentic?

Search Jentic for 'get Ambient Weather station observations'. Jentic returns the operation backed by GET /devices/{macAddress}, you load the schema (the only required input is the macAddress), and execute. Jentic injects the applicationKey and apiKey from the vault. Sign up at https://app.jentic.com/sign-up.

How far back does the historical observation window go?

GET /devices/{macAddress} accepts an endDate parameter and returns up to 288 records ending at that timestamp (one record every 5 minutes, ~24 hours). To pull older history, page backwards by setting endDate to the earliest timestamp from the previous call.

Does the Ambient Weather API include weather forecasts?

No. This API exposes observations from personal weather stations only — there is no forecast endpoint. Pair it with a forecast provider (OpenWeatherMap, WeatherAPI) when you need predictions alongside ground-truth station data.