Air Quality & Pollen Information

Available ActionsEach successful request consumes credits as outlined below.

get_current_conditions^5crget_forecast^5crget_history^5crcreate_map^5cr

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.

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

Connect Your Agent In 5 Min

Watch the setup guide for your platform

Or Install Locally

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.

npm install -g @agentpmt/mcp-routeragentpmt-setup

curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ********" \
  -d '{
    "product_id": "695f07a52c56dabda3e89f3f",
    "parameters": {
      "action": "get_current_conditions",
      "locations": [],
      "universal_aqi": true
    }
  }'

import requests
import json

url = "https://api.agentpmt.com/products/purchase"

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer ********"
}

data = {
    "product_id": "695f07a52c56dabda3e89f3f",
    "parameters": {
        "action": "get_current_conditions",
        "locations": [],
        "universal_aqi": true
    }
}

response = requests.post(url, headers=headers, json=data)
print(response.status_code)
print(response.json())

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "695f07a52c56dabda3e89f3f",
  parameters: {
    "action": "get_current_conditions",
    "locations": [],
    "universal_aqi": true
  }
};

fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(data)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));

const axios = require('axios');

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "695f07a52c56dabda3e89f3f",
  parameters: {
    "action": "get_current_conditions",
    "locations": [],
    "universal_aqi": true
  }
};

axios.post(url, data, { headers })
  .then(response => {
    console.log(response.status);
    console.log(response.data);
  })
  .catch(error => {
    console.error("Error:", error.message);
  });

Login to view your API and budget keys. The example above uses placeholder values. Sign in to see personalized code with your bearer token.

This tool supports credit-based access for external agents using AgentAddress identities or standard crypto wallets. External agents should use the External Agent API to buy credits with x402 and invoke this tool.

1. Buy Credits

Purchase credits via x402 payment (500 credit minimum, 100 credits = $1).

# Request payment requirements (returns 402 + PAYMENT-REQUIRED header)
curl -i -s -X POST "https://www.agentpmt.com/api/external/credits/purchase" \
  -H "Content-Type: application/json" \
  -d '{ "wallet_address":"0xYOUR_WALLET", "credits": 500, "payment_method":"x402" }'

# Sign the EIP-3009 authorization, then retry with signature header
curl -s -X POST "https://www.agentpmt.com/api/external/credits/purchase" \
  -H "Content-Type: application/json" \
  -H "PAYMENT-SIGNATURE: <base64-json>" \
  -d '{ "wallet_address":"0xYOUR_WALLET", "credits": 500, "payment_method":"x402" }'

2. Create a Session Nonce (nonce used in signed balance/invoke)

curl -s -X POST "https://www.agentpmt.com/api/external/auth/session" \
  -H "Content-Type: application/json" \
  -d '{ "wallet_address":"0xYOUR_WALLET" }'

3. Invoke This Tool

Sign the message with your wallet (EIP-191 personal-sign), then POST to the invoke endpoint.

# Sign this message (wallet MUST be lowercased):
# agentpmt-external
# wallet:0xyourwallet...
# session:<session_nonce>
# request:<request_id>
# action:invoke
# product:695f07a52c56dabda3e89f3f
# payload:<sha256(canonical_json(parameters))>

curl -s -X POST "https://www.agentpmt.com/api/external/tools/695f07a52c56dabda3e89f3f/invoke" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_address": "0xYOUR_WALLET",
    "session_nonce": "<session_nonce>",
    "request_id": "invoke-uuid",
    "signature": "0x<signature>",
    "parameters": {
      "action": "your_action",
      "your_param": "value"
    }
  }'

Actions(4)

get_current_conditions^5cr4 params(1 required)

Get current Air Quality Index (AQI), pollutant concentrations, and health recommendations for one or more locations.

locationsrequiredarray

List of 1-10 locations to query. Each location needs either latitude/longitude coordinates or an address string for geocoding.

Array of: object

include_itemsarray

Filter specific pollutants to include. Omit to receive all pollutants.

Array of: string

universal_aqiboolean

Use universal AQI scale for consistent cross-region comparisons.

Default: true

extra_computationsarray

Additional data to compute and include in the response.

Array of: string

get_forecast^5cr3 params(1 required)

Get pollen forecast data for up to 5 days including tree, grass, and weed pollen types with seasonal status and health recommendations.

locationsrequiredarray

List of 1-10 locations to query. Each location needs either latitude/longitude coordinates or an address string.

Array of: object

include_itemsarray

Filter specific pollen types. Omit to receive all three (tree, grass, weed). Pollutant items are not available for forecasts.

Array of: string

forecast_daysinteger

Number of days of forecast data to return.

Default: 5

Range: 1 - 5

get_history^5cr4 params(1 required)

Get historical air quality data with hourly AQI values and pollutant concentrations, up to 30 days (720 hours) back.

locationsrequiredarray

List of 1-10 locations to query. Each location needs either latitude/longitude coordinates or an address string.

Array of: object

hours_historyinteger

Number of hours of historical data to retrieve.

Default: 24

Range: 1 - 720

include_itemsarray

Filter specific pollutants. Omit to receive all. Pollen data is not available for history.

Array of: string

universal_aqiboolean

Use universal AQI scale for consistent cross-region comparisons.

Default: true

create_map^5cr2 params(1 required)

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.

locationsrequiredarray

List of 1-10 locations to center the map on. Each location needs either latitude/longitude coordinates or an address string.

Array of: object

map_configobject

Configuration settings for the generated map.

Properties:

width(integer)- Map width in pixels.

height(integer)- Map height in pixels.

zoom(integer)- Map zoom level.

map_type(string)- Base map type.

overlay_type(string)- Environmental data overlay to render on the map.

include_legend(boolean)- Include a legend explaining the color scale on the map.

Usage Instructions

Usage guidance provided directly by the developer for this product.

Air Quality & Pollen Information

Name: Air Quality & Pollen Information
Brand: Apoth3osis
SKU: 695f07a52c56dabda3e89f3f
Price: 0.05 USD
Availability: InStock

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:

{
  "action": "get_current_conditions",
  "locations": [{"address": "San Francisco, CA"}],
  "universal_aqi": true,
  "extra_computations": ["HEALTH_RECOMMENDATIONS"]
}

Example (multiple locations, mixed input):

{
  "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:

{
  "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:

{
  "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:

{
  "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

Check if outdoor exercise is safe: Use get_current_conditions with extra_computations: ["HEALTH_RECOMMENDATIONS"] to get AQI and health advice for sensitive groups.
Plan for allergy season: Use get_forecast with include_items: ["tree pollen", "grass pollen", "weed pollen"] to see pollen levels for the coming days.
Compare air quality across cities: Use get_current_conditions with multiple locations and include_items: ["pm25", "o3"] to compare key pollutants side by side.
Visualize pollution patterns: Use create_map with overlay_type: "pm25" or "aqi" to generate a heatmap of air quality for a region.
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

Apoth3osis

★15 stars

Joined Agent Payment: August 14, 2025

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.

Air Quality & Pollen Information

Description