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.
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?
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?
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)?
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?
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?
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.