• CURRENT
  • REMOTE
  • DETAILS
  • HUMAN

How to monitor local air quality with your AI

Connect AQICN to your AI client once. From then on, you can pull live air quality data for your current spot or any city through a chat.

Ask AI about this page

Short answer

How can I check the air quality in my city using AI?

Your AI uses the AQICN connector to pull live pollutant data for your current location or a specific city. You'll get immediate updates on AQI levels and specific pollutants like PM2.5. Here is how the data flows from the feed to your chat.

Air quality outcomes

What you get from the data

The AI pulls raw data from AQICN and presents it in a way that makes sense for your day.

CURRENT

Local air status

The AI uses your IP to find your current air quality. You get an instant snapshot of the air you are breathing right now.

REMOTE

City-specific data

Ask about a different city to see its current pollutant levels. This works for any location covered by the AQICN network.

DETAILS

Pollutant breakdown

The AI identifies specific risks like PM2.5 or Ozone. You get the exact numbers behind the general air quality index.

HUMAN

Health decisions

The AI provides the data, but you decide if it's a good day to run outside or keep the windows closed.

The workflow

What your AI does when the request arrives.

The AI acts as a bridge between your chat and the AQICN data feeds.

  1. Locate you

    If you ask about your current air quality, the AI identifies your location via your IP address.

    get_ip_feed

  2. Target a city

    When you name a specific city, the AI fetches the data feed for that exact location.

    get_city_feed

  3. Analyze pollutants

    The AI parses the incoming data to find specific pollutant concentrations.

    get_city_feed

  4. Report results

    The AI translates the raw AQI numbers into a plain English summary for you.

    get_ip_feedget_city_feed

Try it

Copy these to start.

Use these prompts to get moving immediately.

Starting points

Swap out the city names or specific pollutants to get different results.

AQICN Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_lJEtbIQaE8H7EM0Txic6EDgpVsYJn0QI5a5C9KWm/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 — AQICN capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "aqicn-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_lJEtbIQaE8H7EM0Txic6EDgpVsYJn0QI5a5C9KWm/mcp"
    }
  }
}
Copy into chat04

  • What is the air quality like where I am right now?

  • Check the air quality in Tokyo and tell me the PM2.5 levels.

  • Is the air quality in London safe for someone with asthma today?

  • Compare the air quality in New York versus Los Angeles.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect AQICN once, then ask.

Click the link to connect the MCP to your client. Your credentials stay encrypted, and you can start asking questions immediately.

Connect AQICN to your AI

FAQ

How this task behaves

  • 01

    Can the AI tell me if I should wear a mask?

    The AI provides the pollutant levels and AQI data, but it cannot give medical advice or tell you what to wear.

  • 02

    Does the AI update the air quality data automatically?

    No. The AI only fetches fresh data from the AQICN feeds when you ask it a question.

  • 03

    Can the AI change my location settings?

    No. The AI can only read data from your IP or a city you name; it cannot change your device settings.

  • 04

    Can I get historical air quality data?

    No. The available tools only provide current, live feeds for your location or a specific city.

  • 05

    Does this work for any city in the world?

    It works for any city that is included in the AQICN data network.

  • More questions about AQICN? The Connector page answers them. See everything the AQICN Connector can do

Connect AQICN to Claude, Cursor, ChatGPT & more