Introduction

Talk to your buildings. The Airthings MCP connector lets AI assistants such as Claude, ChatGPT and Microsoft Copilot read your Airthings workspace and answer questions about your buildings in plain language. No API integration, no digging through dashboards, no CSV exports.

Ask "How was the air at HQ last month?" and get a scored answer, the rooms that dragged it down, and the data behind it.

Note: MCP (Model Context Protocol) is an open standard for connecting AI assistants to external data. The Airthings MCP is read-only: it can look, but it can't touch.

What you can ask

"How's the air right now?"

Live readings for a single device, a room or an entire building: CO₂, radon, PM, temperature, humidity, VOC and more.

"Is the CO₂ OK in the meeting rooms at HQ right now?"

"How did the building do?"

Two scores, two different jobs (see Two scores, never blended):

  • Airthings IAQS building score: a monthly 0–100 score with three sub-scores (Safety, Productivity and Comfort), counted over opening hours only. It also names the spaces that pulled the score down. Safety is never averaged away: if safety is poor, the overall score is poor.
  • GO IAQS: the Global Open Indoor Air Quality Standards, a published, independent standard. Get the live GO IAQS Score per room, or a GO IAQS Report showing the share of occupied hours that were healthy vs unhealthy against the standard's Ultimate limits.

"What was the Airthings IAQS score for HQ in October, and which rooms pulled it down?"
"Give me a GO IAQS report for the school for last term."

"What happened, and when?"

Historical trends, min/max/average statistics, building-level IAQ summaries and calibrated long-term radon reports. Useful for complaints, audits and regulatory checks.

"Someone in the east wing complained about stuffy air last week. Build me an evidence package."

"Is my fleet healthy?"

Offline devices, low or dislodged batteries, weak signal and hub load, for one building or across your whole portfolio in a single question.

"Which of my buildings need a maintenance visit?"

Beta: data-delivery history, battery time-to-empty estimates and sampling configuration history. These help answer "why is this battery draining so fast?"

"How do I fix it?"

The assistant can search the Airthings Help Center and pull up troubleshooting steps for the issue in front of you.

Two scores, never blended

Airthings IAQS building scoreGO IAQS
Defined byAirthingsGO AQS, an open, independent coalition
Output0–100, with Safety, Productivity and Comfort sub-scoresLive Score per room (0–10), or a Report: % of occupied hours healthy
Time windowOne closed calendar month, opening hours onlyRight now (Score) or any date range, occupied hours (Report)
Sensors usedRadon, PM2.5, PM10, CO₂, temperature, humidity, noisePM2.5, CO₂ and radon (the parts of the standard Airthings devices measure)
Best forTracking and comparing your own buildings over timeReporting against an external, published benchmark

The assistant always reports these separately. GO IAQS is only used when you ask for it by name, or ask for an external standard.

Access and security

  • Sign in with your Airthings account. The assistant only sees accounts and locations where you have the Admin role. The User role isn't enough for MCP.
  • An active Airthings for Business subscription is required.
  • Strictly read-only: no device settings, moves, writes or deletes.
  • The assistant refers to devices and buildings by name. Serial numbers and internal IDs stay internal.

Sensor keys, units and query limits are listed on the Tools page.


Did this page help you?