Skip to content
MCP server

Openaq MCP Server

Find air-quality stations and read pollutant observations from government monitors via…

Install
Pricing
Open source
Runs
Locally or Remotely
Version
0.4.1
Listing updated
5 days ago

About Openaq MCP Server

Openaq MCP Server is an open-source MCP server. It can run locally on your machine or as a hosted remote server.

Find air-quality stations and read pollutant observations from government monitors via OpenAQ v3.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://openaq.caseyjhand.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "openaq-mcp-server": {
      "url": "https://openaq.caseyjhand.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "openaq-mcp-server": {
      "type": "http",
      "url": "https://openaq.caseyjhand.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "openaq-mcp-server": {
      "type": "http",
      "url": "https://openaq.caseyjhand.com/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • OPENAQ_API_KEYOpenAQ v3 API key, sent as the X-API-Key header. Free from openaq.org.Required
  • OPENAQ_API_BASE_URLOpenAQ v3 API base URL override (testing / proxy).
  • CANVAS_PROVIDER_TYPESet to 'duckdb' to enable DataCanvas SQL over large measurement series.
  • OPENAQ_ENABLE_CANVAS_DROPEnable deletion of complete staged canvases; requires CANVAS_PROVIDER_TYPE=duckdb.
  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
  • OPENAQ_API_KEYOpenAQ v3 API key, sent as the X-API-Key header. Free from openaq.org.Required
  • OPENAQ_API_BASE_URLOpenAQ v3 API base URL override (testing / proxy).
  • CANVAS_PROVIDER_TYPESet to 'duckdb' to enable DataCanvas SQL over large measurement series.
  • OPENAQ_ENABLE_CANVAS_DROPEnable deletion of complete staged canvases; requires CANVAS_PROVIDER_TYPE=duckdb.
  • MCP_HTTP_HOSTThe hostname for the HTTP server.
  • MCP_HTTP_PORTThe port to run the HTTP server on.
  • MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.
  • MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'.
  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').

Pricing

Open source

Openaq MCP Server FAQ

Is Openaq MCP Server free?

Yes. Openaq MCP Server is open source, so you can use and self-host it for free.

How do I add Openaq MCP Server to Claude Code?

Run this command in your terminal: claude mcp add --transport http openaq-mcp-server https://openaq.caseyjhand.com/mcp

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers