Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use PurpleAir with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Real-time air quality monitoring. access PM2.5, temperature, and pollution data from 50K+ sensors worldwide via AI.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 10 capabilities

The complete PurpleAir capability set.

These are the exact actions your AI can choose when you ask it to work with PurpleAir.

Capability set01 / 03

01-04

4 capabilities in this set.

Part of 10 available through PurpleAir.

  1. 01

    Get sensors by bounding box

    Provide the northwest (nwlat, nwlng) and southeast (selat, selng) corner coordinates. Perfect for mapping air quality across a city, neighborhood, or region. Returns all sensors in the area with current readings. Use with fields parameter to customize returned data. Get all sensors within a geographic bounding box

  2. 02

    Get indoor sensors

    These sensors measure air quality inside buildings, homes, and enclosed spaces. Useful for indoor air quality assessments, HVAC monitoring, and workspace health studies. Get all indoor PurpleAir sensors

  3. 03

    Get outdoor sensors

    These are sensors measuring ambient outdoor air quality. Returns current PM2.5, temperature, humidity and other measurements for each sensor. Useful for regional air quality monitoring, wildfire smoke tracking, and urban pollution studies. Get all outdoor (outside) PurpleAir sensors

  4. 04

    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

Capability set02 / 03

05-07

3 capabilities in this set.

Part of 10 available through PurpleAir.

  1. 05

    Get sensor data

    Returns PM2.5, PM1.0, PM10.0 particle concentrations, temperature, humidity, pressure, VOC levels, and other measurements depending on the sensor model. Use the fields parameter to specify which measurements to return. Essential for monitoring air quality at a specific location. Get real-time data from a specific PurpleAir sensor

  2. 06

    Get sensor history

    Returns time-series data for the requested fields (PM2.5, temperature, humidity, etc.) at regular intervals. Use start_timestamp and end_timestamp (Unix timestamps) to define the time range. The average parameter controls data aggregation (e.g. 60 for 1-minute averages, 3600 for hourly). Essential for analyzing air quality trends, identifying pollution events, and compliance reporting. Get historical air quality data from a PurpleAir sensor

  3. 07

    Get sensor history csv

    Same functionality as get_sensor_history but returns data as CSV instead of JSON. Use for offline analysis, charting, or compliance reporting. Requires start_timestamp and end_timestamp parameters. Get historical sensor data in CSV format for analysis

Capability set03 / 03

08-10

3 capabilities in this set.

Part of 10 available through PurpleAir.

  1. 08

    Get sensors by index

    Provide comma-separated sensor indices in the show_only parameter. Useful when you already know the sensor indices from a previous query and want to get fresh readings without fetching all sensors. Get data for specific sensor(s) by their indices

  2. 09

    Get sensors near me

    Internally uses a bounding box around the point to find nearby sensors. Useful for identifying the closest PurpleAir monitor to any address or coordinate. Returns sensors sorted by proximity with current air quality readings. Find PurpleAir sensors near a specific location

  3. 10

    List sensors

    Use the location_type parameter to filter by sensor type (outside=0, inside=1). Use the fields parameter to specify which data fields to return (e.g. name,latitude,longitude,pm2.5_atm,temperature,humidity). By default returns basic sensor info. Use show_only to filter by specific sensor indices (comma-separated). Use modified_since (Unix timestamp) to get only sensors updated after a specific time. Results include sensor metadata and real-time air quality measurements. List PurpleAir air quality sensors with optional filters

Observed, not estimated

1007ms average. Fast in production.

PurpleAir is checked daily against the live service.

Daily averagePeak 1262ms
Aug 20Today
Fastest day
777ms
Slowest day
1262ms
14-day trend
Slowing+18%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 10 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of PurpleAir, so you can see the experience inside your AI.

It does not authenticate your account with PurpleAir. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

PurpleAir Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_8GtJ3PAbFBkLWG7y9DACceyyzK4HYrrtyQiWNSQb/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — PurpleAir capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "purpleair-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_8GtJ3PAbFBkLWG7y9DACceyyzK4HYrrtyQiWNSQb/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions PurpleAir owners ask.

  • 01

    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.

  • 02

    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.

  • 03

    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.

Explore

More in Iot Hardware

Suggestions