developer-toolsapi_key

Iqair Airvisual

IQAir AirVisual provides global air quality data through its API, offering real-time and historical information on air pollution levels.

Verdict

IQAir AirVisual gives your team real-time and forecast air quality data for cities and monitoring stations worldwide. @mention it in a Space to check current AQI readings, pull historical pollution trends, or get forecasts for specific locations by city name or GPS coordinates. Teams planning outdoor events, managing field operations, or building location-aware products get the most value. You'll need an IQAir API key to connect — the free tier covers basic queries, but historical data and high request volumes require a paid plan.

Common use cases

  • Check AQI before scheduling outdoor shoots
  • Alert field teams when pollution spikes
  • Compare air quality across office locations
  • Pull historical trends for environmental reports
  • Forecast AQI for event planning decisions

Integration

Vendor
Iqair Airvisual
Category
developer-tools
Auth
API_KEY
Tools
10
Composio slug
iqair_airvisual

Tools

  • Get Air Quality Forecast Data

    Tool to retrieve air quality forecast data for a specified city, state, and country. Use after confirming location details.

  • Get Cities

    Tool to list supported cities in a specified state and country. Use when you need to retrieve cities for a given state/country.

  • Get City Air Quality

    Tool to retrieve air quality data for a specific city. Use when you need current pollution and weather data by specifying city, state, and country.

  • Get Historical AQI Data

    Tool to retrieve historical air quality data for a city. Use after confirming city, state, and country when you need AQI readings over time.

  • Get Nearest City Air Quality

    Tool to retrieve air quality data for the nearest city based on latitude/longitude or IP. Use when you have precise location data or want to geolocate an IP for air quality.

  • Get Nearest Station Air Quality

    Tool to get nearest station air quality. Use when you have GPS coordinates and need closest station’s AQI.

  • Get States

    Tool to list supported states in a specified country. Use when you need to retrieve states/provinces for a given country.

  • Get Station by ID

    Tool to fetch air quality and weather data for a specific monitoring station by ID. Use when you need detailed historical, current, and forecast data for a station.

  • Get supported countries

    Tool to list all supported countries. Use when you need to know which countries are supported by the AirVisual API.

  • Get World AQI Rankings

    Tool to retrieve a ranking of cities worldwide based on current AQI. Use when you need a global AQI ranking list after authenticating with a valid AirVisual API key. If /world-rankings is not accessible, gracefully falls back to /nearest_ci

Setup

Setup guide

  1. 11. Open your Switchy workspace and navigate to Settings > Integrations > Developer Tools. 2. Find IQAir AirVisual in the list and click Connect. 3. Visit the IQAir AirVisual developer portal and sign up for an API key — choose the tier that matches your query volume needs. 4. Copy the API key and paste it into the Switchy connection dialog, then click Authorize. 5. Switchy confirms the connection and shows IQAir AirVisual as active in your integrations list. 6. Open any Space and type '@IQAir AirVisual what's the current air quality in Seattle, Washington, USA?' to test the connection. 7. If the response includes AQI data and weather conditions, the integration is working. 8. Use @IQAir AirVisual at the start of any prompt to invoke its tools — specify city, state, and country for best results, or provide GPS coordinates for station-level precision.

What teammates see: by default, memories from Iqair Airvisual are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

Current AQI Check

@IQAir AirVisual get the current air quality for Los Angeles, California, USA and summarize the AQI level and any health recommendations.
Open in a Space →

Location Comparison

@IQAir AirVisual compare current air quality between Denver, Colorado, USA and Portland, Oregon, USA and tell me which has better conditions today.
Open in a Space →

Historical Trend Analysis

@IQAir AirVisual retrieve historical air quality data for Beijing, Beijing, China over the past 30 days and highlight any days with unhealthy AQI levels.
Open in a Space →

Nearest Station Lookup

@IQAir AirVisual get air quality from the nearest station to coordinates 37.7749, -122.4194 and report the current AQI and pollutant breakdown.
Open in a Space →

Forecast for Planning

@IQAir AirVisual get the air quality forecast for Phoenix, Arizona, USA for the next 3 days and recommend the best day for an outdoor team event.
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@iqair-airvisual what's the current air quality in Seattle, Washington? Include the main pollutant and health recommendations.

Output

Seattle, Washington currently has an AQI of 42 (Good). The dominant pollutant is PM2.5 at 10.2 µg/m³. Temperature is 52°F with 78% humidity. Health recommendation: Air quality is satisfactory; outdoor activities are safe for all groups. Wind speed is 8 mph from the northwest. This data was last updated 23 minutes ago from the nearest monitoring station.

Notes

This example shows the MCP's core read capability: fetching real-time AQI data with pollutant breakdowns. Requires an API key with city-level access. Note that IQAir's free tier may limit requests to 10,000/month; responses reflect the most recent station reading, which can lag by 15-30 minutes depending on the monitoring network.

Prompt

@iqair-airvisual get me a 3-day air quality forecast for Delhi, India so I can plan outdoor meetings this week.

Output

Delhi, India 3-day AQI forecast: Today: 178 (Unhealthy), dominant pollutant PM2.5. Tomorrow: 165 (Unhealthy), PM2.5 remains primary concern. Day 3: 152 (Unhealthy for Sensitive Groups), slight improvement expected. Recommendation: Schedule indoor meetings or early morning slots when AQI typically dips 20-30 points lower. Sensitive individuals should avoid prolonged outdoor exposure all three days.

Notes

This demonstrates the forecast tool, useful for planning around pollution events. Forecasts are model-based predictions and can shift with weather changes; always cross-reference day-of readings. This feature requires a paid IQAir API plan in most regions. The MCP returns daily averages, not hourly granularity.

Prompt

@iqair-airvisual compare historical AQI trends for Los Angeles over the past 30 days and summarize whether air quality is improving or worsening.

Output

Los Angeles historical AQI (past 30 days): Average AQI was 68 (Moderate), with 18 days in the Good range (0-50) and 12 days Moderate (51-100). Peak reading was 94 on May 8th due to wildfire smoke. Trend analysis: AQI has improved 12% compared to the prior 30-day period, likely due to increased rainfall and reduced vehicle emissions. No days exceeded Unhealthy thresholds. Overall trajectory is stable-to-improving.

Notes

This example pairs the historical data tool with AI reasoning to surface trends a human would miss in raw numbers. The MCP provides daily AQI snapshots; the AI synthesizes them into actionable insight. Historical data depth varies by city—some stations offer years of records, others only weeks. Rate limits apply to bulk historical queries.

Use-case deep-dives

Field service scheduling by air quality

When outdoor work teams need real-time AQI routing

A 12-person landscaping crew uses Switchy to coordinate daily job assignments across three metro areas. The dispatcher pulls nearest-city AQI data each morning to flag hazardous zones and reschedule outdoor work when PM2.5 spikes above 150. The MCP's Get Nearest City Air Quality and Get Air Quality Forecast Data tools let the team automate this check without leaving their planning thread. The trade-off: if your crew works in rural areas outside the 10,000+ supported cities, coverage drops fast and you'll need manual lookups. This MCP wins when your service area overlaps urban monitoring networks and you schedule work at least 24 hours out. For teams running same-day dispatch in sparse regions, the station-level tools won't help enough to justify the integration.

Customer health advisory in SaaS

When your product needs location-aware air quality alerts

A 6-person startup building a fitness app uses Switchy to triage support tickets and feature requests. Users in Delhi and Jakarta complain that outdoor workout recommendations ignore local pollution. The team uses the Get City Air Quality and Get Historical AQI Data tools to prototype a location-based advisory feature—pulling AQI by city name or GPS coordinates, then surfacing warnings when readings hit unhealthy thresholds. The MCP's 10 tools cover current conditions, forecasts, and historical trends, so the product team can validate the feature's data layer before committing engineering time. The catch: if your app needs sub-city granularity or real-time station updates every 15 minutes, the city-level endpoints are too coarse. This MCP is the right call when you're scoping an MVP health feature and need credible AQI data without building a weather API from scratch.

Event planning air quality checks

When outdoor event logistics depend on pollution forecasts

A 4-person event agency uses Switchy to manage vendor coordination and client approvals for outdoor festivals and corporate offsites. The planner checks Get Air Quality Forecast Data for each venue city 7-10 days before the event, flagging dates when AQI is forecast above 100 to recommend indoor backup plans or rescheduling. The MCP's forecast and historical tools let the team show clients data-backed recommendations in the same workspace where they're negotiating contracts. The limitation: forecasts are city-level aggregates, so if your venue is 20 miles upwind of the monitoring station, accuracy suffers. This integration makes sense when you're booking events in major metros with dense monitoring networks and your clients expect proactive risk management. For rural or small-town events, the sparse station coverage means you're better off checking local government sites manually.

Frequently asked

What does the IQAir AirVisual MCP do in Switchy?

It pulls real-time and historical air quality data from IQAir's global monitoring network into your Switchy workspace. You can query current AQI by city, GPS coordinates, or IP address, retrieve forecasts, and access historical pollution trends. Useful for environmental reporting, location-based product decisions, or health-risk analysis tied to air quality.

Do I need an IQAir account to connect this MCP?

Yes. You need an IQAir AirVisual API key, which requires signing up at airvisual.com. The free tier covers basic queries; higher-volume or commercial use requires a paid plan. Paste the API key into Switchy's connection form—no OAuth flow, just the key.

Can this MCP send alerts when AQI crosses a threshold?

No. It only fetches data on demand—current readings, forecasts, or historical logs. If you want automated alerts, you'll need to poll the MCP from a workflow tool or write a script that checks AQI and triggers notifications separately. The MCP itself doesn't watch or push.

How is this different from scraping IQAir's website?

The API returns structured JSON with station IDs, precise timestamps, and forecast arrays—easier to parse and more reliable than scraping HTML. You also get historical data and nearest-station lookups by GPS, which the public site doesn't expose. Rate limits are explicit, and you won't break when IQAir redesigns their frontend.

Who on the team should connect the IQAir MCP?

Whoever owns the IQAir API key and understands your query budget. If you're on a free tier, one person should manage it to avoid burning through the monthly limit. For paid plans, any team member can connect using the shared key—just track usage in IQAir's dashboard.

Data last verified 607 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.