`observations_in_bbox`

Pack: airnow · Endpoint: https://gateway.pipeworx.io/airnow/mcp

Historical AQI observations inside a bounding box for a date range. Specify pollutants as comma-separated parameter codes (e.g., “OZONE,PM25,PM10,CO,NO2,SO2”). bbox format: “minLon,minLat,maxLon,maxLat”.

Parameters

Name	Type	Required	Description
`bbox`	string	yes	minLon,minLat,maxLon,maxLat
`start_date`	string	yes	YYYY-MM-DDT00 (hour-granular ISO truncated)
`end_date`	string	yes	YYYY-MM-DDT23
`parameters`	string	no	Comma-separated pollutants (default: OZONE,PM25,PM10)
`data_type`	string	no	A (AQI) \| C (concentration) \| B (both, default)
`verbose`	boolean	no	Include site / county / agency / full-AQS-code fields

Example call

Arguments

{
  "bbox": "-74.1,40.6,-73.9,40.8",
  "start_date": "2025-01-10T00",
  "end_date": "2025-01-10T23"
}

curl

curl -X POST https://gateway.pipeworx.io/airnow/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"observations_in_bbox","arguments":{"bbox":"-74.1,40.6,-73.9,40.8","start_date":"2025-01-10T00","end_date":"2025-01-10T23"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('observations_in_bbox', {
  "bbox": "-74.1,40.6,-73.9,40.8",
  "start_date": "2025-01-10T00",
  "end_date": "2025-01-10T23"
});

More examples

{
  "bbox": "-118.3,34.0,-118.2,34.1",
  "start_date": "2025-01-08T00",
  "end_date": "2025-01-10T23",
  "parameters": "OZONE,PM25,NO2",
  "data_type": "A",
  "verbose": true
}

Response shape

Always returns: bbox, count, observations

Field	Type	Description
`bbox`	string	Bounding box queried (minLon,minLat,maxLon,maxLat)
`count`	integer	Number of observations returned
`observations`	array	Historical AQI observations in bounding box

Full JSON Schema

{
  "type": "object",
  "properties": {
    "bbox": {
      "type": "string",
      "description": "Bounding box queried (minLon,minLat,maxLon,maxLat)"
    },
    "count": {
      "type": "integer",
      "description": "Number of observations returned"
    },
    "observations": {
      "type": "array",
      "description": "Historical AQI observations in bounding box",
      "items": {
        "type": "object",
        "properties": {
          "observed_date": {
            "type": [
              "string",
              "null"
            ],
            "description": "Date observed (YYYY-MM-DD)"
          },
          "hour": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Hour observed (0-23)"
          },
          "utc": {
            "type": [
              "string",
              "null"
            ],
            "description": "UTC timestamp"
          },
          "site": {
            "type": [
              "string",
              "null"
            ],
            "description": "Monitoring site name"
          },
          "agency": {
            "type": [
              "string",
              "null"
            ],
            "description": "Reporting agency name"
          },
          "aqs_code": {
            "type": [
              "string",
              "null"
            ],
            "description": "Full AQS code identifier"
          },
          "latitude": {
            "type": [
              "number",
              "null"
            ],
            "description": "Site latitude"
          },
          "longitude": {
            "type": [
              "number",
              "null"
            ],
            "description": "Site longitude"
          },
          "pollutant": {
            "type": [
              "string",
              "null"
            ],
            "description": "Pollutant parameter name"
          },
          "aqi": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Air Quality Index value"
          },
          "category": {
            "type": [
              "integer",
              "null"
            ],
            "description": "AQI category numeric code"
          },
          "value": {
            "type": [
              "number",
              "null"
            ],
            "description": "Pollutant concentration value"
          },
          "unit": {
            "type": [
              "string",
              "null"
            ],
            "description": "Unit of measurement"
          }
        }
      }
    }
  },
  "required": [
    "bbox",
    "count",
    "observations"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "airnow": {
      "url": "https://gateway.pipeworx.io/airnow/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

observations_in_bbox