Wellness MCP Server

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

Local serverstdioGo

What is the Wellness MCP Server?

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

What the server does

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.

  • 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.)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
air_agent_manifestRuntime contract: tool list, supported clients, env vars, recommended first calls
air_capabilitiesSupported providers, configured providers, available metrics, privacy modes
air_connection_statusHealth check + warnings the agent should surface
air_privacy_auditWhat is logged locally vs sent to providers
air_data_inventoryMetric catalog + AQI band thresholds
air_list_devicesList devices on an authenticated provider account (AirThings)
air_daily_summarySynthesized daily snapshot
air_compare_locationsCompare AQI across 2-10 locations
air_search_public_sensorsDiscovery helper for AirGradient public map
air_quickstartPersonalized 3-step setup walkthrough based on current env state
air_profile_getRead the shared Delx Wellness profile (location, sensitivities, units)
air_profile_updatePersist a non-secret patch to the shared wellness profile (explicit intent required)
air_onboarding11-question onboarding flow for the shared wellness profile
air_demoRealistic example payloads — preview output before configuring anything

How to install the Wellness MCP Server

{
  "mcpServers": {
    "wellness-air": {
      "command": "npx",
      "args": ["-y", "delx-wellness-hermes"],
      "env": {
        "WELLNESS_AIR_DEFAULT_PROVIDER": "your-value",
        "WELLNESS_AIR_DEFAULT_LOCATION": "your-value",
        "AIRGRADIENT_API_TOKEN": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
WELLNESS_AIR_DEFAULT_PROVIDERConfiguration value read at startup.Optional
WELLNESS_AIR_DEFAULT_LOCATIONConfiguration value read at startup.Optional
AIRGRADIENT_API_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • “Use Wellness to air agent manifest.”
  • “Use Wellness to air capabilities.”
  • “Use Wellness to air connection status.”

Frequently asked questions

Local-first air-quality MCP for AI agents — AirGradient, AirThings, PurpleAir, IQAir, Awair. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.