AirVisual Connector for AI agents.
7 live capabilities
Track real-time air quality index and global pollution levels.
Waiting for input…
Why people use AirVisual
AirVisual for real-time pollution tracking and AQI monitoring
With this Connector, you just ask your agent for the current conditions in any city. It pulls the AQI, the weather, and the primary pollutants in one go, giving you a complete picture instantly without the manual copy-pasting.
What Vinkius changes
You get instant, accurate environmental data from global stations without leaving your chat interface.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Checking safety for a run
A runner asks "Is the air safe to run outside in Chicago?
- Real-world use case 02
Mapping out pollution trends
A scientist asks for a list of states in Canada and then pulls data for each to map out pollution levels across the country.
- Real-world use case 03
Pre-trip travel prep
A traveler asks about the weather and AQI in Tokyo to see if they need to pack extra masks for their upcoming flight.
Complete set · 7capabilities
The complete AirVisual capability set.
These are the exact actions your AI can choose when you ask it to work with AirVisual.
01—04
4 capabilities in this set.
Part of 7 available through AirVisual.
- 01 Capability
Get nearest city by coords
Find the nearest city data based on specific GPS coordinates. This is perfect for pinpointing your exact location.
- 02 Capability
Get nearest city by ip
Get air quality and weather data for the city closest to your current IP. It removes the need to type in your location.
- 03 Capability
Get station data
Access detailed data from a specific monitoring station. This gives you hyper-local insights for precise tracking.
- 04 Capability
List cities
Get a list of all cities supported within a specific state. This helps you find the right data points for your area.
05—07
3 capabilities in this set.
Part of 7 available through AirVisual.
- 05 Capability
Get city data
Pull the current AQI and weather for a specific city. Use this to get a quick snapshot of local conditions.
- 06 Capability
List countries
See all the countries that are supported by the platform. This is great for broad environmental research.
- 07 Capability
List states
See all supported states within a specific country. Use this to navigate to specific regions for data collection.
Set up in minutes
One URL. Then ask AirVisual to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use AirVisual from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_VGX1iJ9zQN0X34um29FbzVGt7YkF8gKTQwxcCGbx/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it AirVisual, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable AirVisual for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_VGX1iJ9zQN0X34um29FbzVGt7YkF8gKTQwxcCGbx/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the AirVisual URL.
- Step 03
Save and start
Save the connection and enable AirVisual in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"airvisual": {
"url": "https://edge.vinkius.com/vk_preview_VGX1iJ9zQN0X34um29FbzVGt7YkF8gKTQwxcCGbx/mcp"
}
}
} - Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using AirVisual
Open Agent mode in chat and ask: "Using AirVisual, help me...". 7 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"airvisual": {
"url": "https://edge.vinkius.com/vk_preview_VGX1iJ9zQN0X34um29FbzVGt7YkF8gKTQwxcCGbx/mcp"
}
}
} - Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using AirVisual
Ask Copilot: "Using AirVisual, help me...". 7 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"airvisual": {
"url": "https://edge.vinkius.com/vk_preview_VGX1iJ9zQN0X34um29FbzVGt7YkF8gKTQwxcCGbx/mcp"
}
}
} - Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using AirVisual
Open Cascade and ask: "Using AirVisual, help me...". 7 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"airvisual": {
"url": "https://edge.vinkius.com/vk_preview_VGX1iJ9zQN0X34um29FbzVGt7YkF8gKTQwxcCGbx/mcp"
}
}
} - Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using AirVisual
Ask Cline: "Using AirVisual, help me...". 7 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add airvisual --transport http "https://edge.vinkius.com/vk_preview_VGX1iJ9zQN0X34um29FbzVGt7YkF8gKTQwxcCGbx/mcp" - Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using AirVisual
Ask Claude: "Using AirVisual, show me...". 7 tools are ready
Where the request belongs
Work AirVisual can move forward.
This is for people who need to know what the air feels like before they step outside or for those who need to track pollution trends for work.
Outdoor Fitness Coach
Checking local AQI for clients before a morning run to ensure they stay safe.
Environmental Researcher
Gathering data from specific stations across different countries for a pollution report.
Smart Home Enthusiast
Asking the agent for local pollution levels to see if they should turn on their home air purifier.
Travel Planner
Checking the weather and air quality of a destination before booking a trip abroad.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsIQAir
Monitor air quality and weather. audit pollution data and cities via AI.
PurpleAir
Real-time air quality monitoring. access PM2.5, temperature, and pollution data from 50K+ sensors worldwide via AI.
Open-Meteo Air Quality
Monitor the air your users breathe: PM2.5, PM10, ozone, pollen counts, and official AQI indexes (European & US). real-time pollutant intelligence for health-conscious AI agents.
OpenAQ
Access global air quality data. monitor PM2.5, O3, NO2 levels and track pollution via AI.
AQICN
Access real-time Air Quality Index (AQI) data, pollutant levels, and weather conditions from over 30,000 stations worldwide.
EPA AirNow
Monitor localized air quality indices and critical environmental forecasts directly from the Environmental Protection Agency.
Bring your own AI
Change the model, client or framework. Keep AirVisual connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about AirVisual.
The practical details behind the request, access and result.
Can I use AirVisual MCP to check the air quality in my own backyard?
Yes, you can. By asking your agent to check the air quality near your current location, it will use your IP or GPS coordinates to find the nearest monitoring station and give you the local data.
Does AirVisual MCP provide weather forecasts too?
Yes, it provides both air quality and meteorological data. When you ask about a city, your agent will give you the AQI, the temperature, and the humidity levels all at once.
Can I get data for specific countries?
Absolutely. You can ask your agent to list supported countries or look up the air quality and weather for any specific nation in the global network.
Is the data from AirVisual MCP real-time?
Yes, the data is pulled in real-time from the AirVisual platform, meaning you get the most current readings available from their global monitoring stations.
How do I get data for a specific city?
Just ask your AI agent. You can say something like 'What is the air quality in Tokyo?' and it will automatically fetch the current AQI and weather for that city.
Can I see specific details for a monitoring station?
Yes, if you know the specific station you want to monitor, your agent can pull granular data directly from that station for hyper-local insights.
Can I get air quality data for my current location without entering coordinates?
Yes! You can use the get_nearest_city_by_ip capability. The agent will use your requester IP address to find and return the AQI and weather data for the closest supported city automatically.
How do I find out which cities are supported in a specific region?
You can browse the hierarchy using list_countries, then list_states for a specific country, and finally list_cities for a specific state. This allows you to discover exactly which locations have active monitoring.
Does this server provide data from specific monitoring stations?
Yes, the get_station_data capability allows you to retrieve real-time data from a specific named monitoring station if you know its name and location details (city, state, country).
One connection away
Give your agent a direct line to AirVisual.
Connect AirVisual once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available