Does this MCP work globally?

Yes. The MCP supports data for many countries and states worldwide. You can use the list capabilities to check for supported regions before querying a specific city.

What kind of data do I get?

You get real-time Air Quality Index (AQI) scores, detailed weather information (like temperature and humidity), and specific pollutant levels (like PM2.5).

Do I need to provide coordinates every time?

No. You can ask the agent to check the nearest city using your IP address, or you can ask it to list countries and states first to guide your search.

Is this just for weather, or air quality too?

It covers both. You get full meteorological data alongside the critical air quality index and pollutant breakdown.

Can I get air quality data for my current location without entering coordinates?

Yes! You can use the get_nearest_city_by_ip capability. The agent will use your requester IP address to find and return the AQI and weather data for the closest supported city automatically.

How do I find out which cities are supported in a specific region?

You can browse the hierarchy using list_countries, then list_states for a specific country, and finally list_cities for a specific state. This allows you to discover exactly which locations have active monitoring.

Does this server provide data from specific monitoring stations?

Yes, the get_station_data capability allows you to retrieve real-time data from a specific named monitoring station if you know its name and location details (city, state, country).

An astronaut overseeing a futuristic data hub

Download PDF Markdown Version

Connect AirVisual 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 AQI and weather data for any location.

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.

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.

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 · 7 capabilities

We ship only the actions that matter.

Capability set01 / 02

01-04

4 capabilities in this set.

Part of 7 available through AirVisual.

01
Get nearest city by coords
Get data for the nearest city based on GPS coordinates
02
Get station data
Get data from a specific monitoring station
03
Get nearest city by ip
Get data for the nearest city based on IP address
04
Get city data
Get real-time AQI and weather for a specific city

Capability set02 / 02

05-07

3 capabilities in this set.

Part of 7 available through AirVisual.

05
List cities
List all supported cities in a specific state
06
List countries
List all supported countries
07
List states
List all supported states in a specific country

Real work

What teams actually run

Planning an Outdoor Run

Instead of guessing, ask your agent for the current AQI in your running area. If the pollution is high, you adjust your plans immediately.

Analyzing Pollution Trends

Environmental researchers can use the listing capabilities to gather data across multiple states and countries for large-scale analysis.

Setting Up Smart Air Filters

Integrate the MCP into a smart home system that automatically adjusts air filtration based on real-time pollution spikes in the home's location.

Travel Safety Check

Before traveling, check the air quality and weather in your destination city to prepare for potential health risks.

Automate a task

Put AirVisual 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

AirVisual 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.

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

You don't need a client to put AirVisual 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

1040ms average. Fast in production.

AirVisual is checked daily against the live service.

Daily averagePeak 1367ms

Oct 3Today

Fastest day: 688ms
Slowest day: 1367ms
14-day trend: Slowing+19%

Connect your client

One URL. Every client.

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

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

AirVisual Connector

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

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

Claude Desktop

Follow the steps below to connect in seconds.

1In Claude Desktop, open Settings → Connectors.
2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
3Click Add and start a new chat — AirVisual capabilities are ready to use.

Configuration · claude_desktop_config.jsonCopy

{
  "mcpServers": {
    "airvisual-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_VGX1iJ9zQN0X34um29FbzVGt7YkF8gKTQwxcCGbx/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 AirVisual in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work AirVisual owners hand off.

This MCP is built for anyone who needs reliable, real-time environmental data. If your work involves tracking pollution, monitoring weather patterns, or planning activities based on air quality, this connector provides the necessary capabilities. It's perfect for professionals and hobbyists alike.

01
Environmental Researchers
Gather real-time data from thousands of global stations for scientific analysis and comparative studies.
02
Health-Conscious Users
Track pollution levels and allergens in your area to safely plan outdoor activities and monitor personal exposure.
03
Smart Home Integrators
Use air quality data to trigger automated workflows, like adjusting HVAC systems based on pollution spikes.

FAQ

Questions AirVisual owners ask.

01
Does this MCP work globally?
Yes. The MCP supports data for many countries and states worldwide. You can use the list capabilities to check for supported regions before querying a specific city.
02
What kind of data do I get?
You get real-time Air Quality Index (AQI) scores, detailed weather information (like temperature and humidity), and specific pollutant levels (like PM2.5).
03
Do I need to provide coordinates every time?
No. You can ask the agent to check the nearest city using your IP address, or you can ask it to list countries and states first to guide your search.
04
Is this just for weather, or air quality too?
It covers both. You get full meteorological data alongside the critical air quality index and pollutant breakdown.
05
Can I get air quality data for my current location without entering coordinates?
Yes! You can use the get_nearest_city_by_ip capability. The agent will use your requester IP address to find and return the AQI and weather data for the closest supported city automatically.
06
How do I find out which cities are supported in a specific region?
You can browse the hierarchy using list_countries, then list_states for a specific country, and finally list_cities for a specific state. This allows you to discover exactly which locations have active monitoring.
07
Does this server provide data from specific monitoring stations?
Yes, the get_station_data capability allows you to retrieve real-time data from a specific named monitoring station if you know its name and location details (city, state, country).

Explore

More in Iot Hardware

Connect AirVisual to Claude, Cursor, ChatGPT & more

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

Each Connector runs inside its own sealed environment.

One switch stops every agent. Instantly.

Spending limits that pause instead of surprise.

We ship only the actions that matter.

01-04

Get nearest city by coords

Get station data

Get nearest city by ip

Get city data

05-07

List cities

List countries

List states

What teams actually run

Planning an Outdoor Run

Analyzing Pollution Trends

Setting Up Smart Air Filters

Travel Safety Check

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

AirVisual Connector

Claude Desktop

Environmental Researchers

Health-Conscious Users

Smart Home Integrators

Does this MCP work globally?

What kind of data do I get?

Do I need to provide coordinates every time?

Is this just for weather, or air quality too?

Can I get air quality data for my current location without entering coordinates?

How do I find out which cities are supported in a specific region?

Does this server provide data from specific monitoring stations?

Open-Meteo Air Quality AI Connector

Air Quality in the Paris Region (Airparif) AI Connector

AQICN AI Connector

EPA AirNow AI Connector

Suggestions

Google Air Quality AI Connector

IQAir AI Connector

Weather (Open-Meteo) AI Connector

Data Pipeline Prover AI Connector