UCP Shopping Agent
Connects to a Shopify store's UCP MCP endpoint to search the product catalog, create and manage carts, and create or complete checkouts for products.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
UCP Shopping Agent
A minimal agent that connects to a Shopify store's UCP (Universal Commerce Protocol) MCP endpoint and drives search → cart → checkout — either via CLI flags or a conversational chat REPL powered by Claude.
How it works
The store's
ucp.json(.well-known/ucpmanifest) declares an MCP endpoint for shopping.This agent connects to that endpoint, discovers its tools (
search_catalog,create_cart,create_checkout,complete_checkout, ...), and calls them directly.Every call carries a
ucp-agentreference pointing at this agent's own profile — a small JSON file (public/agent-profile.json) declaring which capabilities (cart, checkout, catalog search) it supports. The store fetches that profile to decide what to allow, so it must be reachable at a public HTTPS URL.
Related MCP server: Shopify MCP Server
Setup
Install dependencies:
npm installCopy
.env.exampleto.envand fill in the values (see below).Serve the agent profile locally:
npm run serve:profileExpose it publicly with a tunnel (Cloudflare Tunnel is recommended — ngrok's free tier injects a browser-warning interstitial that breaks server-to-server profile fetches):
cloudflared tunnel --url http://localhost:8787Copy the resulting
https://*.trycloudflare.comURL, append/agent-profile.json, and set it asAGENT_PROFILE_URLin.env.
Environment variables (.env)
Variable | Required | Purpose |
| Yes | Public URL serving |
| Only for | Powers the conversational agent. |
| No | Only needed for a different audience (e.g. Shopify's global catalog service via |
| No (default | Sent as |
Usage
Scripted (CLI flags):
npm run start -- --query "snowboard" # search + cart (safe, default)
npm run start -- --query "snowboard" --checkout # + create a checkout
npm run start -- --query "snowboard" --checkout --pay --payment-token TOKEN # + complete itConversational (Claude-driven chat):
npm run chatYou: search for a snowboard
Agent: [lists real products with prices]
You: add the first one to my cart
Agent: [adds it, or tries other variants if one's out of stock]Checkout/payment completion always requires an explicit request and a real payment credential — the agent never fabricates a payment token.
Project layout
src/manifest.ts — parses
ucp.json, resolves the MCP endpoint.src/ucpClient.ts — thin MCP SDK wrapper for the shopping tools.
src/auth.ts — optional
client_credentialsbearer token fetch.src/index.ts — scripted CLI flow.
src/agent.ts — conversational chat agent (Claude tool-use loop).
scripts/serve-profile.mjs — serves
public/agent-profile.jsonlocally.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Build, deploy and manage MaShop e-commerce projects from Claude, Cursor or any MCP client.
AI shopping gateway for product search, inventory, carts, and merchant-hosted checkout.
AI commerce for Shopify: product search, comparison, recommendations, and checkout via MCP.
Hosted Shopify MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Related MCP Servers
- AlicenseAqualityDmaintenanceLets AI assistants shop at UCP-enabled merchants through tools for discovery, checkout, discounts, fulfillment, and payment.510MIT
- AlicenseNot gradedqualityCmaintenanceEnables querying Shopify store data (products, customers, orders) via GraphQL API using read-only tools. Works with Claude Desktop via npx command.24 npmMIT
- AlicenseNot gradedqualityDmaintenanceMCP server that connects Claude to Shopify stores, enabling natural language queries and actions on products, orders, customers, inventory, and sales analytics. Includes a demo mode with bundled fixtures for trying tools without credentials.MIT
- FlicenseNot gradedqualityBmaintenanceEnables shopping a live Shopify store from inside ChatGPT or Claude with full catalog, cart, OTP login, saved addresses and payment via Cashfree, all without leaving the conversation.1-