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

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

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

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

P

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

Glasswarp

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

Advertise