Openaq MCP Server

@cyanheads/openaq-mcp-server Find air-quality monitoring stations, read latest sensor values, and pull historical pollutant series via MCP. STDIO or Streamable HTTP. Its 8 documented tools cover openaq, dataframe.

People who work with openaq and dataframe and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-26 · ★ 2 · #40 OF 125 MAINTAINED DEVOPS & MONITORING · VERIFIED 2026-09-30

Apache-2.0 · TypeScript servers · how we verify → /methodology

01 · Install Openaq MCP Server

before you install - you'll need

Set MCP_TRANSPORT_TYPE, OPENAQ_API_KEY before connecting.

Claude Code

claude mcp add cyanheads-openaq-mcp-server --transport http https://openaq.caseyjhand.com/mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "cyanheads-openaq-mcp-server": {
      "url": "https://openaq.caseyjhand.com/mcp"
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

https://openaq.caseyjhand.com/mcp

transport: streamable-http

endpoint NOT responding · probed 2026-09-30

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions · remote - your agent's requests go to openaq.caseyjhand.com

license Apache-2.0 - declared in the repository

npm package @cyanheads/openaq-mcp-server - published under the repo owner's npm scope (@cyanheads)

registry namespace io.github.cyanheads is GitHub-verified and matches the repo owner

03 · What Openaq MCP Server can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can find monitoring stations near a point, in a bounding box, or by country, list the tables and columns staged on a DataCanvas, run a read-only SQL SELECT over staged measurement series, and delete a complete staged canvas.

The 8 tools it gives your agent

Extracted from the project's README - what openaq-mcp-server lets an agent do.

openaq_find_locations
- Find monitoring stations near a point, in a bounding box, or by country; the location ids the other tools take
openaq_get_readings
- Latest value for every sensor at a station, labeled with its pollutant and unit
openaq_get_measurements
- Historical series for one pollutant at one station, raw or rolled up hourly/daily
openaq_list_parameters
- Pollutant catalog with canonical units; maps a pollutant and unit to its parameter id
openaq_list_countries
- Country coverage: data span and the parameters measured in each
openaq_dataframe_describe
- List the tables and columns staged on a DataCanvas
openaq_dataframe_query
- Run a read-only SQL SELECT over staged measurement series
openaq_dataframe_drop
- Delete a complete staged canvas; opt-in with OPENAQ_ENABLE_CANVAS_DROP=true

Latest releases

v0.4.1 · 2026-09-26

Native multi-architecture dependency installs · Run production dependency installs and Socket scanning on the native build platform, selecting matching DuckDB bindings for each target CPU while preserving the…

v0.4.0 · 2026-09-26

Canvas lifecycle and measurement precision · Add openaq_dataframe_drop, disabled by default and tenant-scoped when enabled; forward canvas configuration across install surfaces. · Preserve fractional measurements…

v0.3.0 · 2026-09-24

Station-local days, gap reporting, nearest-station pool · a date-only datetimeFrom/datetimeTo on openaq_get_measurements is now the station's local calendar day (was a UTC day ending T23:59:59Z); effectiveRange echoes…

04 · Who maintains Openaq MCP Server

openaq-mcp-server is maintained by cyanheads. We track 137 MCP servers from cyanheads - 131 actively maintained, 1,856 combined GitHub stars, oldest repo from Dec 2024. Full record: all servers from cyanheads.

  1. obsidian-mcp-server Read, write, search, and surgically edit Obsidian notes, tags, and frontmatter via MCP. ★ 690
  2. mcp-ts-core Agent-native TypeScript framework for MCP servers. ★ 152
  3. git-mcp-server Comprehensive Git MCP server enabling native git tools including clone, commit, worktree, & more. ★ 240
  4. clinicaltrialsgov-mcp-server Search ClinicalTrials.gov - find studies, retrieve results, match patients to eligible trials. ★ 96
  5. openalex-mcp-server Access the OpenAlex academic research catalog - 270M+ publications. ★ 14
  6. mcp-ts-template TypeScript template for building MCP servers with declarative tooling, observability, and auth. ★ 152

05 · Facts

category
DevOps & monitoring - ranked #40 of 125 actively-maintained DevOps & monitoring servers as of 2026-09-30.
release cadence
10+ releases in the last 90 days (latest 2026-09-26)
registry
io.github.cyanheads/openaq-mcp-server (active, first published 2026-06-14 · 15 versions)
packages
npm:@cyanheads/openaq-mcp-server · npm:@cyanheads/openaq-mcp-server

06 · Openaq MCP Server FAQ

Is Openaq MCP Server still maintained?

Yes - as of 2026-09-30, its last commit was 2026-09-26 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

What can Openaq MCP Server do?

With this server connected, an agent can find monitoring stations near a point, in a bounding box, or by country, list the tables and columns staged on a DataCanvas, run a read-only SQL SELECT over staged measurement series, and delete a complete staged canvas.

How do I install Openaq MCP Server?

Run `npx -y @cyanheads/openaq-mcp-server`. The README documents 2 environment variables (MCP_TRANSPORT_TYPE, OPENAQ_API_KEY) to set first. Set MCP_TRANSPORT_TYPE, OPENAQ_API_KEY before connecting. You can also paste the ready-made client config above.

Does Openaq MCP Server run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Openaq MCP Server