Connect Iqair Airvisual to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.
What you can do with the Iqair Airvisual MCP server
Ask your agent in plain language. Each of these maps to a real tool on the server.
Use the get station air quality tool in Iqair Airvisual
Use the get city air quality tool in Iqair Airvisual
Use the get city aqi ranking tool in Iqair Airvisual
Use the get nearest air quality tool in Iqair Airvisual
Use the list locations tool in Iqair Airvisual
Supported Tools
get_station_air_quality
Get Station Air Quality
Retrieve air quality and weather data at the monitoring station level. Supports two modes: specify a station by name (along with city, state, country), or find the nearest station to GPS coordinates / IP location. Station-level data provides more granular pollutant concentration readings than city-level data.
get_city_air_quality
Get City Air Quality
Retrieve current air quality and weather data for a specific city. Returns AQI values (US and China standards), main pollutant, weather conditions (temperature, humidity, pressure, wind), and GPS coordinates. If available on your plan, also returns pollutant concentrations, forecasts, and historical data.
get_city_ranking
Get City AQI Ranking
Retrieve a global ranking of major cities by current air quality index (AQI). Enables comparison of air quality across cities worldwide. Returns each city's name, location, and AQI values for both US and China standards.
get_nearest_air_quality
Get Nearest Air Quality
Retrieve air quality and weather data for the nearest city to a given location. Supports lookup by GPS coordinates (latitude/longitude) or by IP-based geolocation when no coordinates are provided. Useful when the exact city name is unknown.
list_locations
List Locations
Browse the IQAir location directory hierarchically. Lists supported countries, states within a country, cities within a state, or monitoring stations within a city. Use this to discover valid location names before querying air quality data.
Enable Iqair Airvisual in Metorial. In your Metorial portal, enable the Iqair Airvisual MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
Sign in. Select Add and sign in to load Iqair Airvisual tools.
Enable Iqair Airvisual in Metorial. In your Metorial portal, enable the Iqair Airvisual MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom MCP server. On ChatGPT web, open Plugins, select +, then Add custom MCP server.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>), choose OAuth and accept the risk notice.
Create and install the plugin. Select Create as a plugin, install it and sign in to load Iqair Airvisual tools.
Enable Iqair Airvisual in Metorial. In your Metorial portal, enable the Iqair Airvisual MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add Metorial to your MCP config. Use ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
Sign in. Open Customize in the sidebar, find Metorial and sign in to load Iqair Airvisual tools.
{
"mcpServers":{
"metorial":{
"url":"<your-magic-mcp-url>"
}
}
}
Enable Iqair Airvisual in Metorial. In your Metorial portal, enable the Iqair Airvisual MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server over HTTP. Add --scope user to use it in every project.
Sign in. Run /mcp, select Metorial and sign in to load Iqair Airvisual tools.
claude mcp add --transport http metorial <your-magic-mcp-url>
Enable Iqair Airvisual in Metorial. In your Metorial portal, enable the Iqair Airvisual MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server and sign in. The Codex CLI, IDE extension and ChatGPT desktop app share this config.
Check the connection. Type /mcp in Codex to see Metorial and its Iqair Airvisual tools.
codex mcp add metorial --url <your-magic-mcp-url>
codex mcp login metorial
Run Iqair Airvisual through the Metorial gateway
One governed layer for every app your agents reach, not a separate connector per tool.
Give Iqair Airvisual and every other app to your whole team through one MCP gateway, behind your SSO.
Scope which teams and agents can use Iqair Airvisual tools with role-based access control, and trace every call.
Prefer to run it yourself? Metorial is open source and self-hostable.
Read outdoor air quality and weather by city, coordinates, or monitoring station. Browse supported locations, compare city AQI rankings, and retrieve pollutant concentrations, forecasts, daily forecasts, and recent history when included in your IQAir API plan.
Frequently asked questions
Common questions about connecting Iqair Airvisual to AI agents with Metorial.
How many tools does the Iqair Airvisual MCP server have?
The Iqair Airvisual MCP server exposes 5 tools, including Get Station Air Quality, Get City Air Quality, Get City AQI Ranking. Each one is governed and traced through Metorial.
Does the Iqair Airvisual MCP server support triggers?
Iqair Airvisual exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
Which AI clients can use the Iqair Airvisual MCP server?
Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Iqair Airvisual MCP server through the same Metorial URL.
How do I give only some teams access to Iqair Airvisual?
Use role-based access control to decide which teams, users, and agents can use Iqair Airvisual and which of its tools they can call.
Can I self-host the Iqair Airvisual MCP server?
Yes. Metorial is open source, so you can run the Iqair Airvisual MCP server yourself or use the hosted gateway.
Connect Iqair Airvisual to production AI agents
See how Metorial gives your team governed access to Iqair Airvisual, with tracing and security controls built in.