OpenAQ Connector for AI agents.
9 live capabilities
Monitor global air quality and pollution trends with real-time data.
Waiting for input…
Why people use OpenAQ
OpenAQ for Tracking Global Air Quality and Pollution Trends
With this Connector, you just tell your agent what you need. It pulls the latest readings or historical trends directly into your chat, giving you a clear view of pollution levels in seconds.
What Vinkius changes
You get instant access to global pollution data 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 local air for a move
A user wants to know if a new apartment in Paris is near high pollution areas.
- Real-world use case 02
Academic pollution research
A scientist needs to see how NO2 levels in Delhi have changed over the last year.
- Real-world use case 03
Urban planning for green zones
A city planner wants to identify areas with the highest ozone levels to prioritize new parks.
Complete set · 9capabilities
The complete OpenAQ capability set.
These are the exact actions your AI can choose when you ask it to work with OpenAQ.
01—03
3 capabilities in this set.
Part of 9 available through OpenAQ.
- 01 Capability
Get location by id
Get specific details for a single monitoring station using its unique ID. This helps you identify the exact hardware at a site.
- 02 Capability
Get countries
List all countries that have active air quality monitoring stations. It also shows the total count of stations per country.
- 03 Capability
Get latest measurements
Pull the most recent air quality readings for a specific location instantly. Use this for real-time pollution awareness.
04—06
3 capabilities in this set.
Part of 9 available through OpenAQ.
- 04 Capability
Get locations
Search for air quality stations filtered by country, city, or geographic area. This is perfect for finding nearby data points.
- 05 Capability
Get measurements
Retrieve historical air quality data filtered by date, location, and specific pollutants. This lets you see how air quality changes over time.
- 06 Capability
Get parameter by id
Look up the specific details and units for a single air quality parameter. This ensures you are interpreting the data correctly.
07—09
3 capabilities in this set.
Part of 9 available through OpenAQ.
- 07 Capability
Get parameters
List all available air quality parameters like PM2.5, O3, and NO2 with their units. This helps you see what data is actually available.
- 08 Capability
Get sensor by id
Get the technical details for a specific air quality sensor. This is useful for verifying the source and type of a measurement.
- 09 Capability
Get sensors
Find and list air quality sensors based on location, status, or type of parameter they measure. Use this to audit sensor networks.
Set up in minutes
One URL. Then ask OpenAQ to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use OpenAQ 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_VGsxrLcNairCyPHFbpo3PocA4AcTLLX4zk50pkNW/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 OpenAQ, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable OpenAQ for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_VGsxrLcNairCyPHFbpo3PocA4AcTLLX4zk50pkNW/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 OpenAQ URL.
- Step 03
Save and start
Save the connection and enable OpenAQ in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"openaq": {
"url": "https://edge.vinkius.com/vk_preview_VGsxrLcNairCyPHFbpo3PocA4AcTLLX4zk50pkNW/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 OpenAQ
Open Agent mode in chat and ask: "Using OpenAQ, help me...". 9 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"openaq": {
"url": "https://edge.vinkius.com/vk_preview_VGsxrLcNairCyPHFbpo3PocA4AcTLLX4zk50pkNW/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 OpenAQ
Ask Copilot: "Using OpenAQ, help me...". 9 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"openaq": {
"url": "https://edge.vinkius.com/vk_preview_VGsxrLcNairCyPHFbpo3PocA4AcTLLX4zk50pkNW/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 OpenAQ
Open Cascade and ask: "Using OpenAQ, help me...". 9 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"openaq": {
"url": "https://edge.vinkius.com/vk_preview_VGsxrLcNairCyPHFbpo3PocA4AcTLLX4zk50pkNW/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 OpenAQ
Ask Cline: "Using OpenAQ, help me...". 9 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add openaq --transport http "https://edge.vinkius.com/vk_preview_VGsxrLcNairCyPHFbpo3PocA4AcTLLX4zk50pkNW/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 OpenAQ
Ask Claude: "Using OpenAQ, show me...". 9 tools are ready
Where the request belongs
Work OpenAQ can move forward.
This is for environmental researchers, urban planners, and public health analysts who need to monitor pollution levels without manually scraping data from dozens of different sources.
Environmental Scientist
Analyzes long-term pollution trends for academic papers or policy reports.
Urban Planner
Checks current air quality in different neighborhoods to plan green spaces.
Public Health Researcher
Monitors NO2 and PM2.5 levels to correlate with local health issues.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsPurpleAir
Real-time air quality monitoring. access PM2.5, temperature, and pollution data from 50K+ sensors worldwide via AI.
EPA AirNow
Monitor localized air quality indices and critical environmental forecasts directly from the Environmental Protection Agency.
AQICN
Access real-time Air Quality Index (AQI) data, pollutant levels, and weather conditions from over 30,000 stations worldwide.
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.
AirVisual
Monitor global air quality and weather data via AirVisual. access real-time AQI, pollution levels, and meteorological data from any AI agent.
IQAir
Monitor air quality and weather. audit pollution data and cities via AI.
Bring your own AI
Change the model, client or framework. Keep OpenAQ 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 OpenAQ.
The practical details behind the request, access and result.
Can I use OpenAQ MCP to see pollution in my own backyard?
OpenAQ MCP provides data from a global network of monitoring stations. While it covers many cities and regions, it may not have a sensor in every specific backyard unless one is part of the open dataset.
Does OpenAQ MCP provide real-time data?
Yes, the Connector can pull the most recent measurements available from the database, allowing you to see current air quality levels for various pollutants.
Can I get historical data with OpenAQ MCP?
Yes, you can query historical measurements for specific date ranges to analyze how pollution levels have changed over months or years.
Which pollutants can I track using OpenAQ MCP?
You can track several key pollutants, including PM2.5, O3 (ozone), NO2, SO2, and CO, along with other parameters supported by the database.
Is the data from OpenAQ MCP free to access?
OpenAQ is an open-source database, so the data provided through this Connector is accessible without additional costs for the information itself.
Can I use OpenAQ MCP to find sensors in a specific city?
Yes, the Connector allows you to search for monitoring stations filtered by city, country, or geographic coordinates to see where data is being collected.
How do I get an OpenAQ API Key?
Visit OpenAQ Platform, create a free account, and generate your API key from the dashboard. Free tier includes 1,000 requests/hour.
What air quality parameters can I monitor?
PM2.5, PM10, O3 (ozone), NO2, SO2, CO, BC (black carbon), and more. Use get_parameters to see the full list with units and classifications.
Can I get historical air quality data?
Yes! Use get_measurements with date_from and date_to parameters in ISO 8601 format to retrieve time-series data for any location and parameter.
One connection away
Give your agent a direct line to OpenAQ.
Connect OpenAQ once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available