PurpleAir Connector for AI agents.
10 live capabilities
Get real-time pollution and wildfire smoke data for any location.
Waiting for input…
Why people use PurpleAir
PurpleAir Air Quality Data for Environmental Monitoring
With this Connector, you just ask your agent. You can get a summary of the air in a city, find the nearest sensor to your house, or pull a CSV of the last month's data in seconds. It turns a multi-step research task into a single conversation.
What Vinkius changes
You get instant, hyperlocal air quality data through a simple 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
Wildfire Smoke Tracking
A fire chief asks the agent to find PM2.
- Real-world use case 02
Real Estate Site Assessment
A developer asks the agent to check the air quality in a city center to see if a new building site is in a high-pollution zone.
- Real-world use case 03
Public Health Advisories
A city official asks the agent to find all sensors in a zip code to see if it's safe for people with asthma to go outside.
Complete set · 10capabilities
The complete PurpleAir capability set.
These are the exact actions your AI can choose when you ask it to work with PurpleAir.
01—04
4 capabilities in this set.
Part of 10 available through PurpleAir.
- 01 Capability
Get pm25 sensors
5 (Fine particulate matter) measurements. PM2.5 is the most important air quality indicator. particles smaller than 2.5 micrometers that can penetrate deep into lungs and bloodstream. Returns current PM2.5 concentrations along with location data. Essential for health advisories, wildfire smoke tracking, and urban pollution monitoring. Get sensors with PM2.5 measurements
- 02 Capability
Get sensor data
Fetches real-time measurements like temperature and humidity from a specific sensor. It lets you see exact conditions at a single point.
- 03 Capability
Get sensor history csv
Downloads historical sensor data in a CSV format. It's the best way to get data for offline spreadsheets or charts.
- 04 Capability
Get sensors by bounding box
Finds all sensors within a specific geographic area. It's perfect for mapping out air quality across a whole city.
05—07
3 capabilities in this set.
Part of 10 available through PurpleAir.
- 05 Capability
Get indoor sensors
Lists all sensors located inside buildings or homes. It's helpful for checking air quality in offices or schools.
- 06 Capability
Get outdoor sensors
Returns all sensors measuring ambient outdoor air. You can use it to see a broad view of regional pollution levels.
- 07 Capability
Get sensor history
Retrieves time-series data for specific fields over a chosen period. You can see how pollution changed over days or weeks.
08—10
3 capabilities in this set.
Part of 10 available through PurpleAir.
- 08 Capability
Get sensors by index
Pulls fresh readings for specific sensors you already know. It saves time when you only care about a few specific monitors.
- 09 Capability
Get sensors near me
Locates the closest sensors to a specific GPS coordinate. It's the fastest way to find local air quality near an address.
- 10 Capability
List sensors
Lists all available sensors with optional filters for type and location. It gives you a full overview of the network's coverage.
Set up in minutes
One URL. Then ask PurpleAir to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use PurpleAir 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_8GtJ3PAbFBkLWG7y9DACceyyzK4HYrrtyQiWNSQb/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 PurpleAir, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable PurpleAir for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_8GtJ3PAbFBkLWG7y9DACceyyzK4HYrrtyQiWNSQb/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 PurpleAir URL.
- Step 03
Save and start
Save the connection and enable PurpleAir in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"purpleair": {
"url": "https://edge.vinkius.com/vk_preview_8GtJ3PAbFBkLWG7y9DACceyyzK4HYrrtyQiWNSQb/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 PurpleAir
Open Agent mode in chat and ask: "Using PurpleAir, help me...". 10 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"purpleair": {
"url": "https://edge.vinkius.com/vk_preview_8GtJ3PAbFBkLWG7y9DACceyyzK4HYrrtyQiWNSQb/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 PurpleAir
Ask Copilot: "Using PurpleAir, help me...". 10 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"purpleair": {
"url": "https://edge.vinkius.com/vk_preview_8GtJ3PAbFBkLWG7y9DACceyyzK4HYrrtyQiWNSQb/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 PurpleAir
Open Cascade and ask: "Using PurpleAir, help me...". 10 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"purpleair": {
"url": "https://edge.vinkius.com/vk_preview_8GtJ3PAbFBkLWG7y9DACceyyzK4HYrrtyQiWNSQb/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 PurpleAir
Ask Cline: "Using PurpleAir, help me...". 10 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add purpleair --transport http "https://edge.vinkius.com/vk_preview_8GtJ3PAbFBkLWG7y9DACceyyzK4HYrrtyQiWNSQb/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 PurpleAir
Ask Claude: "Using PurpleAir, show me...". 10 tools are ready
Where the request belongs
Work PurpleAir can move forward.
This is for anyone who needs to know exactly what's in the air, from researchers tracking climate shifts to city officials managing public health alerts.
Environmental Scientist
Uses this to validate pollution models and track long-term climate shifts across different regions.
Public Health Official
Monitors air quality spikes to issue timely health advisories for the public during poor air events.
Wildfire Response Lead
Tracks smoke plumes in real-time to coordinate community safety efforts and identify high-risk zones.
Real Estate Developer
Assesses air quality scores for new property developments and commercial sites during site evaluations.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsOpenAQ
Access global air quality data. monitor PM2.5, O3, NO2 levels and track pollution via AI.
IQAir
Monitor air quality and weather. audit pollution data and cities 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.
AirVisual
Monitor global air quality and weather data via AirVisual. access real-time AQI, pollution levels, and meteorological data from any AI agent.
BreezoMeter Air Quality & Pollen
Universal air quality intelligence. get real-time AQI, pollutants, and pollen data via AI.
AQICN
Access real-time Air Quality Index (AQI) data, pollutant levels, and weather conditions from over 30,000 stations worldwide.
Bring your own AI
Change the model, client or framework. Keep PurpleAir 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 PurpleAir.
The practical details behind the request, access and result.
Can PurpleAir MCP track wildfire smoke?
Yes, it can. By monitoring PM2.5 spikes across a global network of sensors, it helps you identify exactly where smoke plumes are affecting the air in real-time.
Can I get historical data from PurpleAir MCP?
Yes, you can retrieve time-series data for various fields, including temperature and humidity, to analyze pollution trends over days, weeks, or months.
Does PurpleAir MCP work for indoor air quality?
Yes, it includes access to sensors specifically located inside buildings, homes, and workspaces, making it great for HVAC and health monitoring.
Can I export data from PurpleAir MCP to a spreadsheet?
Yes, you can request historical data in a CSV format, which is perfect for moving information into Excel or other data analysis capabilities.
Can I find sensors in a specific area using PurpleAir MCP?
Yes, you can query sensors within a specific geographic bounding box to map out air quality for an entire neighborhood, city, or region.
Is PurpleAir MCP good for real estate research?
It's a great capability for that. You can quickly check the local pollution levels and environmental health scores for any property location.
How many sensors does PurpleAir MCP access?
It connects you to a global network of over 50,000 low-cost air quality sensors, providing high-resolution hyperlocal data.
How do I find air quality near my address?
Use the get_sensors_near_me capability with your latitude and longitude. Alternatively, search for sensors by bounding box using get_sensors_by_bounding_box with corner coordinates. The API will return nearby sensors with current PM2.5, temperature, and humidity readings.
Can I get historical air quality data?
Yes. Use get_sensor_history with a sensor index and time range (Unix timestamps). You can specify which fields to retrieve (PM2.5, temperature, humidity) and set an averaging interval (e.g. 3600 for hourly averages). For spreadsheet analysis, use get_sensor_history_csv to get data in CSV format.
What does PM2.5 mean and why is it important?
PM2.5 refers to fine particulate matter smaller than 2.5 micrometers. about 30 times smaller than a human hair. These particles can penetrate deep into lungs and enter the bloodstream, causing respiratory and cardiovascular health effects. The WHO guideline is 5 µg/m³ annual average. PurpleAir sensors measure PM2.5 in real-time, making them essential for health advisories and pollution monitoring.
One connection away
Give your agent a direct line to PurpleAir.
Connect PurpleAir once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available