- LOCAL
- REMOTE
- ADVISORY
- HUMAN
Short answer
Can my AI check the air quality where I am?
Yes. Your agent uses IQAir to fetch real-time AQI and weather metrics for your immediate location or a specific city you name. You'll get live updates on air health and local weather conditions.
Where every update lands.
Real-time environmental insights
Your agent turns raw AQI data into actionable information.
LOCAL
Current location checks
The AI identifies your nearest city and pulls the latest air quality index. You get immediate context for the air you're breathing right now.
REMOTE
City-specific lookups
Ask about any city in the world. Your agent pulls the specific AQI and weather stats for that destination.
ADVISORY
Health-based summaries
The AI interprets the AQI numbers to tell you if it's safe to go outside or if you should keep windows closed.
HUMAN
Personal decisions
The AI provides the data, but you decide if you need to wear a mask or stay indoors based on the numbers.
The workflow
What your AI does when you ask for air data.
The agent handles the data fetching so you don't have to open a browser.
Identify location
The agent finds the air quality data for the city closest to your current position.
get_nearest_city_air_qualityTarget specific cities
If you ask about a different place, the agent fetches the metrics for that specific city instead.
get_city_air_qualityAnalyze metrics
The agent looks at the AQI and weather values to understand the current environmental state.
get_city_air_qualityReport findings
The agent presents the AQI levels and weather details in a plain text summary for you.
get_nearest_city_air_quality
Try it
Copy these to start.
Use these prompts to trigger the IQAir tools.
Starting points
These are basic requests. You can swap out the cities or specific metrics like temperature.
IQAir Connector
You're all set. Choose your MCP client and follow the setup instructions.
https://edge.vinkius.com/vk_preview_JCjmdGZ7DsshUYFxHI0BydM57Q1WVp8TR4MW1paZ/mcpClaude Desktop
Follow the steps below to connect in seconds.
- 1In Claude Desktop, open Settings → Connectors.
- 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
- 3Click Add and start a new chat — IQAir capabilities are ready to use.
{
"mcpServers": {
"iqair-mcp": {
"url": "https://edge.vinkius.com/vk_preview_JCjmdGZ7DsshUYFxHI0BydM57Q1WVp8TR4MW1paZ/mcp"
}
}
}What is the air quality like where I am right now?
Check the AQI and weather for Tokyo.
Is the air quality in New York City safe for a run today?
Give me the current weather and air quality for London.
Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline
Start here
Connect IQAir once, then ask.
Click the link to connect. Your credentials stay encrypted, and you'll be ready to chat with your agent immediately.
Connect IQAir to your AIFAQ
How this task behaves
- 01
Can the AI tell me if I should wear a mask?
The AI can provide the AQI numbers and suggest precautions based on those numbers, but the final decision to wear a mask is yours.
- 02
Can the AI change my smart home air purifier settings?
No. This MCP only reads air quality and weather data. It cannot control hardware or smart home devices.
- 03
Does it work for cities outside my country?
Yes, you can use the tool to check the air quality for any city globally.
- 04
Can the AI predict tomorrow's air quality?
No. The tools only provide real-time AQI and current weather metrics.
- 05
Can the AI delete my weather history?
No. The AI only has permission to read data from IQAir; it cannot delete or modify any external records.
More questions about IQAir? See everything the IQAir Connector can do
Connect IQAir to Claude, Cursor, ChatGPT & more
