Air quality, for your AI agent.
Point Hermes, OpenClaw, or Claude at one MCP endpoint and your agent can check US air quality, then ping you when it turns bad.
How to connect it to your agent
Point your agent at the hosted endpoint or copy and paste into the chat box; no install, no API key. US coverage only. Pick your agent:
mcp_servers:
tinyair:
url: "https://air.drkpxl.com/mcp"
tools:
include: [get_air_quality, check_air_quality_threshold, find_nearby_stations, list_aqi_categories]Getting proactive alerts
Tiny Air is a stateless data source it never remembers your location, never stores preferences, and never notifies anyone on its own. Your agent holds that state: it knows your zip code and threshold, polls check_air_quality_threshold on its own schedule, and messages you only when the AQI is worse than your threshold.
- Hermes › Hermes scheduler
- OpenClaw ›
HEARTBEAT.md - Claude Code / Desktop › background task or system cron
Every 20 minutes, check Tiny Air for my air quality (zip 80202) and alert me whenever the
AQI is worse than 60. Use check_air_quality_threshold with max_aqi 60; if exceeded is true,
send me the current AQI and category — then don't alert me again until the AQI drops back
below 50. Reset each night at midnight.Every morning at 7am, check Tiny Air for my air quality (zip 80202) and DM me only if
it's worse than "Unhealthy for Sensitive Groups". Use check_air_quality_threshold with
min_category "Unhealthy for Sensitive Groups"; if exceeded is true, send the AQI + category.Example Output
Some examples inside Telegram, Discord, Claude Code, and Claude Desktop. Tap any to see the full reply.
Try it out
This is exactly what your agent gets back — live from AirNow.gov. US locations only.
Open & free.
Data from AirNow.gov, no API key, US coverage. The MCP endpoint lives at:
https://air.drkpxl.com/mcp The skill, agent configs, and alert recipes are open source at github.com/drkpxl/drkpxl-skills.