Atmy air quality
PM2.5 now, daily history, forecast and country rankings for 300+ cities from citizen sensors.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
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
1.0.0stdioRemote endpoints
https://api.atmy.ai/mcpstreamable-httpWhat it can do
Tool inventory
Tools (5)
π’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
Evidence