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.
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
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 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.
MCP.so
AOI is listed on MCP.so — a third-party MCP directory where agents discover MCP servers. Verified and featured.
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.
{
"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 + provenancetools/list returns every sellable capability with inputs and pricing.
request_quote returns a binding, deterministic price — no execution yet.
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.
{
"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.