# AOI — Environmental Intelligence for AI Agents

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

- name: io.github.aminshojaeee1986-ui/aoi
- version: 1.0.3
- connection class: R0 (autonomous)
- trust: 97/100
- quality: 63/100 (needs work)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.aminshojaeee1986-ui%2Faoi
- tools: https://api.protogrid.dev/v1/servers/io.github.aminshojaeee1986-ui%2Faoi/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "aoi": {
      "type": "http",
      "url": "https://carbonaa.org/functions/aoiMcpServer"
    }
  }
}
```


## Trust

- hygiene: 100
- liveness: 100
- freshness: 100
- provenance: 90
- drivers: +repository +namespace-matches-repo +website +reachable +uptime-99% +updated-24d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 63/100 (needs work)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2024-11-05; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 71 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: get_trust_governance (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_runtime_status (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); discover_capabilities (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 886 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 25 (weight 15)

- warn `stability.changes`: 123 tool changes in 30 days
- fail `stability.rug_pull`: 2 tools kept their name but changed most of their description in 30 days; review before trusting them

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 8, about 886 tokens to load them all
- tool set hash: 757fbd6eef1ffe45efd169e4a838946e
- tools last changed: 2026-10-14T13:15:36.341Z
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.aminshojaeee1986-ui/aoi.svg)](https://protogrid.dev/servers/io.github.aminshojaeee1986-ui/aoi)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-14 `quote_heat_risk_score` removed
  - 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).
- 2026-10-14 `quote_land_cover_classification` removed
  - 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).
- 2026-10-14 `quote_soil_moisture_risk` removed
  - 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).
- 2026-10-14 `quote_drought_assessment` removed
  - 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).
- 2026-10-14 `quote_climate_scenario_simulation` removed
  - 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).
- 2026-10-14 `quote_deforestation_risk_score` removed
  - 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).
- 2026-10-14 `quote_urban_heat_island` removed
  - 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).
- 2026-10-14 `quote_water_scarcity_forecast` removed
  - 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).
- 2026-10-14 `quote_supply_chain_climate_risk` removed
  - 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).
- 2026-10-14 `quote_digital_twin_evaluation` removed
  - 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).

Full history: https://api.protogrid.dev/v1/servers/io.github.aminshojaeee1986-ui%2Faoi/changes

## Remotes

- https://carbonaa.org/functions/aoiMcpServer (streamable-http, auth none, reachable true, uptime30d 0.99029124)

## Packages

_none_

## 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.
- `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.
- `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.
- `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.
- `get_runtime_status`: Get current platform runtime status including active capabilities count and service health. No API key required.
- `get_settlement`: Get settlement details for a transaction, including captured amount, settled amount, refunded amount, and settlement status. Requires an API key.
- `get_trust_governance`: Get AOI trust and governance framework including security model, data classification, audit trail, and zero-trust policy. No API key required.
- `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>).