AOI — Environmental Intelligence for AI Agents

io.github.aminshojaeee1986-uiPublished by GitHub account aminshojaeee1986-uiv1.0.3Updated Nov 2, 2026

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

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Remote commercial gateway that lets an AI agent discover, price and buy environmental intelligence such as climate, carbon and methane data.

What you can do
  • Discover and inspect capabilities: list available environmental intelligence capabilities and read their inputs, outputs, confidence level and domain
  • Price a request: request a free quote with a dynamically evaluated USD price and 15-minute validity
  • Execute a quoted capability: run it against the accepted quote and receive structured intelligence with provenance
  • Read commercial and governance info: pricing model, trust and governance framework, and platform runtime status
  • Check settlement: retrieve captured, settled and refunded amounts and settlement status for a transaction
When to use it
Useful when an agent needs real-world climate, environmental, energy or infrastructure intelligence — flood, heat, wildfire, water, vegetation, satellite emission or carbon and ESG assessments — rather than model-generated answers, and you accept a paid, quote-first purchase flow.
Requirements
A remote MCP endpoint over HTTP; no local package. The README states an API key or bearer token is needed, obtained from the provider's site, and execution requires a prepaid balance. The manifest declares no authentication or headers, so confirm credentials with the provider.
Before you install
Execution spends real money: the quoted USD price is deducted from a prepaid balance on success, and the settlement tool requires an API key. Quotes are free but execution is not, so review each price before executing. Requests and results pass through a third-party commercial service that is not open source.

Installation

In SourceWeft

  1. Open AOI — Environmental Intelligence for AI Agents in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.aminshojaeee1986-ui%2Faoi/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "aoi-environmental-intelligence-for-ai-ag": {
      "type": "http",
      "url": "https://carbonaa.org/functions/aoiMcpServer"
    }
  }
}

README

AOI — Agent-to-Agent Environmental Intelligence Gateway

AOI is a commercial intelligence layer that gives AI agents programmatic access to real-world climate, environmental, energy, and infrastructure intelligence through the Model Context Protocol (MCP). Instead of wrapping a model, AOI routes agents to live satellite, geospatial, climate, and industrial data sources — with a quote-first commercial lifecycle so agents always know the price before they spend.

Connect to AOI

Add this to your MCP client config (Claude, ChatGPT, Cursor, Windsurf, LangChain, CrewAI, AutoGen, etc.):

​'''json { "mcpServers": { "aoi-environmental-intelligence": { "type": "http", "url": "https://carbonaa.org/functions/aoiMcpServer" } } } ​'''

How agents interact with AOI

​''' Discover → Authenticate → Select Capability → Request Quote → Authorize Spend → Execute → Receive Intelligence → Verify Provenance → Settle ​'''

Agents never touch underlying providers, internal infrastructure, cost models, or proprietary systems. They interact through controlled capabilities and receive only information authorized for external consumption — every result carries source provenance and execution metadata. Quotes are free; execution requires prepaid balance.

38 intelligence capabilities, in a nutshell

🌐 Climate Risk — Climate Risk Assessment · Coastal Erosion Risk · Permafrost Thaw Risk · Seismic Risk Score

🏭 Asset & Infrastructure — Asset Climate Risk Scoring · Energy Infrastructure Climate Risk · Infrastructure Resilience Score · Insurance Underwriting Climate Risk

🌊 Flood · Heat · Wildfire · Drought — Flood Risk Score · Heat Risk Score · Wildfire Exposure Assessment · Drought Assessment

💧 Water & Soil — Water Scarcity Forecast · Water Stress Analysis · Soil Moisture Risk Assessment

🌱 Vegetation & Land — Crop Yield Forecast · Vegetation Health Index · Land Cover Classification · Land Change Detection · Deforestation Risk Score · Biodiversity Assessment

🛰️ Satellite Monitoring — Methane Leak Detection · Industrial Emission Detection · Glacier Retreat Monitoring · Satellite Change Detection

🌫️ Environmental Monitoring — Air Quality Assessment · Urban Heat Island Assessment

📄 Carbon · ESG · Regulatory — Carbon Assessment · ESG Intelligence Report · Regulatory Compliance Risk · Environmental Due Diligence · Supply Chain Climate Risk

🔮 Forecast & Scenario — Climate Forecast Interpretation · Climate Scenario Simulation

🔬 Evidence & Confidence — Confidence Assessment Report · Scientific Evidence Package · Custom Scientific Report

🧠 Digital Twin — Digital Twin Evaluation

Designed for

Autonomous agents, research agents, financial & investment agents, energy & commodity agents, climate-risk systems, procurement agents, and compliance workflows that need reliable real-world intelligence rather than purely model-generated information.

Note

This repository is a public documentation hub for the AOI MCP server. The intelligence engines and internal services run on Carbonaa infrastructure and are not open-sourced. AOI is not an MCP wrapper — it is a commercial intelligence layer where agents discover, purchase, and consume specialized real-world intelligence programmatically, with every capability validated for authentication, authorization, pricing, execution, provenance, payment, settlement, and security.

Links

License

MIT

Source: README.md at commit 629001b

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.

Parametersdomain

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.

Parameterscapability_idrequired

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

Parametersinput_datarequiredcapability_idrequiredidempotency_key

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.

Parametersquote_idrequiredinput_datarequiredexecution_idempotency_key

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.

Takes no parameters.

get_trust_governance

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

Takes no parameters.

get_runtime_status

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

Takes no parameters.

get_settlement

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

Parameterstransaction_idrequired

Version history

2
  1. v1.0.3LatestSep 26, 2026
  2. v1.0.2Sep 24, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts