Openaq MCP Server

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

Remote serverstreamable-httpPython

What is the Openaq MCP Server?

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

What the server does

  • Declarative tool and resource definitions — single file per primitive, framework handles registration and validation
  • Unified error handling — handlers throw, framework catches, classifies, and formats
  • Typed error contracts per tool — each network tool declares reason/code/when/recovery, so failures carry a concrete next move
  • Pluggable auth (none, jwt, oauth) and structured, request-scoped logging with optional OpenTelemetry tracing
  • STDIO and Streamable HTTP transports from one codebase
  • Hides the v3 location → sensor → measurement hierarchy — openaq_get_measurements resolves a station + parameter to the underlying sensor; openaq_get_readings joins the latest feed against the sensor map so every value is labeled

Credentials and setup notes

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
openaq_find_locationsFind 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.
openaq_get_readingsLatest measured value for every sensor at a station, each joined with its pollutant and unit. The current-conditions tool.
openaq_get_measurementsHistorical series for one pollutant at one station over a date range, with raw/hourly/daily aggregation. Large ranges spill to a DataCanvas.
openaq_list_parametersCatalog of measurable pollutants and their canonical units. The unit-disambiguation reference.
openaq_list_countriesCatalog of country-level coverage — data span and parameters measured, filterable by parametersId to answer "which countries measure this pollutant?". An availability check before a regional sweep.
openaq_dataframe_describeList the tables and columns staged on a DataCanvas so you can write valid SQL.
openaq_dataframe_queryRun a read-only SELECT over staged measurement series.

How to install the Openaq MCP Server

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

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
MCP_TRANSPORT_TYPEConfiguration value read at startup.Optional
OPENAQ_API_KEYCredential the server authenticates with.Yes
CANVAS_PROVIDER_TYPEConfiguration value read at startup.Optional
OPENAQ_API_BASE_URLEndpoint or connection string the server talks to.Yes

Example prompts to try

  • “Use Openaq to openaq find locations.”
  • “Use Openaq to openaq get readings.”
  • “Use Openaq to openaq get measurements.”

Frequently asked questions

Find air-quality stations and read pollutant observations from government monitors via OpenAQ v3. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.