`find_stations`

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

Find OpenAQ air-quality monitoring stations by location: a city or place name, coordinates+radius (nearest first), a country (ISO 3166-1 alpha-2 code), or a bounding box. Returns station id, name, country, coordinates, and the pollutants each measures (with sensor ids), plus resolved_place echoing the coordinates a city name resolved to. This is the first step for a historical series: find the station here, then pass its sensor_id to get_measurements. At least one location argument is required — the tool will not return an unfiltered global list.

Parameters

Name	Type	Required	Description
`city`	string	no	City or place name, e.g. “Delhi”, “Los Angeles”, “Kraków”. Geocoded to coordinates, then searched by radius. Add the country for ambiguous names (“Cambridge, UK”).
`latitude`	number	no	Latitude for a radius search (use with longitude).
`longitude`	number	no	Longitude for a radius search (use with latitude).
`radius_km`	number	no	Radius in km for a coordinate or city search (default 12, max 25).
`country`	string	no	ISO 3166-1 alpha-2 country code (e.g. “US”, “IN”, “GB”).
`bbox`	string	no	Bounding box “minLon,minLat,maxLon,maxLat” to search within.
`limit`	number	no	Max stations to return (1-100, default 20).
`_apiKey`	string	no	OpenAQ API key (optional; the gateway supplies one).

Example call

Arguments

{
  "city": "Delhi"
}

curl

curl -X POST https://gateway.pipeworx.io/openaq/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"find_stations","arguments":{"city":"Delhi"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('find_stations', {
  "city": "Delhi"
});

More examples

{
  "country": "US",
  "limit": 10
}

{
  "latitude": 51.5074,
  "longitude": -0.1278,
  "radius_km": 20
}

Connect

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

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

See Getting Started for client-specific install steps.

find_stations