ucp

A shopping toolkit for finding products across online stores, buying them, and tracking orders. UCP is a common way for shopping services and merchants to exchange product and order information.

In plain words
What is it for?
Searching for products across merchants, viewing product details, building carts, completing supported checkouts, and following orders.
Why use it?
It brings product search and purchase steps into one agent workflow instead of requiring separate store visits. When a merchant cannot support direct checkout, it can send the buyer to that merchant's own process.

Skill for Claude CodeCodex

Install

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.

agentmods
npx agentmods add skills/shopify/ucp-cli/ucp
Any agent
npx skills add Shopify/ucp-cli --skill ucp
Clone the repo
git clone --depth 1 https://github.com/Shopify/ucp-cli

Made for: Claude Code, Codex.

Per session 90 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 7,542 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 2 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

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.

ModelPer sessionOnce invoked
Fable 5 $0.00090 $0.07542
Opus 5 $0.00045 $0.03771
Sonnet 5 $0.00018 $0.01508
Haiku 4.5 $0.00009 $0.00754

Measured 3d ago against content hash 5985056f3fcb, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

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 3d 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"'
skills/ucp/SKILL.md · 349 lines

How it starts

The opening of the file, as written. The whole thing — 349 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.

Setup: Run ucp profile init --name agent at the start of any session. It's idempotent — re-running with an existing profile no-ops (created: false, exit 0) — so call it unconditionally rather than checking state first. This creates the local CLI identity required for all UCP operations; it's not a merchant onboarding step or a Catalog API key. See references/SETUP.md for installation paths and ucp doctor.

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, the merchant doesn't speak UCP — tell the buyer and offer alternatives.
"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.

Read the full file on GitHub · 349 lines

Files

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.

Changes

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.

  1. 3d ago First seen · 349 lines · 90 tokens per session scan B 5985056f3fcb

Subscribe to this mod's changes

ucp is a skill published in the GitHub repository Shopify/ucp-cli (67 stars, last pushed 10d ago), licensed MIT. It adds 90 tokens to every session and 7,542 once invoked, about $0.0005 per session on Opus 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.

Related

Other skills, from other repositories

cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/agent-scripts · 20 tokens

etsy-category-listing

Etsy category page scraper: given an Etsy category URL (e.g. https://www.etsy.com/c/jewelry) and optional page number, returns paginated product listings with listingId, shopId, title, url, image, salePrice, originalPrice, currency, rating, reviewCount, shopName, isAd, freeShipping, badge from category and subcategory…

browser-act/skills · 209 tokens

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…

browser-act/skills · 124 tokens

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.

browser-act/skills · 48 tokens

shopify-functions

Shopify Functions allow developers to customize the backend logic that powers parts of Shopify. Available APIs: Discount, Cart and Checkout Validation, Cart Transform, Pickup Point Delivery Option Generator, Delivery Customization, Fulfillment Constraints, Local Pickup Delivery Option Generator, Order Routing Location…

Shopify/Shopify-AI-Toolkit · 61 tokens

shopify-shopifyql

Answer a merchant's analytics and reporting questions with ShopifyQL — Shopify's query language for aggregated store metrics that the Admin GraphQL API cannot compute. Choose this (not admin) whenever the ask is for numbers, totals, trends, or breakdowns rather than fetching or mutating individual records: including…

Shopify/Shopify-AI-Toolkit · 216 tokens