npm i -g @shopify/shop
# 1. Install once
npm i -g @shopify/shop

# 2. Search
shop search 'ceramic coffee dripper' \
  --ships-to  \
  --currency USD \
  --limit 25

Search over 1 billion products from millions of stores

One endpoint, no feed or index to build. Free and no account or API key required.

shop search 'ceramic coffee dripper'

Personalized search

Shoppers who sign in with Shop get results ranked by their preferences and shopping history.

  1. Men's | Brooks Ghost Trail
  2. Salomon Ultra Glide 4 Mens Trail Running Shoes - Black
  3. Men's ZigWild Trail 6 ShoesBest match
  4. Men's Roam Waterproof Trail Running Shoe | Black/Black
  5. Nike Pegasus Trail 5 Gore-Tex 'Black Anthracite' FQ0908-002Best match
  6. Men's | Altra Lone Peak 9

Shop used what it knows:Size 10Wears blackUnder $150

Precise filters in, rich product data out

search_catalog filters by price, size, color, rating, store and where it ships from. get_product returns what a page scrape can’t: every option, live stock, features, specs and every image.

// Search by words, a photo or a product

search_catalog({ query, like, price, ships_to, categories, attributes, condition, rating, shops, context })

→ { products, pagination }

// The whole product, as it is now

get_product({ id, selected, context })

→ { options, variants, metadata }

The best converting checkout in the world

Pay in one tap with Shop Pay.

Cart4

  • Pour HouseField ceramic dripper× 1$28.00
  • Kiln & Co.Stoneware mug× 2$40.00
  • NorthsidePaper filters, 100× 1$18.00
Subtotal
$86.00
Shipping
$8.00
Total
$94.00
Pay with
Visa •• 4242
Ship to
Sam Rivera, Brooklyn, NY
shop cart create --shop jwcoffeeco.myshopify.com --variant 26063531205 --quantity 2

Use Shop Pay anywhere

Shop Pay is the one wallet you need for any checkout on the web. Buyers can connect their Shop Pay to your agent.

Your agent

Shop

shop approval create --arguments @purchase.json

It pays with the buyer’s Shop Pay: run it in the shop CLI on your machine.

For each payment the buyer approves, Shop Pay issues single-use payment credentials, keeping the buyer’s real card details private from your agent. Your agent can then complete purchases anywhere in the merchant’s existing card checkout, where they’re processed like a regular card payment; no merchant integration required.

With Shop MCP and Shopify merchants, Shop Pay just works.

Tap into hundreds of millions of shoppers

One-click sign-in, with nothing to configure. Shoppers get personalized search and can track their orders in your app, and Shop handles data privacy.

shop account login

Manage orders and track deliveries

Signed in, your app sees the orders placed through it and the shopper's other active and recent orders, with tracking and delivery dates.

shop order search --activity active

Earn on every order

Earn commission when shoppers buy items your app finds. Promoted Placements is in early access.

Join the waitlist

Before you build

Do I need an AI agent?

No. Any app can call it over HTTPS. The API speaks UCP through MCP, which are JSON-RPC request formats, not a model. Each request includes an agent profile URL.

How does personalized search work?

Once a shopper signs in with Shop, every search sent with their token is ranked by their preferences, what they browse and what they’ve bought. None of that reaches your app.

Can I store the results?

No. The usage rules prohibit caching results and re-hosting merchant images. Fetch data when users need it, and load images from their source next to the listing.

Is every field always there?

No. AI-inferred attributes may be missing or wrong. Handle missing fields, display currencies, and verify availability before linking.

Is it free?

Yes. Search needs no account or key. For higher limits, create an API key in Dev Dashboard.

Dev Dashboard
Can I add Shop Pay if my agent already uses another wallet like Link?

Yes. Give millions of buyers the option to pay with the Shop Pay wallet they know and trust. Buyers connect their account, approve the purchase in Shop Pay, and your agent gets a one-time credential to complete checkout — even outside Shopify. If you’ve already integrated Link wallet, just set LINK_API_BASE_URL and LINK_AUTH_BASE_URL to https://mcp.shop.com/api/link to let buyers start using Shop Pay.

Integrate Shop MCP
More in the docs