agorio — open-source SDK for building AI commerce agents on UCP + ACP

[Nolpak14]

We just open-sourced agorio — a TypeScript toolkit for building AI agents that can discover merchants, browse products, and complete purchases using UCP and ACP.

What it does

agorio gives developers everything needed to build shopping agents on top of the commerce protocols:

• ShoppingAgent — LLM-driven plan-act-observe loop with 12 built-in shopping tools (discover, browse, search, cart, checkout, orders)
• UcpClient — discovers merchants via /.well-known/ucp, normalizes capability formats, resolves REST/MCP/A2A transports
• LLM Adapters — provider-agnostic interface (Gemini ships first, Claude and OpenAI coming)
• MockMerchant — full UCP-compliant Express server for testing with configurable latency and error rates

Quick example

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 }),
});

const result = await agent.run(
  `Go to ${merchant.domain} and buy me wireless headphones`
);

console.log(result.checkout?.orderId); // "ord_..."
await merchant.stop();

Full purchase flow — merchant discovery, catalog search, cart management, checkout with shipping and payment — all driven by an LLM.

Why we built this

With 4.8M Shopify merchants discoverable via MCP, 1.5M Stripe merchants ready for ACP, and payment rails from Visa/Mastercard enabling agent transactions — the infrastructure is landing. But there's no developer toolkit for building on top of these protocols. LangChain and CrewAI are generic. Apify is web scraping. Nobody provides commerce-specific tools, protocol clients, or test infrastructure.

agorio fills that gap.

Links

• GitHub: https://github.com/Nolpak14/agorio
• npm: npm install @agorio/sdk
• License: MIT

37 tests passing, TypeScript types included. We'd love feedback from the UCP community — especially around capability negotiation edge cases and transport binding support.