Wellness Air

Local-first air-quality MCP for AI agents — AirGradient, AirThings, PurpleAir, IQAir, Awair.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "wellness-air": {
      "command": "npx",
      "args": [
        "-y",
        "delx-wellness-hermes"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Capabilities & Tool Schemas (19)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Wellness Air.

air_agent_manifest

Runtime contract: tool list, supported clients, env vars, recommended first calls

air_capabilities

Supported providers, configured providers, available metrics, privacy modes

air_connection_status

Health check + warnings the agent should surface

air_privacy_audit

What is logged locally vs sent to providers

air_data_inventory

Metric catalog + AQI band thresholds

air_current_reading

Latest sensor reading (PM2.5, CO₂, AQI, temp, humidity)

Documentation Overview

Wellness Air

Local-first air-quality MCP for AI agents.
Plug an AirGradient/AirThings/PurpleAir sensor into your agent — no tokens leave your machine.

📡 Why this exists: your sleep / focus / training results are partly a room-quality problem. PM2.5 above 35, CO₂ above 1,000 ppm, low humidity — those wreck recovery and the agent can't see them. wellness-air gives any AI agent local-first environmental context to cross with WHOOP / Oura / Garmin / nourish.

⚡ One-command install — pick your runtime:

Delx Wellness for Hermes: npx -y delx-wellness-hermes setup

Delx Wellness for OpenClaw: npx -y delx-wellness-openclaw setup

Or wire it standalone into Claude Desktop / Cursor / ChatGPT Desktop — see the install section below.

HTTP (v2 stateless)

Default is stdio. Optional Streamable HTTP — no session id, JSON responses, loopback only:

Terminal

npx -y wellness-air --http
# GET  http://127.0.0.1:3000/health
# POST http://127.0.0.1:3000/mcp   (sessionless)

Env: WELLNESS_AIR_HOST, WELLNESS_AIR_PORT, WELLNESS_AIR_TRANSPORT=http.

Overview

Wellness Air is a local MCP server that exposes air-quality readings to any MCP-aware AI agent. It ships with first-class AirGradient support (open hardware + free public API — no auth needed for the 2,000+ public sensors in the worldwide feed). AirThings and PurpleAir are implemented (bring your own free API credentials); IQAir AirVisual and Awair are on the roadmap.

If wellness-air helps your agent, please star the repo. Stars make the project easier for other AI builders to discover and help Delx keep shipping local-first wellness infrastructure.

Try It In 60 Seconds

bash

# 89 is a real, public AirGradient sensor (Prem Tinsulanonda School, Thailand).
# Swap in one near you from https://www.airgradient.com/map/ — copy the numeric
# locationId from the URL.

WELLNESS_AIR_DEFAULT_LOCATION=89 npx -y wellness-air doctor
WELLNESS_AIR_DEFAULT_LOCATION=89 npx -y wellness-air current

That's it — no token, no signup, no telemetry. Public reads use AirGradient's token-free worldwide feed, so any locationId in that feed works out of the box.

Install in Claude Desktop / Cursor / ChatGPT Desktop / Codex

JSON Config

{
  "mcpServers": {
    "wellness-air": {
      "command": "npx",
      "args": ["-y", "wellness-air"],
      "env": {
        "WELLNESS_AIR_DEFAULT_PROVIDER": "airgradient",
        "WELLNESS_AIR_DEFAULT_LOCATION": "89"
      }
    }
  }
}

Reload your client. The agent now has 19 air-quality tools.

Tools (19 total)

Tool	Purpose
`air_agent_manifest`	Runtime contract: tool list, supported clients, env vars, recommended first calls
`air_capabilities`	Supported providers, configured providers, available metrics, privacy modes
`air_connection_status`	Health check + warnings the agent should surface
`air_privacy_audit`	What is logged locally vs sent to providers
`air_data_inventory`	Metric catalog + AQI band thresholds
`air_current_reading`	Latest sensor reading (PM2.5, CO₂, AQI, temp, humidity)
`air_list_devices`	List devices on an authenticated provider account (AirThings)
`air_aqi_check`	Fast 'is the air OK?' answer with band + recommendation
`air_daily_summary`	Synthesized daily snapshot
`air_compare_locations`	Compare AQI across 2-10 locations
`air_search_public_sensors`	Discovery helper for AirGradient public map
`air_quickstart`	Personalized 3-step setup walkthrough based on current env state
`air_profile_get`	Read the shared Delx Wellness profile (location, sensitivities, units)
`air_profile_update`	Persist a non-secret patch to the shared wellness profile (explicit intent required)
`air_onboarding`	11-question onboarding flow for the shared wellness profile
`air_demo`	Realistic example payloads — preview output before configuring anything
`air_health_recommendation`	PM2.5/CO₂/VOC → WHO/EPA bands + plain-language actions
`air_health_bands`	Classify PM2.5/PM10/CO₂/VOC into WHO 2021 / EPA / ASHRAE / UBA bands + citations
`air_trend`	Windowed trend analysis (mean/median/rate-of-change/peaks) for PM2.5/CO₂/VOC

Why local-first?

Public sensors require zero auth. AirGradient runs an open public API; just pass a locationId.
Owned-sensor tokens stay on your machine. Set AIRGRADIENT_API_TOKEN only if you own a sensor.
No telemetry. wellness-air never phones home. The only outbound calls go to the providers you configure.
Read-only. No tool mutates anything upstream. (air_profile_update writes only to your local shared wellness profile, never to a provider, and requires explicit user intent.)

Cross-connector wedge

Where this gets interesting: pair it with the rest of the Delx Wellness stack.

Code

WHOOP recovery 47   +   wellness-air AQI 132 (unhealthy_sensitive)
       ↓                          ↓
   Coach: "Recovery's low AND the bedroom AQI was unhealthy last night.
           Skip outdoor cardio today — try mobility + low-intensity strength indoors with HEPA running."

Most agents miss the room-quality variable entirely. wellness-air closes that gap.

Privacy

Run wellness-air doctor to inspect the local privacy posture. Highlights:

All readings cached under ~/.wellness-air (configurable).
Provider tokens never returned to the agent.
No biometric data — environmental only.
Tool outputs explicitly tagged with their data source for downstream auditability.

Roadmap

Shipped: AirGradient (public + owned) · AirThings · PurpleAir adapters · WHO/EPA/ASHRAE/UBA health bands · windowed trend analysis (air_trend) · shared Delx Wellness profile + onboarding.

Next:

IQAir AirVisual + Awair adapters.
Cross-correlation helper (e.g. air_correlate_with_sleep) against the rest of the Delx Wellness stack.
Webhook trigger for AQI thresholds (agent gets notified when AQI crosses a band).

📧 Contact & Support

📨 support@delx.ai — general questions, integration help, partnerships
🐛 Bug reports / feature requests — GitHub Issues
🐦 Updates — @delx369 on X
🌐 Site — wellness.delx.ai

License

MIT — see LICENSE.

_{wellness-air is an unofficial connector. AirGradient, AirThings, PurpleAir, IQAir, and Awair are trademarks of their respective owners. None of those companies are affiliated with or endorse this project.}

Skill or MCP

Same package, two doors. MCP registers tools on stdio/HTTP. The skill can drive the same tools through the CLI when the client has no MCP:

Terminal

npx -y wellness-air call air_connection_status --json '{}'

Copy skill/SKILL.md into your agent skills dir.

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads

885

Package downloads in the last 30 days.

Last commit

9d ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Wellness Air

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "wellness-air": { "command": "npx", "args": ["-y", "wellness-air"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/wellness-air?style=directory)](https://allmcps.com/mcp/wellness-air)

HTML Embed

<a href="https://allmcps.com/mcp/wellness-air"><img src="https://allmcps.com/api/badge/wellness-air?style=directory" alt="Wellness Air on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

56Quality signal: Good · 56/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools25/30

Adoption & activity7/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Wellness Air →Install in Claude Desktop Install in Cursor Install in VS Code

Wellness Air

Local-first air-quality MCP for AI agents — AirGradient, AirThings, PurpleAir, IQAir, Awair.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "wellness-air": {
      "command": "npx",
      "args": [
        "-y",
        "delx-wellness-hermes"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Capabilities & Tool Schemas (19)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Wellness Air.

air_agent_manifest

Runtime contract: tool list, supported clients, env vars, recommended first calls

air_capabilities

Supported providers, configured providers, available metrics, privacy modes

air_connection_status

Health check + warnings the agent should surface

air_privacy_audit

What is logged locally vs sent to providers

air_data_inventory

Metric catalog + AQI band thresholds

air_current_reading

Latest sensor reading (PM2.5, CO₂, AQI, temp, humidity)

Documentation Overview

Wellness Air

Local-first air-quality MCP for AI agents.
Plug an AirGradient/AirThings/PurpleAir sensor into your agent — no tokens leave your machine.

⚡ One-command install — pick your runtime:

Delx Wellness for Hermes: npx -y delx-wellness-hermes setup

Delx Wellness for OpenClaw: npx -y delx-wellness-openclaw setup

Or wire it standalone into Claude Desktop / Cursor / ChatGPT Desktop — see the install section below.

HTTP (v2 stateless)

Default is stdio. Optional Streamable HTTP — no session id, JSON responses, loopback only:

Terminal

npx -y wellness-air --http
# GET  http://127.0.0.1:3000/health
# POST http://127.0.0.1:3000/mcp   (sessionless)

Env: WELLNESS_AIR_HOST, WELLNESS_AIR_PORT, WELLNESS_AIR_TRANSPORT=http.

Overview

If wellness-air helps your agent, please star the repo. Stars make the project easier for other AI builders to discover and help Delx keep shipping local-first wellness infrastructure.

Try It In 60 Seconds

bash

# 89 is a real, public AirGradient sensor (Prem Tinsulanonda School, Thailand).
# Swap in one near you from https://www.airgradient.com/map/ — copy the numeric
# locationId from the URL.

WELLNESS_AIR_DEFAULT_LOCATION=89 npx -y wellness-air doctor
WELLNESS_AIR_DEFAULT_LOCATION=89 npx -y wellness-air current

That's it — no token, no signup, no telemetry. Public reads use AirGradient's token-free worldwide feed, so any locationId in that feed works out of the box.

Install in Claude Desktop / Cursor / ChatGPT Desktop / Codex

JSON Config

{
  "mcpServers": {
    "wellness-air": {
      "command": "npx",
      "args": ["-y", "wellness-air"],
      "env": {
        "WELLNESS_AIR_DEFAULT_PROVIDER": "airgradient",
        "WELLNESS_AIR_DEFAULT_LOCATION": "89"
      }
    }
  }
}

Reload your client. The agent now has 19 air-quality tools.

Tools (19 total)

Tool	Purpose
`air_agent_manifest`	Runtime contract: tool list, supported clients, env vars, recommended first calls
`air_capabilities`	Supported providers, configured providers, available metrics, privacy modes
`air_connection_status`	Health check + warnings the agent should surface
`air_privacy_audit`	What is logged locally vs sent to providers
`air_data_inventory`	Metric catalog + AQI band thresholds
`air_current_reading`	Latest sensor reading (PM2.5, CO₂, AQI, temp, humidity)
`air_list_devices`	List devices on an authenticated provider account (AirThings)
`air_aqi_check`	Fast 'is the air OK?' answer with band + recommendation
`air_daily_summary`	Synthesized daily snapshot
`air_compare_locations`	Compare AQI across 2-10 locations
`air_search_public_sensors`	Discovery helper for AirGradient public map
`air_quickstart`	Personalized 3-step setup walkthrough based on current env state
`air_profile_get`	Read the shared Delx Wellness profile (location, sensitivities, units)
`air_profile_update`	Persist a non-secret patch to the shared wellness profile (explicit intent required)
`air_onboarding`	11-question onboarding flow for the shared wellness profile
`air_demo`	Realistic example payloads — preview output before configuring anything
`air_health_recommendation`	PM2.5/CO₂/VOC → WHO/EPA bands + plain-language actions
`air_health_bands`	Classify PM2.5/PM10/CO₂/VOC into WHO 2021 / EPA / ASHRAE / UBA bands + citations
`air_trend`	Windowed trend analysis (mean/median/rate-of-change/peaks) for PM2.5/CO₂/VOC

Why local-first?

Public sensors require zero auth. AirGradient runs an open public API; just pass a locationId.
Owned-sensor tokens stay on your machine. Set AIRGRADIENT_API_TOKEN only if you own a sensor.
No telemetry. wellness-air never phones home. The only outbound calls go to the providers you configure.
Read-only. No tool mutates anything upstream. (air_profile_update writes only to your local shared wellness profile, never to a provider, and requires explicit user intent.)

Cross-connector wedge

Where this gets interesting: pair it with the rest of the Delx Wellness stack.

Code

WHOOP recovery 47   +   wellness-air AQI 132 (unhealthy_sensitive)
       ↓                          ↓
   Coach: "Recovery's low AND the bedroom AQI was unhealthy last night.
           Skip outdoor cardio today — try mobility + low-intensity strength indoors with HEPA running."

Most agents miss the room-quality variable entirely. wellness-air closes that gap.

Privacy

Run wellness-air doctor to inspect the local privacy posture. Highlights:

All readings cached under ~/.wellness-air (configurable).
Provider tokens never returned to the agent.
No biometric data — environmental only.
Tool outputs explicitly tagged with their data source for downstream auditability.

Roadmap

Shipped: AirGradient (public + owned) · AirThings · PurpleAir adapters · WHO/EPA/ASHRAE/UBA health bands · windowed trend analysis (air_trend) · shared Delx Wellness profile + onboarding.

Next:

IQAir AirVisual + Awair adapters.
Cross-correlation helper (e.g. air_correlate_with_sleep) against the rest of the Delx Wellness stack.
Webhook trigger for AQI thresholds (agent gets notified when AQI crosses a band).

📧 Contact & Support

📨 support@delx.ai — general questions, integration help, partnerships
🐛 Bug reports / feature requests — GitHub Issues
🐦 Updates — @delx369 on X
🌐 Site — wellness.delx.ai

License

MIT — see LICENSE.

Skill or MCP

Same package, two doors. MCP registers tools on stdio/HTTP. The skill can drive the same tools through the CLI when the client has no MCP:

Terminal

npx -y wellness-air call air_connection_status --json '{}'

Copy skill/SKILL.md into your agent skills dir.

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads

885

Package downloads in the last 30 days.

Last commit

9d ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Wellness Air

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "wellness-air": { "command": "npx", "args": ["-y", "wellness-air"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/wellness-air?style=directory)](https://allmcps.com/mcp/wellness-air)

HTML Embed

<a href="https://allmcps.com/mcp/wellness-air"><img src="https://allmcps.com/api/badge/wellness-air?style=directory" alt="Wellness Air on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

56Quality signal: Good · 56/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools25/30

Adoption & activity7/15

Community engagement0/10

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Wellness Air →Install in Claude Desktop Install in Cursor Install in VS Code

Wellness Air

Quick Install

Client Config & Setup

Documentation Overview

Wellness Air

Local-first air-quality MCP for AI agents. Plug an AirGradient/AirThings/PurpleAir sensor into your agent — no tokens leave your machine.

HTTP (v2 stateless)

Overview

Try It In 60 Seconds

Install in Claude Desktop / Cursor / ChatGPT Desktop / Codex

Tools (19 total)

Why local-first?

Cross-connector wedge

Privacy

Roadmap

📧 Contact & Support

License

Skill or MCP

Related MCP Servers

Adoption & maintenance

Reviews

Frequently Asked Questions about Wellness Air

AllMCPs Directory Badge

Technical Specs & Signals

Moxie Docs MCP

Own this project?

Share & Embed

Explore more

Wellness Air

Quick Install

Client Config & Setup

Documentation Overview

Wellness Air

Local-first air-quality MCP for AI agents. Plug an AirGradient/AirThings/PurpleAir sensor into your agent — no tokens leave your machine.

HTTP (v2 stateless)

Overview

Try It In 60 Seconds

Install in Claude Desktop / Cursor / ChatGPT Desktop / Codex

Tools (19 total)

Why local-first?

Cross-connector wedge

Privacy

Roadmap

📧 Contact & Support

License

Skill or MCP

Related MCP Servers

Adoption & maintenance

Reviews

Frequently Asked Questions about Wellness Air

AllMCPs Directory Badge

Technical Specs & Signals

Moxie Docs MCP

Own this project?

Share & Embed

Explore more

Local-first air-quality MCP for AI agents.
Plug an AirGradient/AirThings/PurpleAir sensor into your agent — no tokens leave your machine.

Local-first air-quality MCP for AI agents.
Plug an AirGradient/AirThings/PurpleAir sensor into your agent — no tokens leave your machine.