AOI — Environmental Intelligence for AI Agents

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Environmental intelligence for AI agents — climate, carbon, methane. Quote-first, prepaid.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "AOI — Environmental Intelligence for AI Agents": {
      "url": "https://carbonaa.org/functions/aoiMcpServer",
      "transport": "streamable-http"
    }
  }
}

Measured tools (8)

• discover_capabilities

  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.

  Parameters:

  • domain — string — Optional filter by scientific domain (climate_risk, carbon_assessment, water_stress, heat_risk, land_change, asset_climate_risk, etc.)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_capability_details

  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.

  Parameters:

  • capability_id (required) — string — The capability ID (e.g. climate_risk_assessment, carbon_assessment)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• request_quote

  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>).

  Parameters:

  • capability_id (required) — string — The capability ID to quote
  • input_data (required) — object — Capability-specific input parameters (e.g. {lat, lon})
  • idempotency_key — string — Optional idempotency key. Same key + same request returns the same quote.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• execute_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.

  Parameters:

  • quote_id (required) — string — The quote_id returned by request_quote
  • input_data (required) — object — The same input_data that was quoted
  • execution_idempotency_key — string — Optional idempotency key for execution. Same key returns the same result without duplicate execution.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_pricing_model

  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.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_trust_governance

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_runtime_status

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_settlement

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

  Parameters:

  • transaction_id (required) — string — The transaction to look up settlement for

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.