How to Use the AirVisual MCP in Windsurf

Let Windsurf Cascade chain weather and AQI lookups automatically to monitor global air quality without manual prompting.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect AirVisual MCP to Windsurf

Create your Vinkius account to connect AirVisual to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup AirVisual with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Cascade Chains Location and AQI Lookups

Windsurf handles complex environmental workflows by letting Cascade decide how to find the right data. If you ask for the local air quality, Cascade doesn't stop to ask for your location. It runs `get_nearest_city_by_ip` to pinpoint your current location, then immediately triggers `get_city_data` using those exact coordinates. This autonomous execution means you get a complete weather and pollution report in one go. You set the goal, and this AirVisual MCP Server lets your editor handle the step-by-step API requests in the background.

Autonomous Regional Environmental Audits

When you need to analyze pollution trends across a specific region, Cascade executes the heavy lifting. Tell Windsurf to pull data for an entire region, and it will chain `list_countries`, `list_states`, and `list_cities` to build a clean directory of target areas. Once Cascade maps the structure, it queries `get_station_data` for each active monitor. You get a fully populated dataset of local air quality metrics without writing a single line of boilerplate code for this MCP Server.

Zero-Prompt GPS Weather Mapping in Windsurf

Windsurf uses this MCP Server to map environmental hazards based on raw GPS coordinates. When Cascade processes coordinates from your codebase, it feeds them straight into `get_nearest_city_by_coords` to fetch instant AQI readings. You don't have to map coordinates to city names yourself. Cascade handles the translation and delivers real-time meteorological data right inside your active editor panel.

Setup guide

Set up AirVisual MCP in Windsurf

Prerequisites

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

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the AirVisual MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my AirVisual payment history." If connected, Cascade will call the AirVisual tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "airvisual-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 AirVisual. 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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect AirVisual now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about AirVisual MCP in Windsurf

Windsurf connects to the server via your configuration file, enabling Cascade to call the tools directly. You can ask Cascade to fetch AQI data, and it will automatically run the correct tools like `get_city_data` based on your project context.

Yes, Cascade excels at chaining these tools. If you ask for a regional air report, Windsurf will call `list_states`, find the cities, and run `get_city_data` for each one without asking for permission at each step.

You add your credentials to the Vinkius platform, which securely manages the connection. Windsurf then accesses the server using a single secure endpoint token, keeping your sensitive keys out of your local config files.

Windsurf will handle the error gracefully. Cascade will first run `list_cities` to find valid alternatives in the region and suggest the closest active monitoring station to keep your work moving.

Your IP addresses and GPS coordinates are only sent to the AirVisual API to fetch local weather data and AQI metrics. Vinkius processes these requests in an ephemeral sandbox, meaning your exact location data is never logged or stored after the tool execution completes.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript