---
title: Wellness Air MCP connector
description: Local-first air-quality MCP — AirGradient open API, AirThings/PurpleAir/IQAir/Awair scaffolded.
canonical: https://wellness.delx.ai/connectors/air
content_signal: ai-train=no, search=yes, ai-input=yes
---

# Wellness Air MCP Connector

Closes the room-quality gap in the wellness loop. Pair AQI / PM2.5 / CO₂ with WHOOP recovery, Oura sleep, or Garmin training to explain unexplained dips. v0.1 ships full AirGradient public + owned support.

## Install

```bash
npx -y wellness-air doctor
npx -y wellness-air doctor
```

## Agent client config

```json
{
  "mcpServers": {
    "wellness-air": {
      "command": "npx",
      "args": ["-y", "wellness-air"],
      "env": {
        "WELLNESS_AIR_DEFAULT_PROVIDER": "airgradient",
        "WELLNESS_AIR_DEFAULT_LOCATION": "<locationId>"
      }
    }
  }
}
```

## Signals

- AQI
- PM2.5
- PM10
- CO2
- TVOC
- NOx
- Temperature
- Humidity

## Data availability

- AQI (computed from PM2.5): available. US EPA breakpoint formula.
- PM2.5, PM10: available. All providers.
- CO2: available. AirGradient, AirThings, Awair.
- TVOC, NOx: available. AirGradient.
- Temperature, humidity: available. All major providers.
- Hourly trend chart: opt_in. Lands in v0.2 with rolling aggregations.
- Webhook threshold alerts: not_available. Roadmap v0.4.

## MCP tools

### Profile and onboarding

- `air_profile_get`
- `air_profile_update`
- `air_onboarding`

### Start here

- `air_quickstart`
- `air_demo`
- `air_aqi_check`

### Diagnostics

- `air_connection_status`
- `air_capabilities`
- `air_privacy_audit`
- `air_data_inventory`

### Reads

- `air_current_reading`
- `air_daily_summary`
- `air_compare_locations`
- `air_search_public_sensors`

## Prompts



## Resources

- `wellness-air://agent-manifest`
- `wellness-air://capabilities`
- `wellness-air://privacy-audit`

## Privacy

- Public AirGradient sensor reads require no auth.
- Owned-sensor tokens stay on your machine.
- No telemetry — wellness-air never phones home.
- Read-only by design.
- Profile and goals persist locally to ~/.delx-wellness/profile.json (mode 0600); shared with all 14 Delx Wellness connectors and never uploaded.

## Best for

- Bedroom CO2 vs sleep quality
- Outdoor AQI guidance for training
- Cross-correlation with WHOOP/Oura recovery
- Travel-day air quality scouting

## Known limits

- AirThings/PurpleAir/IQAir/Awair adapters land in v0.2.
- Daily aggregation is a single-snapshot in v0.1.

## Links

- GitHub: https://github.com/davidmosiah/wellness-air
- npm: https://www.npmjs.com/package/wellness-air
- Provider docs: https://api.airgradient.com/public/docs/api/v1/