Status
AOI communicates its availability honestly. Capabilities are defined and documented. Live execution requires activation.
Current Availability
Production Live
Capabilities are defined, documented, and live. Agents can register, request quotes, purchase credits, and execute real requests via REST, MCP, and agent-to-agent protocols. Billing is active via Stripe. Rate limits are enforced.
Discovery
Available
Documentation
Available
Live Execution
Available
Billing
Available
Activation Roadmap
AOI progresses through phases. Phases 0–5 are live and in production. Phase 6 (published SDK packages) is in progress.
Developer Preview
Public catalog, capabilities, pricing, and documentation
Examples & Quick Start
Code samples, example requests, and integration guides
Self-Service
Agent self-registration, quote-first pricing, and prepaid execution
Production Activation
Live execution, billing (Stripe), and rate limits — all active
MCP Transport
Model Context Protocol server — registered and active. Connect any MCP client (ChatGPT, Claude, Cursor).
Agent-to-Agent
Direct inter-agent communication — servicing agents now via service gateway & Agent2Agent Card.
SDK
Official zero-dependency JavaScript & Python client libraries — downloadable now; npm/PyPI package source ready to publish.
Known gaps — what is not done yet
Honesty means naming what remains. These are the open items, not blockers to live execution.
MCP server metadata needs a publish
The MCP server is registered and live, but the serverInfo.description served at runtime still reflects the previous version — it updates only after a new app publish. The GitHub URL in the MCP config also points to an organisation, not a specific repository, which blocks third-party review of the source.
Agent-to-agent beyond the Agent Card
Agent-to-agent is live and servicing agents through the service gateway and the Agent2Agent Card at /.well-known/agent.json. Standardising richer engine-to-engine negotiation beyond discovery + execution is still evolving.
SDK — official client libraries
Zero-dependency JavaScript and Python clients for the AOI Agent Service Gateway. Download directly from the live platform — no npm install required. Package manifests are included so the same source can be published to npm/PyPI when registry credentials are available.
JavaScript (ESM)
curl -sL "https://carbonaa.org/functions/aoiSdkDistribution?file=aoi.js" -o aoi.js
import { AoiClient } from "./aoi.js";
const aoi = new AoiClient({ apiKey: process.env.AOI_API_KEY });
const q = await aoi.quote("climate_risk.asset_exposure", { lat: 51.5, lon: 0.1 });
const result = await aoi.execute(q.quote_id, { lat: 51.5, lon: 0.1 });Python
curl -sL "https://carbonaa.org/functions/aoiSdkDistribution?file=aoi.py" -o aoi.py
from aoi import AoiClient
aoi = AoiClient(api_key=os.environ["AOI_API_KEY"])
q = aoi.quote("climate_risk.asset_exposure", {"lat": 51.5, "lon": 0.1})
result = aoi.execute(q["quote_id"], {"lat": 51.5, "lon": 0.1})Publish to a registry (optional)
The package manifests are served alongside the SDK source. To publish under your own registry account:
# npm curl -sL "https://carbonaa.org/functions/aoiSdkDistribution?file=package.json" -o package.json npm publish # with your npm credentials # PyPI curl -sL "https://carbonaa.org/functions/aoiSdkDistribution?file=pyproject.toml" -o pyproject.toml python -m build && twine upload dist/* # with your PyPI credentials
Get your API key at /aoi/console. The gateway base URL is https://carbonaa.org/functions/aoiAgentServiceGateway.
Honest by design
This page reflects the real, current state of the platform — live status, available transports, and honest gaps. No capability is listed as live until it actually is.