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 9 documented tools cover openaq, dataframe.

People connecting DevOps & monitoring tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-07-27 · ★ 2 · #46 OF 101 MAINTAINED DEVOPS & MONITORING · VERIFIED 2026-08-25

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 alive - responded to MCP initialize · probed 2026-08-25

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

endpoint auth accepted our unauthenticated MCP initialize - no credentials needed to connect

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 list the tables and columns staged on a DataCanvas so you can write valid SQL, and run a read-only SELECT over staged measurement series.

Capability map

Tools grouped from the project's README - what Openaq MCP Server lets an agent do.

Openaq

7 tools - e.g. Find monitoring stations near a point, in a bounding box, or by country. The required first step - readings and measurements key on the location id this returns; Latest measured value for every sensor at…

openaq_find_locations · openaq_get_readings · openaq_get_measurements · openaq_list_parameters · openaq_list_countries · openaq_dataframe_describe…

Aggregation

1 tool - e.g. raw (every reported value), hourly, or daily - hourly/daily add a per-bucket statistical summary (min, median, max, mean, sd)

aggregation

Truncated

1 tool - e.g. true, canvasId, and a tableName of the form measurements_.

truncated

Latest releases

v0.1.7 · 2026-07-27

Dataframe escaping, resource error contracts, 422 body parsing · openaq_dataframe_query escapes backslash/pipe/newlines in rendered Markdown table cells, including header names (#8) · openaq://location and…

v0.1.6 · 2026-07-26

measurement pipeline fixes · null bucket values (gap buckets) no longer fail output validation and lose the whole series (#11) · mixed date/datetime ranges normalize to full UTC, fixing same-day date-only ranges and…

v0.1.5 · 2026-07-26

Corrected error contracts: upstream failures now reach the client with their reason and recovery hint · Upstream 5xx/429/timeout/401 failures now carry the declared reason and recovery hint on the wire across every…

04 · Who maintains Openaq MCP Server

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

05 · Facts

repository: github.com/cyanheads/openaq-mcp-server
category: DevOps & monitoring - ranked #46 of 101 actively-maintained DevOps & monitoring servers as of 2026-08-25.
release cadence: 8 releases in the last 90 days (latest 2026-07-27)
registry: io.github.cyanheads/openaq-mcp-server (active, first published 2026-06-14 · 8 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-08-25, its last commit was 2026-07-27 and it shipped 8 releases in the last 90 days. We re-verify nightly.

What can Openaq MCP Server do?

With this server connected, an agent can list the tables and columns staged on a DataCanvas so you can write valid SQL, and run a read-only SELECT over staged measurement series.

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 require authentication?

No - the endpoint accepted our unauthenticated MCP initialize when probed on 2026-08-25; you can connect without credentials.

07 · Alternatives to Openaq MCP Server

Alternatives to Openaq MCP Server

Maintained DevOps & monitoring servers if Openaq MCP Server isn't the fit.

Pairs well with

Servers that cover what Openaq MCP Server doesn't - only shown when the pairing reason fits the companion.

More DevOps & monitoring MCP servers · Uptime Kuma · Process · Dynatrace MCP · Taskbounty Check · Go Model

More TypeScript MCP servers · Openfda MCP Server · Openfec MCP Server · Openlibrary MCP Server · Openstreetmap MCP Server · Orcid MCP Server · see all