AOI — Environmental Intelligence for AI Agents

List all available environmental intelligence capabilities. Returns capability IDs, names, descriptions, and domains. Use this first to see what AOI can do. Each capability requires a quote before execution. No API key required.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "Optional filter by scientific domain (climate_risk, carbon_assessment, water_stress, heat_risk, land_change, asset_climate_risk, etc.)"
    }
  }
}

Get full details for a specific capability including required inputs, expected outputs, confidence level, and domain. No API key required. Returns CAPABILITY_NOT_FOUND if the id does not exist.

{
  "type": "object",
  "properties": {
    "capability_id": {
      "type": "string",
      "description": "The capability ID (e.g. climate_risk_assessment, carbon_assessment)"
    }
  },
  "required": [
    "capability_id"
  ]
}

Request a FREE commercial quote for a capability execution. AOI dynamically evaluates the price based on the requested service. Returns quote_id, final USD price, currency, and validity (15 min). No execution happens and NO credits are consumed — review the price first, then call execute_quote. Requires an API key (X-API-Key header or Authorization: Bearer <key>).

{
  "type": "object",
  "properties": {
    "capability_id": {
      "type": "string",
      "description": "The capability ID to quote"
    },
    "input_data": {
      "type": "object",
      "description": "Capability-specific input parameters (e.g. {lat, lon})",
      "additionalProperties": true
    },
    "idempotency_key": {
      "type": "string",
      "description": "Optional idempotency key. Same key + same request returns the same quote."
    }
  },
  "required": [
    "capability_id",
    "input_data"
  ]
}

Execute a capability using an accepted quote. The quote must belong to the agent, be unexpired, and the input_data must match the quoted request. The quoted USD price is deducted from your prepaid balance on success and released on failure. Returns structured intelligence with provenance. If balance is insufficient, returns INSUFFICIENT_CREDIT (top up at https://carbonaa.org/aoi/console). Requires an API key. THIS IS THE ONLY OPERATION THAT CONSUMES PREPAID CREDITS.

{
  "type": "object",
  "properties": {
    "quote_id": {
      "type": "string",
      "description": "The quote_id returned by request_quote"
    },
    "input_data": {
      "type": "object",
      "description": "The same input_data that was quoted",
      "additionalProperties": true
    },
    "execution_idempotency_key": {
      "type": "string",
      "description": "Optional idempotency key for execution. Same key returns the same result without duplicate execution."
    }
  },
  "required": [
    "quote_id",
    "input_data"
  ]
}

Get the AOI commercial model description. AOI uses a quote-first dynamic pricing model — agents request quotes and receive a final commercial price before execution. Quotes are free; execution requires prepaid balance. No API key required.

{
  "type": "object",
  "properties": {}
}

Get AOI trust and governance framework including security model, data classification, audit trail, and zero-trust policy. No API key required.

{
  "type": "object",
  "properties": {}
}

Get current platform runtime status including active capabilities count and service health. No API key required.

{
  "type": "object",
  "properties": {}
}

Get settlement details for a transaction, including captured amount, settled amount, refunded amount, and settlement status. Requires an API key.

{
  "type": "object",
  "properties": {
    "transaction_id": {
      "type": "string",
      "description": "The transaction to look up settlement for"
    }
  },
  "required": [
    "transaction_id"
  ]
}

Energy Infrastructure Climate Risk — Domain: asset_climate_risk. Climate risk assessment for energy infrastructure assets When to use: call this when an agent needs to assess asset climate risk for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Insurance Underwriting Climate Risk — Domain: asset_climate_risk. Climate risk scoring for insurance underwriting decisions When to use: call this when an agent needs to assess asset climate risk for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Regulatory Compliance Risk Assessment — Domain: environmental_due_diligence. Assess regulatory compliance risk for environmental regulations When to use: call this when an agent needs to assess environmental due diligence for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Crop Yield Forecast — Domain: vegetation_analysis. Satellite-derived crop yield forecast for agricultural regions When to use: call this when an agent needs to assess vegetation analysis for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Infrastructure Resilience Score — Domain: asset_climate_risk. Infrastructure climate resilience scoring for critical assets When to use: call this when an agent needs to assess asset climate risk for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Supply Chain Climate Risk — Domain: environmental_due_diligence. Climate risk assessment across a supply chain network When to use: call this when an agent needs to assess environmental due diligence for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Water Scarcity Forecast — Domain: water_stress. 12-month water scarcity forecast using climate models When to use: call this when an agent needs to assess water stress for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Urban Heat Island Assessment — Domain: heat_risk. Urban heat island effect intensity and exposure mapping When to use: call this when an agent needs to assess heat risk for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Deforestation Risk Score — Domain: land_change. Rapid deforestation risk score for a region When to use: call this when an agent needs to assess land change for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Methane Leak Detection — Domain: satellite_monitoring. Satellite-based methane leak detection for oil & gas facilities When to use: call this when an agent needs to assess satellite monitoring for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Industrial Emission Detection — Domain: satellite_monitoring. Detect unauthorized industrial emissions using thermal satellite data When to use: call this when an agent needs to assess satellite monitoring for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Glacier Retreat Monitoring — Domain: satellite_monitoring. Continuous glacier retreat monitoring using satellite change detection When to use: call this when an agent needs to assess satellite monitoring for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Permafrost Thaw Risk — Domain: climate_risk. Permafrost thaw risk evaluation for Arctic infrastructure When to use: call this when an agent needs to assess climate risk for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Coastal Erosion Risk Assessment — Domain: climate_risk. Coastal erosion vulnerability using satellite imagery When to use: call this when an agent needs to assess climate risk for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Air Quality Assessment — Domain: environmental_monitoring. Air quality index and pollutant analysis for urban areas When to use: call this when an agent needs to assess environmental monitoring for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Seismic Risk Score — Domain: climate_risk. Seismic activity risk score for a location When to use: call this when an agent needs to assess climate risk for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Vegetation Health Index — Domain: vegetation_analysis. NDVI-based vegetation health and stress index When to use: call this when an agent needs to assess vegetation analysis for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Soil Moisture Risk Assessment — Domain: soil_moisture. Soil moisture drought and agricultural risk evaluation When to use: call this when an agent needs to assess soil moisture for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Custom Scientific Report — Domain: custom_research. Bespoke scientific research report for specific client requirements When to use: call this when an agent needs to assess custom research for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Climate Scenario Simulation — Domain: climate_forecast. Multi-scenario climate simulation with cascading impact analysis When to use: call this when an agent needs to assess climate forecast for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Confidence Assessment Report — Domain: confidence_assessment. Assess and report confidence levels for scientific conclusions When to use: call this when an agent needs to assess confidence assessment for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Scientific Evidence Package — Domain: evidence_generation. Generate a complete, explainable scientific evidence package When to use: call this when an agent needs to assess evidence generation for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Satellite Change Detection — Domain: satellite_monitoring. Continuous satellite-based change detection for monitored areas When to use: call this when an agent needs to assess satellite monitoring for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Digital Twin Evaluation — Domain: digital_twin. Evaluate and score a digital twin model for accuracy and completeness When to use: call this when an agent needs to assess digital twin for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

ESG Intelligence Report — Domain: esg_intelligence. ESG intelligence synthesis for investment decisions When to use: call this when an agent needs to assess esg intelligence for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Asset Climate Risk Scoring — Domain: asset_climate_risk. Climate risk scoring for specific physical assets When to use: call this when an agent needs to assess asset climate risk for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Environmental Due Diligence — Domain: environmental_due_diligence. Comprehensive environmental due diligence for mergers, acquisitions, and investments When to use: call this when an agent needs to assess environmental due diligence for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Climate Forecast Interpretation — Domain: climate_forecast. Interpret climate model forecasts into actionable intelligence When to use: call this when an agent needs to assess climate forecast for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Water Stress Analysis — Domain: water_stress. Water stress and scarcity analysis for regions When to use: call this when an agent needs to assess water stress for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Biodiversity Assessment — Domain: biodiversity. Biodiversity evaluation using multi-source ecological data When to use: call this when an agent needs to assess biodiversity for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Carbon Assessment — Domain: carbon_assessment. Carbon footprint and emissions assessment When to use: call this when an agent needs to assess carbon assessment for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Land Change Detection — Domain: land_change. Detect changes in land use between time periods When to use: call this when an agent needs to assess land change for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Land Cover Classification — Domain: land_cover. Satellite-based land cover classification When to use: call this when an agent needs to assess land cover for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Drought Assessment — Domain: drought_assessment. Drought severity and duration assessment When to use: call this when an agent needs to assess drought assessment for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Wildfire Exposure Assessment — Domain: wildfire_exposure. Wildfire exposure evaluation using satellite thermal and vegetation data When to use: call this when an agent needs to assess wildfire exposure for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Heat Risk Score — Domain: heat_risk. Heat vulnerability analysis for urban areas When to use: call this when an agent needs to assess heat risk for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Flood Risk Score — Domain: flood_risk. Rapid flood risk score for a specific location When to use: call this when an agent needs to assess flood risk for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

Climate Risk Assessment — Domain: climate_risk. Comprehensive climate risk evaluation for a geographic area or asset When to use: call this when an agent needs to assess climate risk for a specific location, facility, or asset. Returns a binding USD price and quote_id (valid 15 min); no execution yet, no credits consumed. Call execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}