# Agorio

> Agorio is an open-source TypeScript SDK for building AI commerce agents. It ships as `@agorio/sdk` on npm and lets an LLM-driven agent discover merchants, browse catalogs, and complete checkouts across four commerce protocols — UCP, ACP, AP2, and MCP. A hosted observability + control plane (trace explorer, RBAC, audit log, compliance export) is available at cloud.agorio.dev.

Install: `npm install @agorio/sdk`

Note: agorio.dev is the vendor/marketing site for the SDK and Cloud product. It is not a live merchant checkout surface — there are no payment or checkout endpoints here. To exercise the protocols, run a built-in mock merchant locally (`npx agorio mock`) or use the in-browser playground.

## Product

- [Homepage](https://agorio.dev/): What Agorio is and who it's for.
- [Pricing](https://agorio.dev/pricing): Free / Pro ($149/yr or $19/mo) / Enterprise tiers, plus the MIT-licensed plugin catalog.
- [Playground](https://agorio.dev/playground): In-browser interactive shopping agent — no account required.
- [Procurement](https://agorio.dev/procurement): B2B procurement vertical (PO tracking, vendor lookup, approval workflows).
- [Enterprise](https://agorio.dev/enterprise): Enterprise governance, self-hosting, and contact.

## Code

- [npm package](https://www.npmjs.com/package/@agorio/sdk): `@agorio/sdk`, current release v0.9.0.
- [GitHub repository](https://github.com/Nolpak14/agorio): Source, issues, and contribution guide.

## Documentation

- [Docs home](https://agorio.dev/docs): Full SDK documentation.
- [Getting Started](https://agorio.dev/docs/getting-started): Install, prerequisites, first agent, and running a mock merchant.
- [Protocols](https://agorio.dev/docs/protocols): UCP, ACP, AP2, and MCP in depth.
- [UCP](https://agorio.dev/docs/protocols/ucp): Universal Commerce Protocol — discovery via `/.well-known/ucp`, REST or MCP transport.
- [ACP](https://agorio.dev/docs/protocols/acp): Agentic Commerce Protocol — checkout sessions and webhook-delivered orders.
- [AP2](https://agorio.dev/docs/protocols/ap2): Agent Payments Protocol — cryptographically signed payment mandates.
- [MCP](https://agorio.dev/docs/protocols/mcp): Model Context Protocol — tool/resource/prompt transport.
- [Adapters](https://agorio.dev/docs/adapters): Shopify, WooCommerce, BigCommerce, and writing your own.
- [Agents](https://agorio.dev/docs/agents): The ShoppingAgent loop, sub-agents, AgentChain, and persistent sessions.
- [Plugins](https://agorio.dev/docs/plugins): Six MIT-licensed enterprise governance plugins.
- [Cloud](https://agorio.dev/docs/cloud): Hosted trace explorer, RBAC, SSO, billing, and self-hosting.
- [API Reference](https://agorio.dev/docs/reference): Auto-generated TypeScript API docs.
- [Migration](https://agorio.dev/docs/migration): Moving a 0.x agent to 1.0.

## Cloud

- [Agorio Cloud](https://cloud.agorio.dev): Hosted observability + control plane (trace explorer, API keys, audit log, EU AI Act compliance export, team admin).