Advertise
MCP.so
Sign In

AQICN MCP Server

@mattmarcin

Repository

Basic information

Category

Other

Transports

stdio

Author

mattmarcin

About AQICN MCP Server

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

#aqicn#air-quality#data-tools

AQICN MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "aqicn-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@mattmarcin/aqicn-mcp",
        "--client",
        "claude"
      ]
    }
  }
}

AQICN MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

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")

Frequently asked questions

1

What tools are available?

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

2

How do I install the server?

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

3

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.

4

What data does `city_aqi` return?

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

5

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.

Comments

More Other MCP servers

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K
Advertise