Shopify Agent

Shopify Universal Commerce Protocol (UCP) exposes agentic commerce flows through MCP tools for catalog search, cart management, checkout, and order lookup.

In Agent Forge, the Shopify Agent block connects to a Shopify UCP MCP server registered in workspace settings. Each operation maps to a UCP tool name such as search_catalog, create_cart, or complete_checkout. When checkout requires buyer review, inspect the continueUrl output for browser handoff.

Usage Instructions

Register a Shopify UCP MCP server in workspace settings (Catalog, Cart, Checkout, or Order endpoint), select that server in the block, then choose an operation. Cart, checkout, and order operations also require a merchant storefront URL.

For general MCP setup, see the MCP documentation and MCP Tool block.

Operations

Catalog

search_catalog - Search the merchant catalog
lookup_catalog - Look up products or variants by ID
get_product - Get a single product

Cart

create_cart - Create a cart with line items
get_cart - Retrieve cart state
update_cart - Update cart contents or buyer details
cancel_cart - Cancel a cart

Checkout

create_checkout - Start checkout from a cart
get_checkout - Retrieve checkout state
update_checkout - Update checkout details
complete_checkout - Complete checkout when ready
cancel_checkout - Cancel checkout

Orders

get_order - Retrieve order details

Common Inputs

Parameter	Type	Required	Description
`server`	string	Yes	Workspace MCP server ID for Shopify UCP
`operation`	string	Yes	UCP commerce operation
`businessUrl`	string	Merchant ops	Storefront URL for cart, checkout, and orders
`agentProfileUrl`	string	No	UCP agent profile URL for MCP metadata
`searchQuery`	string	For search	Catalog search query
`lookupIds`	string	For lookup	Product or variant GIDs
`productId`	string	Product ops	Shopify product GID
`variantId`	string	Line items	Shopify variant GID
`quantity`	number	Line items	Item quantity
`cartId`	string	Cart / checkout	Cart GID
`checkoutId`	string	Checkout ops	Checkout GID
`orderId`	string	For get order	Order GID
`payload`	json	No	Additional UCP request body merged with fields above

Output

Parameter	Type	Description
`content`	array	Raw MCP tool response content
`continueUrl`	string	Browser handoff URL when buyer action is required
`result`	json	Full MCP tool response payload

Notes

Category: tools
Type: shopify_ucp
Tools are resolved dynamically from the selected Shopify MCP server.
See the Shopify UCP quickstart for server setup details.

Shopify Agent

On this page