How to Use the IQAir MCP in Cursor

Q: How do I add the IQAir MCP server to my Cursor project?

Create a .cursor/mcp.json file in your workspace root and define the server configuration. Once saved, Cursor automatically loads the MCP server tools, allowing your agent to run live queries during chat sessions.

Q: Can Cursor use IQAir tools in Agent mode to write code?

Yes, in Agent mode, Cursor calls getcityairquality to inspect the live payload format. The agent then writes exact TypeScript interfaces or Python classes matching the actual API response.

Q: Does the IQAir server require manual coordinate inputs in Cursor?

No, the getnearestcityairquality tool automatically determines the closest city based on your IP. Cursor uses this tool to let you test location-sensitive code blocks without typing dummy coordinates.

Q: How do I verify if my API key is active in this setup?

Your agent calls checkapistatus to verify your key and connection status. If there is an issue with your credentials, Cursor displays the exact error returned by the server.

Q: Is my development IP address exposed when using these tools?

The getnearestcityairquality tool uses your development machine's IP address solely to locate the nearest weather station. This IP is sent directly to the endpoint and is never stored, logged, or shared with third parties.

Fetch live IQAir pollution and weather data directly into your Cursor editor to generate code with real-world context.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect IQAir MCP to Cursor

Create your Vinkius account to connect IQAir to Cursor 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 IQAir with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build Air Quality Apps in Cursor

The `get_city_air_quality` tool feeds real-time environmental data directly into your active editor session. Your agent writes functions using live PM2.5, PM10, and temperature values instead of relying on stale placeholder data. Having this tool active in Cursor means you can write, test, and debug environmental data pipelines in real time. Your agent uses the exact JSON structure returned by the live API to build precise data models.

Validate Location Logic using Cursor MCP Server

The `get_nearest_city_air_quality` tool resolves the nearest monitoring station using your current IP address. Your agent tests location-based features inside your Cursor chat by fetching live local conditions instantly. This removes the need to hardcode coordinates while debugging your app. The MCP server provides immediate feedback on how your code handles dynamic geolocation payloads.

Generate Lists with IQAir Tools

The `list_supported_countries` tool retrieves the complete list of active countries from the global database. Your agent uses this along with `list_supported_states` and `list_supported_cities` to populate dropdown menus and validation schemas in your code. You can ask Cursor to generate database seed files or frontend configuration objects using these live directories. The agent checks `check_api_status` to ensure the registry is online before writing the generated arrays to your files.

Setup guide

Set up IQAir MCP in Cursor

Prerequisites

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

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the IQAir MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent IQAir transactions." If the MCP tools are loaded correctly, Cursor will call the IQAir tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

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

Connect IQAir 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 IQAir MCP in Cursor

Create a `.cursor/mcp.json` file in your workspace root and define the server configuration. Once saved, Cursor automatically loads the MCP server tools, allowing your agent to run live queries during chat sessions.

Yes, in Agent mode, Cursor calls `get_city_air_quality` to inspect the live payload format. The agent then writes exact TypeScript interfaces or Python classes matching the actual API response.

No, the `get_nearest_city_air_quality` tool automatically determines the closest city based on your IP. Cursor uses this tool to let you test location-sensitive code blocks without typing dummy coordinates.

Your agent calls `check_api_status` to verify your key and connection status. If there is an issue with your credentials, Cursor displays the exact error returned by the server.

The `get_nearest_city_air_quality` tool uses your development machine's IP address solely to locate the nearest weather station. This IP is sent directly to the endpoint and is never stored, logged, or shared with third parties.

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