Model Context Protocol

AOI for AI agents, over MCP

Three access channels — MCP, REST API, and npm SDK — to the same environmental intelligence infrastructure. Your AI agents discover capabilities, request deterministic quotes, and execute autonomously.

Three channels, one infrastructure

MCP for agent discovery, the REST API for execution, and the npm SDK for developer integration — all backed by the same AOI gateway.

Agent-native

MCP

Agent discovery & tool integration

AI agents discover AOI capabilities through Model Context Protocol (tools/list) and invoke them as tools (tools/call). The natural channel for LLM agents, ChatGPT, Claude, Cursor, and any MCP client.

  • tools/list → discover capabilities
  • request_quote → binding price
  • execute_quote → run execution
  • JSON-RPC 2.0 over HTTPS
Direct HTTP

REST API

Execution infrastructure

The same AOI gateway over plain HTTP. Use it directly from any runtime when you do not need an MCP layer. Identical authentication, pricing, idempotency, and provenance.

  • POST /functions/aoiAgentServiceGateway
  • action=catalog | quote | execute
  • X-API-Key header
  • OpenAPI 3.0.3 spec available
npm

npm SDK

Developer integration

A zero-dependency JavaScript / TypeScript client (@carbonaa/aoi-sdk) that wraps the gateway. One install, typed responses, idiomatic for application developers.

  • npm install @carbonaa/aoi-sdk
  • AoiClient with typed responses
  • Node 18+, browsers, Deno, edge
  • Zero runtime dependencies

Where to find AOI

Two distinct MCP distribution channels — a third-party directory and the official registry.

Listed · Verified · Featured

MCP.so

AOI is listed on MCP.so — a third-party MCP directory where agents discover MCP servers. Verified and featured.

!Submission pending

Official MCP Registry

AOI is not yet listed in the official MCP Registry (registry.modelcontextprotocol.io). Submission is in progress — this page will update when the listing is live.

Connect an MCP client

Point any MCP-compatible client at the AOI MCP server. Authentication uses your AOI API key.

MCP server endpoint
{
  "mcpServers": {
    "aoi": {
      "url": "https://carbonaa.org/functions/aoiMcpServer",
      "headers": { "Authorization": "Bearer YOUR_AOI_API_KEY" }
    }
  }
}

// Then in your MCP client:
//   tools/list      → discover all AOI capabilities
//   request_quote   → get a deterministic price
//   execute_quote   → execute and receive intelligence + provenance
1Discover

tools/list returns every sellable capability with inputs and pricing.

2Quote

request_quote returns a binding, deterministic price — no execution yet.

3Execute

execute_quote runs the capability and returns structured intelligence + provenance.

Connect your agent

Configuration templates for common MCP clients. Replace YOUR_AOI_API_KEY with your key from the console. These are templates — verify against your client's current MCP config format.

mcp.json
{
  "mcpServers": {
    "aoi": {
      "url": "https://carbonaa.org/functions/aoiMcpServer",
      "headers": { "Authorization": "Bearer YOUR_AOI_API_KEY" }
    }
  }
}

REST path: POST /functions/aoiAgentServiceGateway with action=catalog|quote|execute and X-API-Key header.
SDK path: npm install @carbonaa/aoi-sdk → new AoiClient({ apiKey }); aoi.catalog(); aoi.quote(capId, input); aoi.execute(quoteId).

Ready to connect your agents?

Get an AOI API key, browse capabilities, and run your first quote in minutes.

Carbonaa

Carbon offset & compliance for industry.

Solutions

Resources

Legal

© 2026 Carbonaa SA. All rights reserved. · Geneva, Switzerland
base44
Edit with Base44