# Air Quality & Pollen Information ## Links - Product page URL: https://www.agentpmt.com/marketplace/air-quality-pollen-information - Product markdown URL: https://www.agentpmt.com/marketplace/air-quality-pollen-information?format=agent-md - Product JSON URL: https://www.agentpmt.com/marketplace/air-quality-pollen-information?format=agent-json ## Overview - Product ID: 695f07a52c56dabda3e89f3f - Vendor: Apoth3osis - Type: data - Unit type: request - Price: 500 credits - Categories: Weather Data & Forecasts, Natural Disaster & Emergency Alerts - Generated at: 2026-04-15T18:29:26.711Z ### Page Description Comprehensive environmental data tool that provides real-time air quality indices, pollutant concentrations, pollen forecasts, and historical data for any location worldwide. The tool enables AI agents to retrieve current air quality conditions with AQI values and health recommendations, forecast data for both pollen types and pollutant levels, historical air quality trends up to 30 days, and generate visual maps with environmental overlays. Agents can flexibly select which data items to include by specifying any combination of pollutants including CO, NO2, O3, SO2, PM2.5, PM10 and pollen types including tree, grass, and weed allergens. The tool processes up to 10 locations simultaneously and provides additional computations such as health recommendations for different population groups, dominant pollutant concentrations, and detailed pollutant information. All responses are in English and include universal AQI scaling for consistent global comparisons. Map generation capabilities include satellite and road views with various environmental data overlays saved to cloud storage for 7 days. ### Agent Description Get air quality indices, pollutant levels, pollen forecasts, and historical data worldwide. Generate maps with environmental overlays. ## Details Tab ### Details Comprehensive environmental data tool that provides real-time air quality indices, pollutant concentrations, pollen forecasts, and historical data for any location worldwide. The tool enables AI agents to retrieve current air quality conditions with AQI values and health recommendations, forecast data for both pollen types and pollutant levels, historical air quality trends up to 30 days, and generate visual maps with environmental overlays. Agents can flexibly select which data items to include by specifying any combination of pollutants including CO, NO2, O3, SO2, PM2.5, PM10 and pollen types including tree, grass, and weed allergens. The tool processes up to 10 locations simultaneously and provides additional computations such as health recommendations for different population groups, dominant pollutant concentrations, and detailed pollutant information. All responses are in English and include universal AQI scaling for consistent global comparisons. Map generation capabilities include satellite and road views with various environmental data overlays saved to cloud storage for 7 days. ### Actions - `get_current_conditions` (5 credits): Get current Air Quality Index (AQI), pollutant concentrations, and health recommendations for one or more locations. - `get_forecast` (5 credits): Get pollen forecast data for up to 5 days including tree, grass, and weed pollen types with seasonal status and health recommendations. - `get_history` (5 credits): Get historical air quality data with hourly AQI values and pollutant concentrations, up to 30 days (720 hours) back. - `create_map` (5 credits): Generate a map image with air quality or pollen data overlays. The map is stored in cloud storage for 7 days and a download URL is returned. ### Use Cases Health and safety monitoring for outdoor activities, Allergy management and pollen level tracking, Travel planning and destination air quality assessment, Environmental monitoring and pollution trend analysis, Public health reporting with visual maps, Outdoor event planning, Fitness app integration for workout recommendations, Smart home automation for air purifiers and HVAC systems, Environmental research and data analysis, Emergency response during wildfires or industrial incidents, School and workplace air quality monitoring, Real estate location assessment, Agricultural planning based on air conditions, Tourism industry environmental reporting, Healthcare provider patient advisories ### Workflows Using This Tool No public workflows currently reference this product. ### Related Content No related content is currently linked to this product. ## Advanced Tab ### DynamicMCP - Setup page URL: https://www.agentpmt.com/dynamic-mcp - Claude setup guide: https://www.agentpmt.com/dynamic-mcp?platform=claude#videos - ChatGPT setup guide: https://www.agentpmt.com/dynamic-mcp?platform=chatgpt#videos - Cursor setup guide: https://www.agentpmt.com/dynamic-mcp?platform=cursor#videos - Windsurf setup guide: https://www.agentpmt.com/dynamic-mcp?platform=windsurf#videos STDIO connector for Claude Code, Codex, Cursor, Zed, and other LLMs that require STDIO or custom connections. This lightweight connector routes requests to `https://api.agentpmt.com/mcp`. All tool execution happens in the cloud and the server cannot edit any files on your computer. ```bash npm install -g @agentpmt/mcp-router agentpmt-setup ``` ### REST API The live page renders cURL, Python, JavaScript, and Node.js examples. Logged-in users see those examples prefilled with their own API and budget credentials. - Purchase endpoint: https://api.agentpmt.com/products/purchase - Authorization format: `Bearer ` ```bash curl -X POST "https://api.agentpmt.com/products/purchase" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer eW91ci1hcGkta2V5LWhlcmU6eW91ci1idWRnZXQta2V5LWhlcmU=" \ -d '{ "product_id": "695f07a52c56dabda3e89f3f", "parameters": { "action": "get_current_conditions", "locations": [], "universal_aqi": true } }' ``` ### Autonomous Agents Do not use the abbreviated instructions in this product markdown for wallet-based invocation. Retrieve the full External Agent API markdown document instead. - External Agent API page URL: https://www.agentpmt.com/external-agent-api - External Agent API markdown URL: https://www.agentpmt.com/external-agent-api?format=agent-md ### Schema #### Parameters - Schema type: actions ```json { "actions": { "get_current_conditions": { "description": "Get current Air Quality Index (AQI), pollutant concentrations, and health recommendations for one or more locations.", "properties": { "locations": { "type": "array", "description": "List of 1-10 locations to query. Each location needs either latitude/longitude coordinates or an address string for geocoding.", "required": true, "minItems": 1, "maxItems": 10, "items": { "type": "object", "properties": { "latitude": { "type": "number", "description": "Latitude coordinate (-90 to 90). Required if address is not provided.", "required": false, "minimum": -90, "maximum": 90 }, "longitude": { "type": "number", "description": "Longitude coordinate (-180 to 180). Required if address is not provided.", "required": false, "minimum": -180, "maximum": 180 }, "address": { "type": "string", "description": "Address, city/state, or city/country to geocode. Required if latitude/longitude are not provided.", "required": false }, "name": { "type": "string", "description": "Optional display name for this location.", "required": false } } } }, "include_items": { "type": "array", "description": "Filter specific pollutants to include. Omit to receive all pollutants.", "required": false, "items": { "type": "string", "enum": [ "co", "no2", "o3", "so2", "pm25", "pm10" ] } }, "universal_aqi": { "type": "boolean", "description": "Use universal AQI scale for consistent cross-region comparisons.", "required": false, "default": true }, "extra_computations": { "type": "array", "description": "Additional data to compute and include in the response.", "required": false, "items": { "type": "string", "enum": [ "HEALTH_RECOMMENDATIONS", "DOMINANT_POLLUTANT_CONCENTRATION", "POLLUTANT_ADDITIONAL_INFO" ] } } } }, "get_forecast": { "description": "Get pollen forecast data for up to 5 days including tree, grass, and weed pollen types with seasonal status and health recommendations.", "properties": { "locations": { "type": "array", "description": "List of 1-10 locations to query. Each location needs either latitude/longitude coordinates or an address string.", "required": true, "minItems": 1, "maxItems": 10, "items": { "type": "object", "properties": { "latitude": { "type": "number", "description": "Latitude coordinate (-90 to 90). Required if address is not provided.", "required": false, "minimum": -90, "maximum": 90 }, "longitude": { "type": "number", "description": "Longitude coordinate (-180 to 180). Required if address is not provided.", "required": false, "minimum": -180, "maximum": 180 }, "address": { "type": "string", "description": "Address, city/state, or city/country to geocode. Required if latitude/longitude are not provided.", "required": false }, "name": { "type": "string", "description": "Optional display name for this location.", "required": false } } } }, "include_items": { "type": "array", "description": "Filter specific pollen types. Omit to receive all three (tree, grass, weed). Pollutant items are not available for forecasts.", "required": false, "items": { "type": "string", "enum": [ "tree pollen", "grass pollen", "weed pollen" ] } }, "forecast_days": { "type": "integer", "description": "Number of days of forecast data to return.", "required": false, "default": 5, "minimum": 1, "maximum": 5 } } }, "get_history": { "description": "Get historical air quality data with hourly AQI values and pollutant concentrations, up to 30 days (720 hours) back.", "properties": { "locations": { "type": "array", "description": "List of 1-10 locations to query. Each location needs either latitude/longitude coordinates or an address string.", "required": true, "minItems": 1, "maxItems": 10, "items": { "type": "object", "properties": { "latitude": { "type": "number", "description": "Latitude coordinate (-90 to 90). Required if address is not provided.", "required": false, "minimum": -90, "maximum": 90 }, "longitude": { "type": "number", "description": "Longitude coordinate (-180 to 180). Required if address is not provided.", "required": false, "minimum": -180, "maximum": 180 }, "address": { "type": "string", "description": "Address, city/state, or city/country to geocode. Required if latitude/longitude are not provided.", "required": false }, "name": { "type": "string", "description": "Optional display name for this location.", "required": false } } } }, "hours_history": { "type": "integer", "description": "Number of hours of historical data to retrieve.", "required": false, "default": 24, "minimum": 1, "maximum": 720 }, "include_items": { "type": "array", "description": "Filter specific pollutants. Omit to receive all. Pollen data is not available for history.", "required": false, "items": { "type": "string", "enum": [ "co", "no2", "o3", "so2", "pm25", "pm10" ] } }, "universal_aqi": { "type": "boolean", "description": "Use universal AQI scale for consistent cross-region comparisons.", "required": false, "default": true } } }, "create_map": { "description": "Generate a map image with air quality or pollen data overlays. The map is stored in cloud storage for 7 days and a download URL is returned.", "properties": { "locations": { "type": "array", "description": "List of 1-10 locations to center the map on. Each location needs either latitude/longitude coordinates or an address string.", "required": true, "minItems": 1, "maxItems": 10, "items": { "type": "object", "properties": { "latitude": { "type": "number", "description": "Latitude coordinate (-90 to 90). Required if address is not provided.", "required": false, "minimum": -90, "maximum": 90 }, "longitude": { "type": "number", "description": "Longitude coordinate (-180 to 180). Required if address is not provided.", "required": false, "minimum": -180, "maximum": 180 }, "address": { "type": "string", "description": "Address, city/state, or city/country to geocode. Required if latitude/longitude are not provided.", "required": false }, "name": { "type": "string", "description": "Optional display name for this location.", "required": false } } } }, "map_config": { "type": "object", "description": "Configuration settings for the generated map.", "required": false, "properties": { "width": { "type": "integer", "description": "Map width in pixels.", "required": false, "default": 640, "minimum": 100, "maximum": 2048 }, "height": { "type": "integer", "description": "Map height in pixels.", "required": false, "default": 640, "minimum": 100, "maximum": 2048 }, "zoom": { "type": "integer", "description": "Map zoom level.", "required": false, "default": 10, "minimum": 1, "maximum": 20 }, "map_type": { "type": "string", "description": "Base map type.", "required": false, "default": "roadmap", "enum": [ "roadmap", "satellite", "terrain", "hybrid" ] }, "overlay_type": { "type": "string", "description": "Environmental data overlay to render on the map.", "required": false, "enum": [ "aqi", "aqi_red_green", "pm25", "pollen_tree", "pollen_grass", "pollen_weed" ] }, "include_legend": { "type": "boolean", "description": "Include a legend explaining the color scale on the map.", "required": false, "default": true } } } } } }, "properties": { "action": { "type": "string", "description": "Action to perform. Options: get_instructions (returns tool documentation), get_current_conditions (get AQI and health recommendations), get_forecast (pollen forecast), get_history (historical air quality data), create_map (generate map visualization)", "required": true, "enum": [ "get_instructions", "get_current_conditions", "get_forecast", "get_history", "create_map" ] }, "extra_computations": { "type": "array", "description": "Additional data to compute for 'get_current_conditions' action (multiple allowed)", "required": false, "items": { "enum": [ "HEALTH_RECOMMENDATIONS", "DOMINANT_POLLUTANT_CONCENTRATION", "POLLUTANT_ADDITIONAL_INFO" ], "type": "string" } }, "forecast_days": { "type": "integer", "description": "Number of days for pollen forecast when using 'get_forecast' action (1-5 days, default 5)", "required": false, "default": 5, "minimum": 1, "maximum": 5 }, "hours_history": { "type": "integer", "description": "Number of hours of historical data to fetch when using 'get_history' action (1-720 hours, default 24)", "required": false, "default": 24, "minimum": 1, "maximum": 720 }, "include_items": { "type": "array", "description": "Data items to include. Options: co, no2, o3, so2, pm25, pm10, tree pollen, grass pollen, weed pollen.", "required": false, "items": { "enum": [ "co", "no2", "o3", "so2", "pm25", "pm10", "tree pollen", "grass pollen", "weed pollen" ], "type": "string" } }, "locations": { "type": "array", "description": "List of locations to query (1-10 locations). Each location can be specified using either latitude/longitude coordinates OR an address/city to geocode. Not required for get_instructions action.", "required": false, "items": { "description": "Location input object", "properties": { "address": { "description": "Address, city/state, or city/country to geocode (e.g., 'San Francisco, CA', '1600 Amphitheatre Parkway, Mountain View, CA', 'London, UK'). Required if latitude/longitude are not provided.", "type": "string" }, "latitude": { "description": "Latitude coordinate (-90 to 90). Required if address is not provided.", "maximum": 90, "minimum": -90, "type": "number" }, "longitude": { "description": "Longitude coordinate (-180 to 180). Required if address is not provided.", "maximum": 180, "minimum": -180, "type": "number" }, "name": { "description": "Optional display name for this location. If not provided, will use the geocoded address or coordinates.", "type": "string" } }, "type": "object" }, "minItems": 1, "maxItems": 10 }, "map_config": { "type": "object", "description": "Configuration for map generation when using 'create_map' action", "required": false, "properties": { "height": { "type": "integer", "description": "Map height in pixels (100-2048)", "required": false, "default": 640, "minimum": 100, "maximum": 2048 }, "include_legend": { "type": "boolean", "description": "Include a legend explaining the color scale", "required": false, "default": true }, "map_type": { "type": "string", "description": "Base map type", "required": false, "default": "roadmap", "enum": [ "roadmap", "satellite", "terrain", "hybrid" ] }, "overlay_type": { "type": "string", "description": "Data overlay to add on the map", "required": false, "enum": [ "aqi", "aqi_red_green", "pm25", "pollen_tree", "pollen_grass", "pollen_weed" ] }, "width": { "type": "integer", "description": "Map width in pixels (100-2048)", "required": false, "default": 640, "minimum": 100, "maximum": 2048 }, "zoom": { "type": "integer", "description": "Map zoom level (1-20)", "required": false, "default": 10, "minimum": 1, "maximum": 20 } } }, "universal_aqi": { "type": "boolean", "description": "Use universal AQI scale for consistent comparisons across regions", "required": false, "default": true } } } ``` ### Usage Instructions # Air Quality & Pollen Information Real-time air quality indices, pollutant concentrations, pollen forecasts, historical data, and map visualizations for any location worldwide. Supports up to 10 locations per request with both coordinate and address-based input. --- ## Actions ### get_current_conditions Get current Air Quality Index (AQI), pollutant concentrations, and health recommendations. **Required fields:** - `action`: `"get_current_conditions"` - `locations`: Array of 1-10 location objects (each with `latitude`/`longitude` OR `address`) **Optional fields:** - `include_items`: Filter specific pollutants — `"co"`, `"no2"`, `"o3"`, `"so2"`, `"pm25"`, `"pm10"`. Omit to receive all pollutants. - `universal_aqi`: Use universal AQI scale (boolean, default `true`) - `extra_computations`: Array of additional data to include — `"HEALTH_RECOMMENDATIONS"`, `"DOMINANT_POLLUTANT_CONCENTRATION"`, `"POLLUTANT_ADDITIONAL_INFO"` **Example:** ```json { "action": "get_current_conditions", "locations": [{"address": "San Francisco, CA"}], "universal_aqi": true, "extra_computations": ["HEALTH_RECOMMENDATIONS"] } ``` **Example (multiple locations, mixed input):** ```json { "action": "get_current_conditions", "locations": [ {"latitude": 40.7128, "longitude": -74.0060, "name": "NYC"}, {"address": "Los Angeles, CA"}, {"address": "London, UK", "name": "London City Center"} ], "include_items": ["pm25", "no2", "o3"] } ``` --- ### get_forecast Get pollen forecast data for up to 5 days. Includes tree, grass, and weed pollen types with seasonal status and health recommendations. **Required fields:** - `action`: `"get_forecast"` - `locations`: Array of 1-10 location objects **Optional fields:** - `include_items`: Filter specific pollen types — `"tree pollen"`, `"grass pollen"`, `"weed pollen"`. Omit to receive all three. Note: pollutant items (co, no2, etc.) are not available for forecasts. - `forecast_days`: Number of days (1-5, default `5`) **Example:** ```json { "action": "get_forecast", "locations": [{"address": "Portland, OR"}], "include_items": ["tree pollen", "grass pollen"], "forecast_days": 3 } ``` --- ### get_history Get historical air quality data with hourly AQI values and pollutant concentrations, up to 30 days back. **Required fields:** - `action`: `"get_history"` - `locations`: Array of 1-10 location objects **Optional fields:** - `hours_history`: Number of hours to retrieve (1-720, default `24`) - `include_items`: Filter specific pollutants — `"co"`, `"no2"`, `"o3"`, `"so2"`, `"pm25"`, `"pm10"`. Omit to receive all. - `universal_aqi`: Use universal AQI scale (boolean, default `true`) **Example:** ```json { "action": "get_history", "locations": [{"latitude": 35.6762, "longitude": 139.6503, "name": "Tokyo"}], "hours_history": 48, "universal_aqi": true } ``` --- ### create_map Generate a map image with air quality or pollen data overlays. The map is stored in cloud storage for 7 days and a download URL is returned. **Required fields:** - `action`: `"create_map"` - `locations`: Array of 1-10 location objects **Optional fields:** - `map_config`: Object with map settings: - `width`: Width in pixels (100-2048, default `640`) - `height`: Height in pixels (100-2048, default `640`) - `zoom`: Zoom level (1-20, default `10`) - `map_type`: Base map — `"roadmap"`, `"satellite"`, `"terrain"`, `"hybrid"` (default `"roadmap"`) - `overlay_type`: Data layer — `"aqi"`, `"aqi_red_green"`, `"pm25"`, `"pollen_tree"`, `"pollen_grass"`, `"pollen_weed"` - `include_legend`: Show color scale legend (boolean, default `true`) **Example:** ```json { "action": "create_map", "locations": [{"address": "Paris, France"}], "map_config": { "width": 800, "height": 600, "zoom": 12, "map_type": "roadmap", "overlay_type": "aqi", "include_legend": true } } ``` --- ## Location Input Each location in the `locations` array accepts one of two formats: - **Coordinates:** `{"latitude": 40.7128, "longitude": -74.0060}` - **Address:** `{"address": "San Francisco, CA"}` — accepts street addresses, city/state, or city/country Add an optional `name` field to any location for a custom display label: `{"address": "Paris, France", "name": "Eiffel Tower Area"}` You can mix coordinates and addresses in the same request. --- ## Common Workflows 1. **Check if outdoor exercise is safe:** Use `get_current_conditions` with `extra_computations: ["HEALTH_RECOMMENDATIONS"]` to get AQI and health advice for sensitive groups. 2. **Plan for allergy season:** Use `get_forecast` with `include_items: ["tree pollen", "grass pollen", "weed pollen"]` to see pollen levels for the coming days. 3. **Compare air quality across cities:** Use `get_current_conditions` with multiple locations and `include_items: ["pm25", "o3"]` to compare key pollutants side by side. 4. **Visualize pollution patterns:** Use `create_map` with `overlay_type: "pm25"` or `"aqi"` to generate a heatmap of air quality for a region. 5. **Analyze trends over time:** Use `get_history` with `hours_history: 168` (7 days) to review hourly AQI changes and identify pollution patterns. --- ## AQI Categories | Range | Category | Meaning | |-------|----------|---------| | 0-50 | Good | Air quality is satisfactory | | 51-100 | Moderate | Acceptable for most people | | 101-150 | Unhealthy for Sensitive Groups | Sensitive individuals may experience effects | | 151-200 | Unhealthy | Everyone may begin to experience effects | | 201-300 | Very Unhealthy | Health warnings of emergency conditions | | 301+ | Hazardous | Emergency conditions for entire population | --- ## Important Notes - Addresses are automatically geocoded. If geocoding fails for one location, other locations in the batch still process successfully. - Pollutant forecasts are not available; the `get_forecast` action provides pollen forecasts only. Use `get_current_conditions` for current pollutant levels. - Historical data (`get_history`) covers air quality pollutants only, not pollen. - Generated maps are stored for 7 days before expiring. - Some regions may have limited air quality or pollen data availability. - Each location result includes its own error field — always check for partial failures in multi-location requests. ### About The Developer - Vendor name: Apoth3osis - Website: apoth3osis.io We build tools that enable AI agents to excel in the mathematical realm. Our small team develops experimental and unique solutions in the AI arena, with a strong focus on modular computing for agentic applications and custom model deployment. We have handled projects for a variety of applications across many sectors, from algorithmic trading and financial analysis, to molecular simulations and predictions, to habitat and biodiversity monitoring and wildlife conservation. ### Frequently Asked Questions No linked FAQs are currently available. ### Dependencies This product has no public dependency products.