An astronaut overseeing a futuristic data hub
Download PDFMarkdown Version

Connect PurpleAir to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Get real-time pollution and sensor readings through your AI agent.

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

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

A futuristic MCP client docking bay
V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 10 capabilities

We ship only the actions that matter.

Capability set01 / 03

01-04

4 capabilities in this set.

Part of 10 available through PurpleAir.

  1. 01

    Get sensors by bounding box

    Finds all sensors within a specific geographic area using northwest and southeast coordinates. It's the best way to map air quality across a whole city or neighborhood.

  2. 02

    Get indoor sensors

    Accesses sensors located inside buildings and homes. Use this to monitor indoor air quality or check HVAC performance.

  3. 03

    Get outdoor sensors

    Retrieves data from ambient outdoor sensors. This is your primary capability for tracking regional pollution or wildfire smoke.

  4. 04

    Get pm25 sensors

    Filters for sensors providing PM2.5 measurements. This focuses on the fine particulate matter most critical for health monitoring.

Capability set02 / 03

05-07

3 capabilities in this set.

Part of 10 available through PurpleAir.

  1. 05

    Get sensor data

    Fetches real-time readings from a single specific sensor. You can get PM2.5, temperature, humidity, and pressure in one go.

  2. 06

    Get sensor history

    Pulls time-series data for a specific sensor over a defined period. It allows you to see how pollution levels changed over minutes, hours, or days.

  3. 07

    Get sensor history csv

    Provides historical sensor data in CSV format. This is designed for when you need to move data into a spreadsheet for offline work.

Capability set03 / 03

08-10

3 capabilities in this set.

Part of 10 available through PurpleAir.

  1. 08

    Get sensors by index

    Fetches fresh readings for specific sensors using their unique indices. Use this to quickly update data for a known list of monitors.

  2. 09

    Get sensors near me

    Locates the closest PurpleAir sensors to a specific address or GPS coordinate. It automatically calculates the proximity for you.

  3. 10

    List sensors

    Provides a broad list of sensors with various filters. You can sort by location type, update recency, or specific data fields.

Real work

What teams actually run

01

Wildfire Smoke Monitoring

Track PM2.5 spikes in real-time to assess how smoke is moving through a specific region.

02

Workplace Health Checks

Use indoor sensors to monitor air quality for HVAC optimization and employee wellness.

03

Urban Pollution Mapping

Identify high-pollution zones in a city by querying sensors within a specific bounding box.

04

Compliance Reporting

Pull historical sensor data into CSV format to document air quality for regulatory needs.

Automate a task

Put PurpleAir to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

PurpleAir works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

ClaudeClaudeChatGPTChatGPTGeminiGeminiPerplexityPerplexityGrokGrokMicrosoft CopilotMicrosoft CopilotCursorCursorVS CodeVS CodeWindsurfWindsurfJetBrainsJetBrainsClineClineLangChainLangChainVercel AI SDKVercel AI SDKLovableLovableZ.aiZ.aiRaycastRaycastQwen CodeQwen CodeKimi CodeKimi CodeLe ChatLe Chat

Building your own app? The connector is yours to use.

You don't need a client to put PurpleAir to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

983ms average. Fast in production.

PurpleAir is checked daily against the live service.

Daily averagePeak 1230ms
Oct 3Today
Fastest day
817ms
Slowest day
1230ms
14-day trend
Stable+2%

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

Guided setup for Claude? Set up PurpleAir in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work PurpleAir owners hand off.

This MCP is built for professionals who need to turn environmental sensor data into reports or real-time alerts.

  • 01

    Environmental Scientists

    They use the AI to validate air quality models and track long-term pollution trends.

  • 02

    Public Health Officials

    They rely on the agent to monitor air quality spikes and issue health advisories.

  • 03

    Wildfire Response Teams

    They use real-time PM2.5 tracking to monitor smoke impacts on specific communities.

  • 04

    Real Estate Professionals

    They check local air quality data to include in property evaluations.

FAQ

Questions PurpleAir owners ask.

  • 01

    How do I connect this MCP to my AI client?

    You subscribe to the MCP on Vinkius and enter your PurpleAir API Read Key. Once connected, you can use it immediately in Claude, Cursor, Windsurf, or any compatible client.

  • 02

    What kind of air quality data can I get?

    You can access PM2.5, PM10.0, temperature, humidity, pressure, and VOC levels depending on the specific sensor model.

  • 03

    Can I get data for a specific location?

    Yes. You can find sensors near a specific address, a GPS coordinate, or within a defined geographic bounding box.

  • 04

    Is there a way to get historical data?

    Yes. You can request time-series data for specific time ranges or export that data as a CSV file for use in spreadsheets.

  • 05

    Does this cover indoor air quality?

    Yes. The MCP includes capabilities to specifically find and query sensors located inside buildings and homes.

  • 06

    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.

  • 07

    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.

  • 08

    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

Connect PurpleAir to Claude, Cursor, ChatGPT & more