How to Use the AQICN MCP in Windsurf

Q: How do I search for a specific air quality station using this setup?

Ask Cascade to look up a location. It will call searchstations with your query, parse the list of matching global sensors, and present the most relevant station IDs directly in your chat sidebar.

Q: How does this MCP Server protect my location data when using IP-based feeds?

When Cascade calls getipfeed, your actual IP address is processed inside a secure, ephemeral V8 isolate sandbox. The raw IP is never stored on disk, and only the resulting air quality index data is returned to your local Windsurf workspace.

Feed real-time global air quality data via this MCP Server directly into Windsurf so Cascade can build environmental widgets instantly.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect AQICN MCP to Windsurf

Create your Vinkius account to connect AQICN 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 AQICN with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Map regional pollution trends autonomously in Windsurf

Cascade pulls coordinates directly from your workspace and feeds them to `get_map_bounds` to isolate active monitoring stations. It doesn't stop to ask for permission; it just sweeps the bounding box, maps the sensor density, and drops the raw data right into your local project folder. You get a clean dataset of active monitoring points without writing a single API fetch wrapper. If a station looks offline, this AQICN MCP Server lets Cascade automatically run `get_station_feed` to isolate the dead node and flag it in your UI.

Build location-aware weather widgets instantly

Tell Cascade to build a local weather widget and watch it use `get_ip_feed` to find the user's nearest monitoring station. The agent grabs the current PM2.5 levels, temperature, and ozone metrics in one quick pass. Instead of hardcoding static fallback coordinates, your project now adapts to whoever runs it. Cascade writes the React hooks, links the API payload, and tests the UI state using live AQICN environmental feeds.

Automate city-wide air quality comparisons

Give Cascade a list of global capitals and it will recursively run `search_stations` to find the most accurate sensors for each city. It chains these calls back-to-back, resolving messy city names into precise station IDs without human intervention. Once it has the IDs, Cascade executes `get_city_feed` for each target to compile a live comparative markdown table in your workspace. You set the goal once, and the agent handles the entire lookup pipeline.

Setup guide

Set up AQICN 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 AQICN 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 AQICN payment history." If connected, Cascade will call the AQICN tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "aqicn-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 AQICN. 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 AQICN 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 AQICN MCP in Windsurf

You paste your token into the Vinkius dashboard, and Vinkius handles the connection. Cascade accesses the server through a single secure endpoint, meaning you never have to hardcode your AQICN API key inside your local configuration files.

Yes, Cascade excels at this. You can tell it to find stations in a region using `get_map_bounds` and then have it automatically run `get_station_feed` on each station ID it discovers to compile a detailed local pollution report.

No, you can add it with one click if you use the built-in MCP panel. Alternatively, paste the Vinkius URL under the `mcpServers` key in your local config, click refresh, and Cascade instantly discovers all five air quality tools.

Ask Cascade to look up a location. It will call `search_stations` with your query, parse the list of matching global sensors, and present the most relevant station IDs directly in your chat sidebar.

When Cascade calls `get_ip_feed`, your actual IP address is processed inside a secure, ephemeral V8 isolate sandbox. The raw IP is never stored on disk, and only the resulting air quality index data is returned to your local Windsurf workspace.

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