For developers

The developer stack for agent checkout.

Build software that discovers products, checks out, and pays across every Artos store. We ship a hosted MCP bridge, a TypeScript SDK, a CLI, and full protocol docs — pick the surface that fits your product.

MCP bridge · SDK · CLI · raw UCP
checkout.ts@artos-commerce/ucp-client
SDK · UCP
editor
1
2
3
✓Order placed287ms
audio.lab.artos.sui$79.00
outcomeap2 mandate · USDsui
›
Pick your surface

Three ways in. One checkout.

A hosted bridge for assistants, npm packages for your codebase, and a documented wire for everything else — all landing on the same signed, on-chain settlement. Start with the fastest; go deeper when you need control.

MCP bridge

Zero code

Your users shop through an assistant — Claude, Cursor, or any MCP client.

https://agent.artos.sh/mcp

We host the server. Cross-store search, buyer OAuth through My Artos, AP2 signing, and checkout — you paste one URL.

paste → shopping in minutes
Setup guides — Claude, Cursor & more →

SDK & CLI

TypeScript

You are shipping your own agent, backend, or app with checkout inside.

npm i @artos-commerce/ucp-client

Typed UCP transport, two-credential auth, AP2 mandate minting, rail selection — and one confirmPurchase() call that settles.

scaffold with artos init
Build with the SDK →

Raw UCP

Any language

You want the wire protocol from Python, Go, Rust — nothing between you and the API.

GET /.well-known/ucp

JSON-RPC over HTTPS with signed store responses — discovery, checkout sessions, and AP2 mandates, fully documented.

spec + conformance suite
Raw transport docs →
SDK & CLI

Embed checkout in your codebase.

For platforms shipping their own agent or backend. Two credentials, never mixed — and only confirmPurchase() moves money.

Typed UCP transport
Envelope, idempotency, and the 401 auth relay — handled for you
AP2 built in
Mandate minting and merchant-term verification, byte-parity with the API
One call settles
confirmPurchase() re-prices, verifies terms, picks the rail, and settles on-chain
ucp-cli
SDK
$npm install -g @artos-commerce/ucp-cli
$artos doctor
✓api reachable · oauth ok · ap2 keys present
$artos init my-shopping-agent
✓scaffolded · ucp-client wired
$artos catalog search "running shoes" --max 100
·Eco Runner Pro · audio.lab.artos.sui · $79.00
·Trail Lite · gearhub.artos.sui · $92.00
·+1 more · 3 stores
$artos cart create --store audio.lab --item var_eco:1
$artos checkout create --store audio.lab --cart cart_7f2a
$artos purchase confirm --store audio.lab --id chk_9k4 --pay artos.card
✓order placed · #4291 · $79.00 · settled 287ms
$
@artos-commerce/ucp-client@artos-commerce/ucp-cliShopping agent guide →
Raw UCP

Any language. Full wire control.

Skip our SDK and speak UCP directly — JSON-RPC over HTTPS with signed store responses, checkout sessions, and AP2 mandates. Ideal for Python, Go, Rust, or any stack where you want to own the client.

Raw transport docs →
api.artos.sh/mcp
Discovery
GET /.well-known/ucp
Global catalog
POST /mcp → search_catalog
Checkout
POST /s/{slug}/mcp → create_checkout · complete_checkout
Signed responses · AP2 mandates · any language
What you can build

Real products on real checkout rails.

Shopping assistants, catalog aggregators, embedded checkout, procurement bots — each card is tagged with the surface it starts from.

MCP bridge

Personal shopping agent

Search across every Artos store, compare prices, and check out in chat — OAuth and spend caps via My Artos.

SDK & CLI

Price tracker & deal feed

Index the cross-store catalog read-only — track prices, run alerts, or publish a comparison feed.

SDK & CLI

Marketplace aggregator

Discover and index every UCP store on Artos — search, filter, and route buyers without owning inventory.

SDK & CLI

Embedded checkout

Full cart → AP2 mandate → on-chain settle inside your app — platform key, SDK, and buyer OAuth.

SDK & CLI

Procurement & reorder bot

Repeat buys against a buyer account — addresses, order history, spend caps, and autonomous checkout.

Raw UCP

Custom UCP client

Speak the raw protocol from any language — discovery, signed responses, checkout, and AP2 without our SDK.

Runnable examples and guides are landing in the docs — the read-only catalog tier is live today.

Browse the docs →
Get building

Start building the agent economy.

Open the quickstart, paste the bridge URL, or install the SDK — your first purchase against a live store is minutes away.

Open the quickstart →Bridge setup guideRead the docs