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

Use OpenAQ with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Access global air quality data. monitor PM2.5, O3, NO2 levels and track pollution 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 · 9 capabilities

The complete OpenAQ capability set.

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

Capability set01 / 03

01-03

3 capabilities in this set.

Part of 9 available through OpenAQ.

  1. 01

    Get location by ID

    Get details for a specific location

  2. 02

    Get latest measurements

    Useful for getting current air quality status without querying full history. Get latest measurements per location

  3. 03

    Get countries

    Includes location counts and city counts per country. List countries with monitoring stations

Capability set02 / 03

04-06

3 capabilities in this set.

Part of 9 available through OpenAQ.

  1. 04

    Get locations

    Filter by country, city, parameter, or geographic bounding box. Returns location details including coordinates, sensor counts, and whether the station is an official monitor. List air quality monitoring locations

  2. 05

    Get measurements

    Filter by location, parameter, date range, and value range. Returns readings with timestamps. Get historical air quality measurements

  3. 06

    Get parameter by ID

    Get details for a specific parameter

Capability set03 / 03

07-09

3 capabilities in this set.

Part of 9 available through OpenAQ.

  1. 07

    Get parameters

    5, PM10, O3 (ozone), NO2, SO2, CO, etc. Includes units and whether each is a core parameter. List measurable air quality parameters

  2. 08

    Get sensor by ID

    Get details for a specific sensor

  3. 09

    Get sensors

    Filter by location, parameter type, or active status. List air quality sensors

Observed, not estimated

875ms average. Fast in production.

OpenAQ is checked daily against the live service.

Daily averagePeak 1270ms
Aug 20Today
Fastest day
795ms
Slowest day
1270ms
14-day trend
Stable+4%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 9 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 OpenAQ, so you can see the experience inside your AI.

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

OpenAQ Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_VGsxrLcNairCyPHFbpo3PocA4AcTLLX4zk50pkNW/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 — OpenAQ capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "openaq-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_VGsxrLcNairCyPHFbpo3PocA4AcTLLX4zk50pkNW/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 OpenAQ owners ask.

  • 01

    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.

  • 02

    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.

  • 03

    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.

Explore

More in Data Analytics