AQICN MCP Server
About
An MCP server to get Air Quality Data using AQICN.org
Explore
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
AQICN MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
To install AQICN MCP Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @mattmarcin/aqicn-mcp --client claude
We recommend using uv to manage your Python environment:
uv pip install -e .
Create a .env file in the project root (you can copy from .env.example):
Using the MCP Python client:
from mcp import Client
async with Client() as client:
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"aqicn mcp server": {
"aqicn-mcp": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@mattmarcin/aqicn-mcp",
"--client",
"claude"
]
}
}
}
}McpServers
{
"aqicn-mcp": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@mattmarcin/aqicn-mcp",
"--client",
"claude"
]
}
}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.
Installation
Installing via Smithery
To install AQICN MCP Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @mattmarcin/aqicn-mcp --client claude
Installing via recommended uv (manual)
We recommend using uv to manage your Python environment:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
