IQAir MCP for AI. Audit global air quality and weather metrics instantly.
Works with every AI agent you already use
…and any MCP-compatible client








Connect to your AI in seconds.
IQAir MCP provides access to real-time air quality indices (AQI) and current weather data globally. This connector allows your agent to audit pollution levels, check atmospheric pressure, and retrieve environmental metrics for specific cities or the location nearest you.
It includes tools to list all supported countries, states, and cities before running a query.
What your AI can do
Check api status
Confirms if the IQAir API service is currently running and available for data retrieval.
Get city air quality
Retrieves real-time air quality indices and weather details for a specific, named city.
Get nearest city air quality
Gets the current AQI and weather data for the monitored city closest to your device's IP address.
Get real-time AQI and atmospheric metrics for either a specific city or the location nearest to your IP address.
List all supported countries, states, and cities in the catalog to define where you need to run a query.
Check if the underlying IQAir service is currently operational before running expensive data queries.
Ask an AI about this
Waiting for input…
IQAir: 6 Available Tools
These tools allow you to scope, list, and retrieve current air quality indices (AQI) and weather data from around the world.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using IQAir on VinkiusCheck Api Status
Confirms if the IQAir API service is currently running and available for data retrieval.
Get City Air Quality
Retrieves real-time air quality indices and weather details for a specific, named...
Get Nearest City Air Quality
Gets the current AQI and weather data for the monitored city closest to your...
List Supported Cities
Provides a list of all cities that have monitoring coverage within a specified state...
List Supported Countries
Returns a list of every country IQAir monitors for environmental data.
List Supported States
Lists all states that have coverage within a specific, chosen country.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with IQAir, then connect any of our 5,000+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,000+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by IQAir. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This connection provides 6 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Manual Environmental Data Auditing Is a Time Sink
Today, gathering air quality data is messy. You have to manually visit one site for the country list, another site for state boundaries, and then copy-paste city names into third APIs just to get the current AQI reading. If you're tracking pollution across multiple sites or regions, this means hours of cross-referencing spreadsheets and constantly checking if an API key is valid.
With this MCP, your agent manages the entire sequence. You simply ask for a comparative audit. The system handles the geographic discovery, validates the location names using tools like `list_supported_countries`, and returns one unified report that includes both weather and pollution metrics.
IQAir MCP: Immediate Access to Global Metrics
The biggest manual step away is the parameter validation. You no longer have to assume a city name will work; you can use `list_supported_cities` to check its existence and scope before running the query.
What's different now is efficiency. Instead of building multi-step, brittle code to handle location lookups, your agent runs a single prompt and gets actionable environmental intelligence immediately.
What your AI can actually do with this
You run into complex research problems—say, mapping pollutant hotspots across an entire region. Before this MCP, getting that data meant jumping between multiple geo-data portals, manually cross-referencing city names, and writing custom code for every specific API endpoint you needed to hit. Now, your agent handles the whole thing conversationally.
You simply ask it: 'What's the air quality in Sao Paulo compared to Campinas?' The MCP orchestrates the complex search across thousands of data points, instantly giving you real-time AQI and weather conditions. This works regardless of whether you are a climate researcher or just checking local health risks. Since Vinkius hosts this connection, your agent can access all these environmental tools from one place.
You get accurate, localized pollution readings without writing a single line of API integration code.
019d8449-627c-7017-b8a9-9dbcc3177de0 Here's how it actually works
The bottom line is that you get structured access to global environmental data without managing API keys or endpoints yourself.
Subscribe to this MCP and enter your unique IQAir API Key.
Connect your preferred client (Claude, Cursor, etc.) through the Vinkius platform.
Invoke a function—for example, using list_supported_countries—to define the required geographic scope.
Who is this actually for?
Environmental researchers, public health analysts, and corporate sustainability leads use this MCP. They need a single point of truth for current pollution metrics across diverse geographic areas, eliminating the manual work of data aggregation.
Verifies local air quality trends near specific hospitals or population centers to assess respiratory risk during an outbreak.
Runs large-scale audits by listing supported states and cities to map pollution patterns for a climate study.
Performs rapid environmental assessments of corporate sites globally, ensuring compliance with air quality standards.
What Changes When You Connect
Pinpoint local issues: Use get_nearest_city_air_quality to check the air quality in your immediate area without knowing the city name beforehand.
Structure large audits: Run list_supported_countries, then list_supported_states, and finally list_supported_cities to build a perfect list of locations for mass querying.
Target specific data points: Call get_city_air_quality when you need precise, real-time AQI readings for an exact location in the world.
Stay operational: Always run check_api_status first. This confirms your environmental research workflow isn't going to fail because of a temporary API outage.
Understand scope limitations: Use list_supported_countries when you need to know if IQAir even monitors the country you plan to audit.
See it in action
Assessing immediate health risks
A public health analyst gets an alert about unusual pollution near a neighborhood. They ask their agent, 'What is the air quality right here?' The agent uses get_nearest_city_air_quality and reports the AQI and main pollutant (e.g., PM2.5) instantly.
Mapping regional pollution sources
A climate researcher needs data for a whole region, not just one city. They use list_supported_countries to verify scope, then call list_supported_states, and finally query multiple cities using get_city_air_quality in sequence.
Validating corporate site compliance
A sustainability lead needs to audit three factory locations across different states. They use the scoping tools (list_supported_states) to confirm coverage, then run get_city_air_quality for each location to generate a compliance report.
The honest tradeoffs
Querying without scope check
Trying to ask the agent for 'Air quality in New Atlantis' when that city isn't monitored. The query fails, wasting time and compute cycles.
Before querying any specific location, always run list_supported_countries, then use list_supported_states to narrow down the region, and finally confirm with list_supported_cities. This guarantees the target exists.
Assuming global coverage
Using a city's name from general search results without confirming IQAir supports it. The agent returns an error or irrelevant data.
Run list_supported_countries first to check if the nation is supported at all. This validates your entire research effort upfront.
When It Fits, When It Doesn't
Use this MCP if your primary need is current, real-time environmental metrics (AQI, weather). You're asking 'What is it like right now?' Don't use it if you are trying to build a historical trend model; for that, you need an external data warehouse. Also, don't use the listing tools (list_supported_*) as your final answer—only use them to validate parameters before calling get_city_air_quality or get_nearest_city_air_quality. If you only need basic weather without AQI, check other generic data connectors instead.
Questions you might have
How do I check the air quality for my current location using get_nearest_city_air_quality? +
Simply invoke get_nearest_city_air_quality. It uses your IP address to identify the closest monitored city and returns both the real-time AQI and weather data, saving you from manual lookups.
Do I need to use list_supported_countries before querying a specific place? +
No, but it’s smart practice. Running list_supported_countries first confirms that the nation you plan to audit is covered by IQAir at all, preventing an immediate API failure.
What if I want data for multiple cities in one state? +
First, use list_supported_states to confirm coverage. Then, call list_supported_cities with the state name to get every city ID you need before running batch queries using get_city_air_quality.
Is there a way to check if this MCP connection is working? +
Yes, run check_api_status. This tool verifies the entire IQAir API pipeline is operational before you start your research workflow. It's good preventative maintenance.
What format do I need for the city name when using get_city_air_quality? +
The function requires the official, full names of both the city and the state/country. If you aren't sure which naming convention to use, always run list_supported_cities first. This confirms that your specific location inputs are valid for the IQAir catalog.
What is the proper workflow order when listing locations using list_supported_states? +
You must start by calling list_supported_countries to get a valid country code. Then, use that code with list_supported_states. This ensures your request for states always targets an officially recognized region.
If I run get_city_air_quality and the data is missing, what should I check first? +
First, verify that the API service is active by checking the status using check_api_status. If the service is online, the issue usually means the specified location name or date isn't supported, so double-check your inputs.
Are there any usage limits or rate restrictions when running many queries with this MCP? +
Yes, the underlying data source has operational usage thresholds. For large data pulls, group related calls together for efficiency. If you encounter a limit error, wait a short period and then try your workflow again.
How do I find my IQAir API Key? +
Log in to your IQAir dashboard, create a new key in the API section, and copy it. Copy and paste it below.
Does the agent use the server's IP for nearest city? +
Yes. The get_nearest_city_air_quality tool automatically uses the requester's IP address to identify and audit the nearest monitored location.
Are weather details included with air quality? +
Yes. Every city data retrieval includes current weather metadata such as temperature, humidity, and atmospheric pressure alongside the AQI.
We've already built the connector for IQAir. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 6 tools are live and waiting.
You're up and running in seconds.
Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.