AQICN MCP Server

What is AQICN MCP Server?

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

How to use AQICN MCP Server?

Install via Smithery (npx -y @smithery/cli install @mattmarcin/aqicn-mcp --client claude) or manually with uv pip install -e .. Set the AQICN_API_KEY environment variable in a .env file or export it. Run in development mode with mcp dev aqicn_server.py, install in Claude Desktop with mcp install aqicn_server.py, or execute directly with python aqicn_server.py. Use the provided tools (city_aqi, geo_aqi, search_station) via the MCP client.

Key features of AQICN MCP Server

• city_aqi: get air quality data by city name
• geo_aqi: get air quality data by coordinates
• search_station: search monitoring stations by keyword
• Real‑time AQI, station, pollutant, time, coordinates
• Worldwide coverage through the AQICN project

Use cases of AQICN MCP Server

• Retrieve the current AQI for a specific city (e.g., Beijing)
• Get air quality data for a location using latitude/longitude (e.g., Tokyo)
• Search for monitoring stations matching a keyword (e.g., "london")

FAQ from AQICN MCP Server

What tools are available?

Three tools: city_aqi (by city name), geo_aqi (by coordinates), and search_station (by keyword).

How do I install the server?

Install automatically via Smithery or manually using uv and pip install -e ..

How do I set up the API key?

Create a .env file with AQICN_API_KEY=your_key or set it as an environment variable in your shell.

What data does city_aqi return?

Returns AQI value, station name, dominant pollutant (if available), measurement timestamp, and station coordinates.

How do I search for stations?

Use the search_station tool with a keyword (city name, station name, etc.) to get a list of matching stations with their IDs and coordinates.