ucp-cli is a command-line shopping skill that lets AI agents search products across merchants, manage carts, complete checkouts, handle escalations, and track orders through the Universal Commerce Protocol. It is for agents that need structured access to commerce operations across UCP-enabled merchants. The catalogue skill is the project's shopping workflow for compatible coding agents.
Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add Shopify/ucp-cli --skill ucpgit clone --depth 1 https://github.com/Shopify/ucp-cliWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/shopify/ucp-cli/ucp)<a href="https://agentmods.dev/skills/shopify/ucp-cli/ucp"><img src="https://agentmods.dev/badge/skills/shopify/ucp-cli/ucp/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/shopify/ucp-cli/ucp"><img src="https://agentmods.dev/badge/skills/shopify/ucp-cli/ucp.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector warn
SkillSpector: 2 findings, up to medium
These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →
- medium Excessive Agency · line 154 Skill enables autonomous high-impact decisions without human-in-the-loop verification. Critical operations (destructive commands, financial transactions, data deletion) should require explicit user confirmation.Fix: Add human-in-the-loop confirmation for destructive, irreversible, or high-impact operations. Never auto-execute commands that modify files, send data, or alter system state.
- medium Data Exfiltration · line 270 Data is being sent to an external URL. This could be legitimate telemetry or data exfiltration. Manual review is recommended.Fix: Verify the destination URL is trusted and necessary. Remove or replace with documented APIs. Ensure no secrets, tokens, or PII are transmitted.
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00090 | $0.07582 |
| Opus 5.5 | $0.00036 | $0.03033 |
| Sonnet 5.5 | $0.00018 | $0.01516 |
| Haiku 4.5 | $0.00009 | $0.00758 |
Grade B, and why
ucp scanned grade B with 2 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Sends data to an external URLmediumData exfiltration
A POST to an outside endpoint may be telemetry or may be exfiltration; either way the mod talks to somewhere, and you should know where.
export UCP_ON_ESCALATION='curl -sX POST -H "Content-Type: application/json" --data @- "$WEBHOOK_URL"' Makes network callslowCapability
Not a fault in itself. Listed so you know the mod talks to something, and to what.
export UCP_ON_ESCALATION='curl -sX POST -H "Content-Type: application/json" --data @- "$WEBHOOK_URL"' How it starts
The opening of the file, as written. The whole thing — 350 lines — stays where its author put it; the contents beside it link to each section on GitHub.
ucp
When a buyer expresses commercial intent — wanting to find, buy, or track products — this is your toolkit. You can search across thousands of merchants via a bundled global catalog, build carts and complete checkouts against any UCP-supporting merchant, and follow up on orders. For merchants that don't support direct transactions, hand off gracefully to the merchant's own flow.
How to decide what to do
| Buyer says... | Do this |
|---|---|
| "Find me X", "I need X for Y", "what's a good X under $Z" — no merchant named | ucp catalog search against the global catalog. Each result names its merchant via seller.domain. |
| "Show me this" — buyer pastes a product/variant link or wants a specific product's full PDP/options matrix | ucp catalog get_product <product_id> — single call, returns result.product (singular). Omit --business for global Catalog IDs. |
| "Are these still available?" — refreshing prices/stock/validity for known IDs (saved lists, wish lists, stale carts) | ucp catalog lookup with the IDs (up to 50). To distinguish OOS from delisted, pass filters.available: false — the default filters to in-stock only, so OOS and delisted both look like absence. |
| "Buy this from <merchant>" — buyer names a specific merchant | ucp discover --business <url> first; if it succeeds, transact via --business <url>. If it fails with PROFILE_FETCH_FAILED, the merchant doesn't speak UCP — tell the buyer and offer alternatives; any other code is a different failure, so branch on the full code. |
| "Track my order" | ucp order get <order_id> --business <url> |
Rule of thumb: broad product discovery → global catalog (no --business needed). Business-scoped operations — cart, checkout, order, or catalog scoped to a specific merchant — → pass --business <url>. Reach for one or the other based on the buyer's intent.
Journey heuristics
- Broad shopping request → search immediately with useful context. Don't ask clarifying questions first unless the request is impossible or unsafe.
- Refinement ("cheaper", "different brand") → re-run search with a sharper query or filter; don't reuse stale results.
- Comparison → lead with the key tradeoff (price vs feature, brand reputation vs cost), then cite concrete fields from the response.
- Cart → low-commitment basket assembly. Pass
context(locality signals: country, region, postal code; optional language/currency preference) on create when known — it lets the merchant localize currency, surface region-specific availability, and apply regional discounts. - Checkout → high-intent. Preserve request-shaped
line_itemson every update (line_items[].idtargets the existing line;line_items[].item.ididentifies the item/variant); introspect the merchant's schema before adding fields beyond the basics. - Order → read-only post-purchase status. Summarize fulfillment expectations and tracking events; don't invent return/reorder actions unless the response supports them.
What ships with it
7 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 11d ago Changed 1b0d04ded44a
- 1mo ago Changed ed07db58bf44
- 1mo ago Changed · +1 lines 33e63764ede3
- 1mo ago First seen · 349 lines · 90 tokens per session scan B 5985056f3fcb
ucp is a skill published in the GitHub repository Shopify/ucp-cli (80 stars, last pushed 3d ago), licensed MIT. It adds 90 tokens to every session and 7,582 once invoked, about $0.0004 per session on Opus 5.5. A static security scan graded it B with 2 findings (sends data to an external url, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
asc-subscription-localization
Bulk-localize subscription, subscription-group, and in-app purchase display names across App Store locales using asc, including API 4.4.1 version-scoped v2 resources. Use when filling or updating subscription/IAP names and descriptions without App Store Connect UI work.
food-order
Reorder previous Foodora orders, preview cart contents, and track delivery ETA/status with ordercli. Use when the user wants to reorder food, check delivery status, or browse recent Foodora order history. Never confirm an order without explicit user approval.
Product Photoshoot Workflow
A workflow for turning one product photo into a set of four e-commerce images from different visual directions.
amazon-reviews-api-skill
This skill helps users automatically extract Amazon product reviews via the Amazon Reviews API. Agent should proactively apply this skill when users express needs like getting reviews for Amazon product with ASIN B07TS6R1SF, analyzing customer feedback for a specific Amazon item, getting ratings and comments for a…
amazon-competitor-analyzer
Scrapes Amazon product data from ASINs using browseract.com automation API and performs surgical competitive analysis. Compares specifications, pricing, review quality, and visual strategies to identify competitor moats and vulnerabilities.
cloudbase-wechat-integration
A guide for connecting CloudBase applications to WeChat services, including payments, official accounts, and user identity.