How to Use the IQAir MCP in Windsurf
Monitor global air quality directly in Windsurf. Cascade chains IQAir tools to pull live pollution data without you lifting a finger.
Works with every AI agent you already use
…and any MCP-compatible client
Connect IQAir MCP to Windsurf
Create your Vinkius account to connect IQAir 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.
Automated air quality reporting in Windsurf
Cascade uses `get_nearest_city_air_quality` to pull local pollution metrics the second you open your project. It maps your location and fetches the data instantly. Stop switching windows to check environmental stats. This MCP Server feeds live sensor data straight into your context so you can build location-aware apps faster.
Browse supported regions with Windsurf
Need to verify coverage for a specific region? Cascade calls `list_supported_countries` and `list_supported_states` to map out exactly what data is available for your target area. It handles the hierarchy of locations automatically. You just define the scope, and the tools provide the precise list of available cities to query.
Validate IQAir connections in Windsurf
Run `check_api_status` to ensure your connection is live before Cascade kicks off a long-running task. It confirms API health in one go. This keeps your agent from failing mid-sequence. You get immediate feedback on the state of the backend, keeping your development cycle tight and predictable.
Set up IQAir 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 IQAir MCP
Paste the JSON snippet shown on the right into the
mcpServersobject. 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 IQAir payment history." If connected, Cascade will call the IQAir tools directly. You will see a green dot next to the server name in the MCP panel.
{
"mcpServers": {
"iqair-mcp": {
"url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}
}
}Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by IQAir. 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.
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 IQAir MCP in Windsurf
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
Start using the IQAir MCP today
We host it, we monitor it, we maintain it. You just paste one token.
