How to Use the PurpleAir MCP in Cursor

Q: How do I configure PurpleAir in Cursor?

Create an mcp.json file in your project root. Define the server path there, and the agent will detect the tools in your next chat session.

Inject real-time PurpleAir sensor data into your codebase using Cursor agent mode.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect PurpleAir MCP to Cursor

Create your Vinkius account to connect PurpleAir to Cursor — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup PurpleAir with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Fetch live sensor data in Cursor

Build features that react to current environmental conditions by calling `get_sensor_data` directly from your editor. The agent reads the JSON output and writes the logic to handle the PM2.5 values. This removes the need for mock data during development. You get actual API responses injected right into the file you are editing.

Query local sensors from Cursor

Find the most relevant hardware for your application by using `get_sensors_near_me` inside your project. The agent identifies the nearest sensor coordinates based on your input. It allows your code to adapt to specific locations dynamically. You just define the point, and the agent handles the sensor lookup.

Filter sensor networks in Cursor

Use `list_sensors` to grab metadata for specific sensor types across your target region. You can filter by type or update time to keep your data current. Cursor processes this list to help you build arrays of sensors for larger mapping projects. It is a direct way to feed raw hardware data into your application logic.

Setup guide

Set up PurpleAir MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the PurpleAir MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent PurpleAir transactions." If the MCP tools are loaded correctly, Cursor will call the PurpleAir tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "purpleair-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by PurpleAir. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.