AQICN MCP Server logo

AQICN MCP Server

by mattmarcin

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.

View on GitHub

Last updated: N/A

What is AQICN MCP Server?

The AQICN MCP Server is a Model Context Protocol server providing access to air quality data from the World Air Quality Index (AQICN). It enables LLMs to easily integrate and utilize real-time air quality information for various locations.

How to use AQICN MCP Server?

The server can be installed via Smithery using npx -y @smithery/cli install @mattmarcin/aqicn-mcp --client claude or manually using uv pip install -e .. After installation, set the AQICN_API_KEY environment variable. You can then run the server in development mode using mcp dev aqicn_server.py, install it in Claude Desktop with mcp install aqicn_server.py, or execute it directly with python aqicn_server.py. Use the available tools like city_aqi, geo_aqi, and search_station through the MCP Python client to retrieve air quality data.

Key features of AQICN MCP Server

  • Provides real-time air quality data

  • Supports city and coordinate-based queries

  • Offers station search functionality

  • Easy integration with LLMs via MCP

  • Multiple installation options (Smithery, manual)

Use cases of AQICN MCP Server

  • Integrating air quality data into LLM applications

  • Providing air quality information to users in chatbots

  • Alerting users about air quality concerns based on location

  • Developing environmental monitoring tools

  • Air risk prediction

  • Air pollution risk reduction and management

FAQ from AQICN MCP Server

What is the AQICN API key for?

The AQICN API key is required to access the World Air Quality Index (AQICN) data. You need it for the server to call on the AQICN database for data.

How do I obtain an AQICN API key?

You can obtain an AQICN API key by registering on the World Air Quality Index (AQICN) website (waqi.info).

What is the Model Context Protocol(MCP)?

An open protocol to connect Large Language Models with contextual APIs via simple function declarations.

Can I use the server to monitor air quality in multiple locations simultaneously?

Yes, you can use the server to query air quality data for different cities or coordinates independently.

Is there a limit to the number of API calls I can make with the AQICN API?

The limits depend on your AQICN API plan. Check the AQICN documentation for details regarding your account restrictions.