city-air-quality-checker

Fetches real-time air quality index (AQI) and key pollutant information for a specified city using the Open-Meteo Air Quality API.

Features

• Get current AQI and pollutant measurements (PM10, PM2.5, O3, NO2, SO2, CO) for any city worldwide.
• Powered by free, public APIs (no API key required).
• Fast and robust error-handling.

Installation & Usage

With npx:

npx @dennisk2025/city-air-quality-checker

Or install globally:

npm install -g @dennisk2025/city-air-quality-checker
city-air-quality-checker

As a dependency:

npm install @dennisk2025/city-air-quality-checker

Adding to Claude Desktop

Add this JSON to your Claude Desktop config file at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "city-air-quality-checker": {
      "command": "npx",
      "args": ["@dennisk2025/city-air-quality-checker"]
    }
  }
}

Usage Example: Tools

Tool: get_city_air_quality

Description: Given a city name, returns the current AQI and key pollutant measurements (pm10, pm2.5, o3, no2, so2, co) for that location if available.

Parameters:

• city (string, required): The name of the city (e.g., 'Madrid', 'Berlin').

Example Tool Call

Request:

{
  "name": "get_city_air_quality",
  "arguments": {
    "city": "Berlin"
  }
}

Example Response:

{
  "city": "Berlin",
  "country": "Germany",
  "latitude": 52.52,
  "longitude": 13.405,
  "time": "2024-04-19T09:00",
  "AQI": 45,
  "pollutants": {
    "pm10": 11.4,
    "pm2_5": 7.2,
    "o3": 48.1,
    "no2": 8.0,
    "so2": 2.0,
    "co": 220.0
  },
  "AQI_indexes": {
    "us_aqi": 45,
    "eu_aqi": null,
    "epa_aqi": null
  },
  "source": "Open-Meteo Air Quality API"
}

Available Tools

1. get_city_air_quality

• Input:
  • city (string, required): The name of the city (e.g., "Madrid", "Berlin").
• Output:
  • Current AQI (if available)
  • Measurements for PM10, PM2.5, O3, NO2, SO2, and CO
  • City and country name, coordinates, and data timestamp
• Errors:
  • If the city is not found or data is unavailable, a descriptive error message is returned.

API Source

• Open-Meteo Air Quality API

License

MIT