# Air Quality in the Paris Region AI Agent Connect > Air Quality in the Paris Region (Airparif) connects your AI agent to the official Île-de-France air quality API. It provides daily forecasts for specific communes or intercommunalities, tracks high-pollution episodes, and lets you pull hourly history or route-based forecasts for planning outdoor activities. ## Overview - **Category:** environment - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_gLllVxsllD4B6YnpKlGFYe4z00LpgvNNGcwbhlPk/ai-agent-connect - **Tags:** paris, france, air-quality, airparif, aqhi, horair, pollution-episodes, api-key ## Description This MCP gives your AI client direct access to official Airparif data for the Île-de-France region. Instead of searching through web dashboards, you can ask your agent for specific air quality indices for a commune using its INSEE code or for an entire territory using a SIREN code. You can check if a high-pollution episode is currently active or planned, which is useful for deciding if it is safe to exercise outdoors. If you need to look backward, you can pull hourly concentration history for specific pollutants like NO2, O3, or PM2.5 at any latitude and longitude. For those planning travel, the MCP provides hourly forecasts along a specific route. It handles the authentication via an Airparif API key, making it easy to pull official color-coded quality scales or narrative bulletins directly into your workflow. ## Tools ### air_index_colors This tool provides the official color legend for air quality. Use it to translate quality words into the standard color scale for your reports or UI. ### air_key_info This tool checks your Airparif API key status. Use it to diagnose 403 errors by verifying if your key is missing, invalid, or expired. ### air_bulletin This tool retrieves the official narrative bulletin from Airparif forecasters. It provides the context behind the numeric air quality indices. ### air_high_pollution_episodes This tool identifies active or planned high-pollution episodes. It returns official messages and status updates for today and tomorrow. ### air_hourly_history This tool pulls hourly air quality history for a specific coordinate. You can request data for pollutants like no2, o3, pm10, or pm25 over a lookback period of up to 500 hours. ### air_hourly_route This tool forecasts hourly air quality along a specific path. Provide at least two longitude and latitude pairs to see how air quality changes along your route. ### air_index_forecast This tool provides daily air quality index forecasts for specific communes. Use an INSEE code to get the overall index and specific pollutant levels. ### air_index_interco This tool delivers daily air quality forecasts at the intercommunality level. It uses SIREN codes to define the territory. ## Prompt Examples **Prompt:** ``` What will the air quality be in central Paris tomorrow? ``` **Response:** ``` Using air_index_forecast for INSEE 75056, the forecast shows the daily index and specific pollutant levels. You can also use air_index_colors to see the official color scale and air_bulletin for the forecasters' written report. ``` **Prompt:** ``` Is there a high-pollution episode in effect? ``` **Response:** ``` The air_high_pollution_episodes tool shows if an episode is currently active or planned, including the official status for today and tomorrow and the official messages in English and French. ``` **Prompt:** ``` Plan a bike trip across Paris this Sunday around the air quality ``` **Response:** ``` The air_hourly_route tool can forecast the hourly index along your specific path for Sunday. You can combine this with air_high_pollution_episodes to ensure no active pollution alerts affect your trip. ``` ## Capabilities ### Commune-level forecasting Your agent uses INSEE codes to get precise daily air quality indices for specific towns or sectors. ### Route-based planning The AI calculates hourly air quality forecasts along a path defined by longitude and latitude pairs. ### Pollution episode alerts Your agent can check for active or upcoming high-pollution events and retrieve official government messages. ### Historical data retrieval The AI pulls hourly concentration history for specific pollutants at any given coordinate. ### Territory-wide monitoring Your agent uses SIREN codes to pull air quality data for entire intercommunalities. ## Use Cases ### Cycling Route Planning Ask your agent to find the cleanest path for a bike ride by checking hourly forecasts along a specific route. ### Health Monitoring Check for active high-pollution episodes to determine if outdoor exercise is advisable today. ### Environmental Analysis Retrieve historical NO2 or PM2.5 levels for a specific location to study air quality trends. ### Local Government Reporting Use the official color scales and forecaster bulletins to generate environmental status reports. ## Benefits - Access official Airparif data without manual API coding. - Get precise air quality forecasts for specific coordinates or communes. - Monitor real-time pollution episodes through your AI interface. - Analyze historical pollutant concentrations for specific locations. ## How It Works Connect your AI client to the Vinkius-hosted MCP and start querying Airparif data immediately. 1. Connect your preferred MCP-compatible client to Vinkius. 2. Provide your Airparif API key in the configuration. 3. Ask your AI agent for air quality data using natural language. 4. The agent calls the specific Airparif tool to fetch the data. 5. Your agent presents the forecast, history, or alert status to you. ## Frequently Asked Questions **Do I need my own Airparif API key?** Yes, you need a free API key from Airparif to authenticate the calls. You will provide this key when setting up the MCP. **Which regions does this MCP cover?** This MCP provides data specifically for the Île-de-France region via the official Airparif API. **How can I check air quality for a specific town?** You can use the air_index_forecast tool by providing the 5-digit INSEE code for that commune. **Can I get data for a specific route?** Yes, the air_hourly_route tool allows you to provide longitude and latitude pairs to forecast air quality along a path. **What happens if I get a 403 error?** Use the air_key_info tool to check if your API key is valid, expired, or if it has the necessary permissions. **Do I need an API key, and is it free?** Yes — one key, free: Airparif issues it for its open API. This MCP requires the AIRPARIF_API_KEY credential; every call sends it in the X-Api-Key header. Without it the calls fail with a 403 "Api Key missing" — run air_key_info to check the configured key's state. **Which pollutants can I request?** One or more of: indice (the air quality index itself), no2, o3, pm10, pm25 — comma-separated in the pollutant parameter of the hourly tools. The default is indice only. **How do I get the INSEE / SIREN codes for a place?** The Paris commune is INSEE 75056 and the four Paris sectors are 75101–75104; other communes keep their standard 5-digit INSEE code. Intercommunalities (EPCI/EPT) are keyed by their 9-digit SIREN code. air_index_forecast falls back to the platform's default scope when insee is omitted. **What do the 403 responses mean?** A 403 "Api Key missing" means no credential is configured; a 403 "Invalid key" means the key is not accepted by the platform. In both cases, start from air_key_info, which returns the key's expiration timestamp and its granted rights.