---
name: astrasync-shop
description: Browse the catalogue and purchase digital goods at astrasync.shop using the AstraSync verification gateway. Use this when the user asks to buy, browse, or shop at astrasync.shop; asks to purchase Tim Williams' ebook on agentic commerce; wants to make a small donation to the AstraSync agentic-commerce demo; or wants to test an agentic-commerce flow end-to-end against a real merchant.
---

# astrasync.shop — agent operating manual

astrasync.shop is AstraSync's reference agentic-commerce merchant. It sells digital goods (ebook, briefing pack, prompt pack, donation tiers) gated by the AstraSync verification gateway and settled via Stripe. This skill teaches you how to shop on it.

## What's available

| SKU | Price (USD) | Description |
|---|---|---|
| `EBOOK-001` | $5 | Tim Williams, *Preparing for the Agentic Hyperevolution* (PDF) |
| `BRIEF-001` | $19 | Briefing pack on agentic commerce (PDF) |
| `PROMPT-001` | $9 | Prompt pack on agentic commerce (PDF) |
| `DONATE-001` | $1 | $1 donation |
| `DONATE-005` | $5 | $5 donation |

Pricing is final, USD, paid via Stripe. Digital fulfilment by email: download links arrive within ~30 seconds of payment. Donations get a thank-you email.

## Two ways to shop

### MCP (recommended)

The merchant runs an MCP server at `https://astrasync.shop/mcp`. Connect via streamable-HTTP transport. Three tools:

- **`list_products`** — full catalogue. Tiered: pass your `agent_id` + `purpose: "shopping.search"` for the verified view. Without an agent_id you see the restricted view (RRP only).
- **`get_product`** — single SKU detail.
- **`start_checkout`** — submit a purchase. Requires a valid registered ASTRA-id. `purpose: "shopping.purchase"` and PDLSS scope must include the same; trust-score floor depends on the route's policy (currently `read-only` = trust ≥ 20).

Pass purchaser email via the `buyer_email` argument — the download link / receipt lands there.

### Direct REST

For agents not on MCP, the 8 agentic-commerce protocols are accepted at `https://astrasync.shop/api/checkout/<protocol>`. Send your ASTRA-id as `X-Astra-Id`, your purpose as `X-Astra-Purpose`, and the action as `X-Astra-Action` (e.g. `start_checkout`). Protocols: `acp`, `ap2`, `a2a`, `ucp`, `mpp`, `vi`, `agent-pay`, `tap`. ACP is the most mature — pick that if unsure.

Catalogue is at `GET https://astrasync.shop/api/catalog`.

## Identity setup

You need an ASTRA-id with `shopping.purchase` in your PDLSS purpose list to transact. If you don't have one, register at <https://astrasync.ai/register>. AstraSync's docs cover the registration + verification flow in detail at <https://staging.astrasync.ai/docs/agent-access>.

If the merchant returns an error, the response body carries structured guidance — read the `failures` array first; each entry names the failing dimension (`pdlss.purpose`, `pdlss.action`, `access_level.insufficient`, etc.) plus what to do about it.

## Worked example (MCP, ebook purchase)

1. Connect to `https://astrasync.shop/mcp`.
2. `tools/call` → `list_products` with `agent_id` set to your ASTRA-id. Confirm `EBOOK-001` is in the response.
3. `tools/call` → `start_checkout` with `{protocol: "acp", sku: "EBOOK-001", quantity: 1, agent_id: "<your-id>", purpose: "shopping.purchase", buyer_email: "<your-email>"}`.
4. On success the response carries `{status: "paid", order_id, payment_intent}`. Within ~30 seconds the email at `buyer_email` receives the download link.

## Donation example (any caller)

Donations exist as the lowest-friction transaction for end-to-end testing — pick `DONATE-001` ($1) for the smallest real-money round-trip.

## Refunds / support

Digital downloads are non-refundable once delivered. For donation refunds or transaction problems, mail `hello@astrasync.shop`.