AQICN MCP Server

An MCP server to get Air Quality Data using AQICN.org

Catalog onlyCatalog onlySTDIO

Overview

AQICN MCP Server is a Model Context Protocol (MCP) server that provides air quality data tools from the World Air Quality Index (AQICN) project, allowing users to fetch real-time air quality data for cities and coordinates worldwide.

To use the AQICN MCP Server, install it via Smithery or manually set up your Python environment, configure your API key, and run the server to access air quality data.

Fetch air quality data for specific cities or coordinates. - Search for air quality monitoring stations by keyword. - Provides real-time air quality index (AQI) data.

Monitoring air quality in urban areas.
Researching environmental data for academic purposes.
Integrating air quality data into applications for public awareness.

Add to your AI client

Use these steps to connect AQICN MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "aqicn-mcp-mattmarcin": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-aqicn-mcp-mattmarcin"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "aqicn-mcp-mattmarcin": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-aqicn-mcp-mattmarcin"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "aqicn-mcp-mattmarcin": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-aqicn-mcp-mattmarcin"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "aqicn-mcp-mattmarcin": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-aqicn-mcp-mattmarcin"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "aqicn-mcp-mattmarcin": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-aqicn-mcp-mattmarcin"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "aqicn-mcp-mattmarcin": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-aqicn-mcp-mattmarcin"
      ]
    }
  }
}

FAQ

What data can I retrieve using this server?

You can retrieve air quality data including AQI values, dominant pollutants, and station information.

Is there a cost to use the AQICN MCP Server?

The server is free to use, but you need to sign up for an API key from AQICN.org.

Can I use this server for commercial applications?

Yes, as long as you comply with the licensing terms.

Research and data