What is mcp-airq CLAUDE.md?

Project instructions for the mcp-airq server, which connects an agent to air-Q sensors on a local network. They explain its architecture, configuration, modules, and sensor tools.

Guiding development, testing, configuration, and maintenance of the mcp-airq project.

They provide the codebase context needed to make changes safely and understand how the server communicates with the devices.

How CorantGmbH/mcp-airq configures Claude Code

Reuse

Borrowing it

Nothing to install: this file belongs to CorantGmbH/mcp-airq. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/CorantGmbH/mcp-airq/main/CLAUDE.md

Clone the repo

git clone --depth 1 https://github.com/CorantGmbH/mcp-airq

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/corantgmbh/mcp-airq/claude-md/github.svg)](https://agentmods.dev/instructions/corantgmbh/mcp-airq/claude-md)

Your own site

<a href="https://agentmods.dev/instructions/corantgmbh/mcp-airq/claude-md"><img src="https://agentmods.dev/badge/instructions/corantgmbh/mcp-airq/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/instructions/corantgmbh/mcp-airq/claude-md"><img src="https://agentmods.dev/badge/instructions/corantgmbh/mcp-airq/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 1,218 This file is loaded in full into every session.

When invoked 1,218 The same file — it is already loaded in full.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.01218	$0.01218
Opus 5	$0.00609	$0.00609
Sonnet 5	$0.00244	$0.00244
Haiku 4.5	$0.00122	$0.00122

Measured 9d ago against content hash c0c3e83e17e1, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

mcp-airq CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 109 lines

How it starts

The opening of the file, as written. The whole thing — 109 lines — stays where its author put it; the contents beside it link to each section on GitHub.

CLAUDE.md

Project Overview

MCP (Model Context Protocol) server for air-Q air quality sensor devices. Enables Claude Desktop, Claude Code, and other MCP clients to query and configure air-Q devices on the local network.

Built as a thin tool layer on top of aioairq (the official async Python library for air-Q).

Architecture

Claude Desktop/Code/Web
    └── MCP Client (JSON-RPC 2.0 over STDIO)
            └── mcp-airq (this project)
                    └── aioairq → air-Q device(s) via HTTP + AES-256

Key Modules

Module	Purpose
`server.py`	FastMCP instance, lifespan (aiohttp session), entry point
`config.py`	Loads device config from `AIRQ_DEVICES` env var or `AIRQ_CONFIG_FILE`
`devices.py`	`DeviceManager`: caches `AirQ` instances, resolves device names (substring match)
`errors.py`	`@handle_airq_errors` decorator — catches aioairq exceptions, returns readable strings
`tools/_helpers.py`	Shared helpers: `_manager()`, `_resolve()`, `_json()`
`tools/read.py`	11 read-only tools (list_devices, get_air_quality, get_air_quality_history, get_device_info, get_config, get_logs, identify_device, get_led_theme, get_possible_led_themes, get_night_mode, get_brightness_config)
`tools/write.py`	5 write tools (set_device_name, set_led_theme, set_night_mode, set_brightness, configure_network)
`tools/dangerous.py`	2 destructive tools (restart_device, shutdown_device)

Design Patterns

Lifespan: aiohttp.ClientSession is created/closed in app_lifespan(). The DeviceManager is yielded as the lifespan context and accessed in tools via ctx.request_context.lifespan_context.
Error handling: The @handle_airq_errors decorator wraps all tool functions. It catches InvalidAuth, APIAccessDenied, ClientError, TimeoutError and returns user-friendly strings instead of crashing the MCP session.
ToolAnnotations: Every tool is annotated with readOnlyHint, destructiveHint, and idempotentHint for correct client behavior.
Multi-device: Each tool has an optional device: str | None parameter. Single-device setups auto-resolve; multi-device uses case-insensitive substring matching.

Read the full file on GitHub · 109 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

9d ago First seen · 109 lines · 1,218 tokens per session scan A c0c3e83e17e1

Subscribe to this mod's changes

mcp-airq CLAUDE.md is an instructions file published in the GitHub repository CorantGmbH/mcp-airq (0 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 1,218 tokens to every session, about $0.0061 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Hardware and IoT

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,296 tokens

codex AGENTS.md

AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.

openai/codex · 5,153 tokens

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 6,785 tokens

mcp-airq: Instructions file for Claude Code