Atmy air quality

PM2.5 now, daily history, forecast and country rankings for 300+ cities from citizen sensors.

Should I use this

Quality & Safety

A
Description quality
96%
Schema completeness
89%
Naming quality
100%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~1,437Tokens (tool definitions)
~2.2 KBTypical response size
Moderate attention impact (1.12% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "air-quality": {
      "command": "npx",
      "args": [
        "atmy-mcp"
      ]
    }
  }
}

Runnable packages

npmatmy-mcp1.0.0stdio

Remote endpoints

https://api.atmy.ai/mcpstreamable-http

What it can do

Tool inventory

Tools (5)

🟒 Read-only🟑 WriteπŸ”΄ Deleteβšͺ Unknown
🟒search_cities(query, country, lang, limit)

Find the cities with an Atmy air-quality summary by name (any language) or country. Returns slugs to pass to the other tools.

Input Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Part of the city name in any site language."
    },
    "country": {
      "type": "string",
      "description": "Country name or ISO code."
    },
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "ru",
        "de",
        "fr",
        "es",
        "it",
        "pt-BR",
        "pl",
        "cs",
        "hu",
        "ro",
        "bg",
        "sr",
        "id",
        "hi",
        "ja",
        "zh",
        "uz",
        "kk",
        "ky",
        "tg",
        "az",
        "ka",
        "hy",
        "tr"
      ],
      "description": "Language of city and country names and of the page link; default en."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 20
    }
  },
  "additionalProperties": false
}
🟒get_air_quality(city, country, lat, lon, lang)

PM2.5 now in a city (mean of the latest reading of each eligible sensor, at most 60 minutes old) with its US EPA category, plus the last completed day from the Atmy Data Hub. Pass city or lat/lon.

Input Schema

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City name in any of the site languages, a slug like \"russia/krasnoyarsk\", or the Atmy city id."
    },
    "country": {
      "type": "string",
      "description": "Country name, to tell apart cities with the same name."
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude; with lon, the nearest city with an Atmy summary within 50 km."
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude."
    },
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "ru",
        "de",
        "fr",
        "es",
        "it",
        "pt-BR",
        "pl",
        "cs",
        "hu",
        "ro",
        "bg",
        "sr",
        "id",
        "hi",
        "ja",
        "zh",
        "uz",
        "kk",
        "ky",
        "tg",
        "az",
        "ka",
        "hy",
        "tr"
      ],
      "description": "Language of city and country names and of the page link; default en."
    }
  },
  "additionalProperties": false
}
🟒get_air_quality_history(city, country, lat, lon, lang, ...)

Daily PM2.5 of a city from the Atmy Data Hub (UTC days, sensors after the quality check), up to 400 days back.

Input Schema

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City name in any of the site languages, a slug like \"russia/krasnoyarsk\", or the Atmy city id."
    },
    "country": {
      "type": "string",
      "description": "Country name, to tell apart cities with the same name."
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude; with lon, the nearest city with an Atmy summary within 50 km."
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude."
    },
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "ru",
        "de",
        "fr",
        "es",
        "it",
        "pt-BR",
        "pl",
        "cs",
        "hu",
        "ro",
        "bg",
        "sr",
        "id",
        "hi",
        "ja",
        "zh",
        "uz",
        "kk",
        "ky",
        "tg",
        "az",
        "ka",
        "hy",
        "tr"
      ],
      "description": "Language of city and country names and of the page link; default en."
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 400,
      "default": 30,
      "description": "How many days back."
    }
  },
  "additionalProperties": false
}
🟒get_city_forecast(city, country, lat, lon, lang, ...)

The next hours of a city: temperature, wind, humidity, precipitation and the pollution accumulation index 0–100 (how strongly the weather keeps particles near the ground). A weather estimate, not a PM2.5 forecast.

Input Schema

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City name in any of the site languages, a slug like \"russia/krasnoyarsk\", or the Atmy city id."
    },
    "country": {
      "type": "string",
      "description": "Country name, to tell apart cities with the same name."
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude; with lon, the nearest city with an Atmy summary within 50 km."
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude."
    },
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "ru",
        "de",
        "fr",
        "es",
        "it",
        "pt-BR",
        "pl",
        "cs",
        "hu",
        "ro",
        "bg",
        "sr",
        "id",
        "hi",
        "ja",
        "zh",
        "uz",
        "kk",
        "ky",
        "tg",
        "az",
        "ka",
        "hy",
        "tr"
      ],
      "description": "Language of city and country names and of the page link; default en."
    },
    "hours": {
      "type": "integer",
      "minimum": 1,
      "maximum": 72,
      "default": 24
    }
  },
  "additionalProperties": false
}
🟒get_country_ranking(country, order, settlements, limit, lang)

Cities of a country ranked by daily PM2.5 for the last completed day (Atmy Data Hub), most polluted or cleanest first.

Input Schema

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "Country name in any site language or the ISO code, e.g. \"Russia\", \"БСрбия\", \"DE\"."
    },
    "order": {
      "type": "string",
      "enum": [
        "most_polluted",
        "cleanest"
      ],
      "default": "most_polluted"
    },
    "settlements": {
      "type": "string",
      "enum": [
        "cities",
        "all"
      ],
      "default": "cities",
      "description": "Large cities only, or every settlement with enough sensors."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 10
    },
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "ru",
        "de",
        "fr",
        "es",
        "it",
        "pt-BR",
        "pl",
        "cs",
        "hu",
        "ro",
        "bg",
        "sr",
        "id",
        "hi",
        "ja",
        "zh",
        "uz",
        "kk",
        "ky",
        "tg",
        "az",
        "ka",
        "hy",
        "tr"
      ],
      "description": "Language of city and country names and of the page link; default en."
    }
  },
  "required": [
    "country"
  ],
  "additionalProperties": false
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded5 tools