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 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-08-25 · ★ 2 · #64 OF 120 MAINTAINED DEVOPS & MONITORING · VERIFIED 2026-09-18

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-09-17

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.8 · 2026-08-25

mcp-ts-core 0.12.3 and the SDK v2 wire surface · Every HTTP endpoint also serves protocol revision 2026-07-28; resources/subscribe is advertised and backed · Tool arguments are strict: an undeclared root-level key is…

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…

04 · Who maintains Openaq MCP Server

openaq-mcp-server is maintained by cyanheads. We track 125 MCP servers from cyanheads - 119 actively maintained, 1,816 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 #64 of 120 actively-maintained DevOps & monitoring servers as of 2026-09-18.
release cadence: 7 releases in the last 90 days (latest 2026-08-25)
registry: io.github.cyanheads/openaq-mcp-server (active, first published 2026-06-14 · 9 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-18, its last commit was 2026-08-25 and it shipped 7 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-09-17; 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 · GCP Platform Engineer · Process · Dynatrace · Dynatrace Managed MCP

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