Introduction

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.

The quad-protocol

Agorio speaks four protocols out of the box and auto-detects which one a merchant uses:

  • UCP — Universal Commerce Protocol (Google / Shopify lineage). Discovery via /.well-known/ucp, with REST or MCP transport auto-selected.
  • ACP — Agentic Commerce Protocol (OpenAI / Stripe lineage). Checkout-session lifecycle plus a webhook-delivered order model.
  • AP2 — Agent Payments Protocol (FIDO lineage). Cryptographically signed payment mandates.
  • MCP — Model Context Protocol. Tool/resource/prompt transport for arbitrary servers.

See Protocols for a page on each.

Quickstart

Install the SDK:

npm install @agorio/sdk

Spin up an agent against a built-in mock merchant — no real credentials required:

import { ShoppingAgent, GeminiAdapter, MockMerchant } from '@agorio/sdk';
 
const merchant = new MockMerchant();
await merchant.start();
 
const agent = new ShoppingAgent({
  llm: new GeminiAdapter({ apiKey: process.env.GEMINI_API_KEY }),
  verbose: true,
});
 
const result = await agent.run(`Go to ${merchant.domain} and buy me wireless headphones`);
console.log(result.answer);
console.log(result.checkout?.orderId);

That’s the whole loop: the agent discovers the merchant, searches the catalog, adds the item to a cart, and completes checkout — narrating each step when verbose is on.

Where to go next

  • Getting Started — install, prerequisites, your first agent, and running a mock merchant locally.
  • Protocols — UCP, ACP, AP2, and MCP in depth.
  • Adapters — Shopify, WooCommerce, BigCommerce, and writing your own.
  • Agents — the ShoppingAgent loop, sub-agents, AgentChain, and sessions.
  • Plugins — the six MIT-licensed enterprise governance plugins.
  • Cloud — hosted trace explorer, RBAC, SSO, billing, and self-hosting.
  • Reference — auto-generated TypeScript API docs.
  • Migration — moving a 0.x agent to 1.0.
  • Community — plugin and adapter registries, and the certification program.
Getting Started