AOI MCP

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",
  "required": [
    "capability_id"
  ],
  "properties": {
    "capability_id": {
      "type": "string",
      "description": "The capability ID (e.g. climate_risk_assessment, carbon_assessment)"
    }
  }
}

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

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",
  "required": [
    "quote_id",
    "input_data"
  ],
  "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."
    }
  }
}

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",
  "required": [
    "transaction_id"
  ],
  "properties": {
    "transaction_id": {
      "type": "string",
      "description": "The transaction to look up settlement for"
    }
  }
}

Advertised by the server during the last successful anonymous check.

Assess environmental risk for a specific location or asset using satellite intelligence.

location

Geographic location (coordinates, city, or region) (required)

risk_type

Type of risk: flood, wildfire, drought, heat, or comprehensive

Advertised by the server during the last successful anonymous check.

Analyze carbon market signals and price forecasts for trading or compliance decisions.

market

Carbon market: EU ETS, UK ETS, California, RGGI, or global

timeframe

Analysis timeframe: short-term, medium-term, or long-term

Advertised by the server during the last successful anonymous check.

Scan industrial facilities for emissions anomalies, methane leaks, or thermal signatures.

facility_type

Type: cement, steel, oil_gas, power, or all

region

Geographic region to scan

Advertised by the server during the last successful anonymous check.

Generate a crisis foresight scenario for strategic planning and risk preparation.

scenario_type

Type: supply_chain, geopolitical, climate_event, or market_shock (required)

region

Affected region

Advertised by the server during the last successful anonymous check.

Complete catalog of all environmental intelligence capabilities.

aoi://catalog

MIME type: application/json

Advertised by the server during the last successful anonymous check.

Transparent pricing for all capabilities. Quote-first: quotes are free; execution consumes prepaid USD credits.

aoi://pricing

MIME type: application/json

Advertised by the server during the last successful anonymous check.

Trust framework, security classifications, and governance policies.

aoi://trust

MIME type: application/json

Advertised by the server during the last successful anonymous check.

OpenAPI 3.0.3 specification for the AOI Agent Service Gateway.

aoi://openapi

MIME type: application/json

Advertised by the server during the last successful anonymous check.

Live platform runtime status and health metrics.

aoi://status

MIME type: application/json