MCP server

Facet UCP Shopping Official

llc.facet/ucp-shopping

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

The independent agent-commerce protocol for AI-agent checkout on any online store.

Website

At a glance

Type

MCP server

Publisher

facet.llc (verified by the MCP Registry)

Status

Working at last check

Tools

23

Token cost

About 4,895 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http ucp-shopping https://api.facet.llc/ucp/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.ucp-shopping]
url = "https://api.facet.llc/ucp/mcp"

Gemini CLI

{"mcpServers":{"ucp-shopping":{"httpUrl":"https://api.facet.llc/ucp/mcp"}}}

Cursor

{"mcpServers":{"ucp-shopping":{"url":"https://api.facet.llc/ucp/mcp"}}}

VS Code

{"servers":{"ucp-shopping":{"type":"http","url":"https://api.facet.llc/ucp/mcp"}}}

Antigravity

agy mcp add ucp-shopping https://api.facet.llc/ucp/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"ucp-shopping","server_url":"https://api.facet.llc/ucp/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"ucp-shopping","server_url":"https://api.facet.llc/ucp/mcp"}

Tools

• cancel_cart ~84 tokens
  Cancel a cart. Idempotent, owner-scoped, and moves no money. REQUIRES IDENTITY plus an Idempotency-Key on a signature-required Terminal.
• cancel_checkout Moves money · ~115 tokens
  Cancel a checkout session before completion, releasing its inventory hold. Idempotent, owner-scoped, and moves no money (distinct from an escrow refund). REQUIRES IDENTITY plus an Idempotency-Key on a signature-required Terminal.
• complete_checkout Moves money · ~306 tokens
  Complete a checkout you created and place the order by submitting the buyer-signed payment credential. This is the MONEY-MOVING leg: funds capture on-chain to the merchant's pay_to (x402) or into escrow (Boson). The amount is re-derived server-side from the reservation, never your request, and the b
• create_cart ~196 tokens
  Create a pre-checkout cart from catalog line items. A cart is a mutable scratchpad: it moves no money and holds no inventory, so it carries estimated (server-derived) totals and NO payment_handlers. Assemble it, then create_checkout(cart_id) to convert. REQUIRES IDENTITY on a signature-required Term
• create_checkout Moves money · ~328 tokens
  Open a checkout session for one or more catalog line items (or promote a cart with `cart_id`). Returns the session plus server-resolved `payment_handlers` (rail, pay_to, exact amount) to satisfy: the price and pay_to are the MERCHANT's, sealed here, never read from your request. Physical goods REQUI
• discover_businesses ~364 tokens
  Find businesses in the Facet Universal Business Index that an agent can transact with. Returns `featured` (claimed merchants with a live `terminal_url` — point your catalog and checkout calls there) and `results` (the wider directory). Use this first when you do not already know which merchant to ta
• discover_products ~358 tokens
  Search products ACROSS every merchant in the Facet network that has opted into cross-merchant discovery. Returns matches each carrying the selling merchant's `terminal_url` (point your catalog and checkout calls there). Filter by free-text `query` (product name + description), exact `category`, and/
• get_cart ~94 tokens
  Read back one of YOUR carts by id: line items and estimated totals. Owner-scoped, so another agent's id returns not_found. REQUIRES IDENTITY on a signature-required Terminal.
• get_checkout ~106 tokens
  Read back one of YOUR checkout sessions by id: status, totals, line items, payment_handlers. Owner-scoped, so another agent's id returns not_found. REQUIRES IDENTITY on a signature-required Terminal.
• get_order ~135 tokens
  Read back one of YOUR orders on this merchant: status, amount, settlement state. Use the order_id returned when you paid. You can only read orders your own agent identity placed — another agent's order returns FORBIDDEN. REQUIRES IDENTITY: Facet KYA as `Authorization: Bearer <kya>`.
• get_payment_capabilities ~116 tokens
  Which settlement rails this merchant actually accepts (e.g. coin/boson-escrow for escrowed funds that release on fulfilment, coin/usdc-base for direct). Call before get_payment_requirements so you pass a rail_id this merchant registers, rather than guessing. No identity required — this is discovery
• get_payment_requirements ~495 tokens
  Turn a `quote_token` from get_quote into a seller-signed payment offer to authorize. Returns `requirements` (escrow address, asset, exact atomic amount, network) — sign it LOCALLY with your own wallet (e.g. @bosonprotocol/x402-client handle402 for `coin/boson-escrow`, producing an X-PAYMENT string).
• get_product ~72 tokens
  Get full product detail by product or variant identifier.
• get_quote ~548 tokens
  Get the real landed cost of a product from this merchant: goods + shipping + tax for a specific destination, plus a signed `quote_token` the payment path binds to. Call this before paying — the token is what makes the price the MERCHANT's, not one you name. Physical products REQUIRE a `fulfillment`
• list_orders ~125 tokens
  List YOUR order history on this merchant, newest first. Scoped to your own agent identity — you never see another agent's orders. REQUIRES IDENTITY: Facet KYA as `Authorization: Bearer <kya>`.
• lookup_catalog ~90 tokens
  Look up one or more products or variants by identifier (batch).
• post_delivery_refund Moves money · ~592 tokens
  Request a refund or return on a DELIVERED order you placed on this merchant. Opens a merchant-approved refund ticket (status `requested`); it moves NO money on its own. The merchant reviews and approves it, and only then does the send-back sign from the merchant's OWN wallet (non-custodial). Amount
• search_catalog ~115 tokens
  Search the merchant catalog for products matching a free-text query.
• update_cart ~162 tokens
  Replace a cart's line items (full replacement), re-priced server-side. Owner-scoped. REQUIRES IDENTITY on a signature-required Terminal.
• update_checkout Moves money · ~121 tokens
  Return a checkout's CURRENT sealed snapshot. Facet seals price and items at create, so this is a no-op that reports the session plus a note: to change line items, update the cart and start a new checkout with create_checkout(cart_id). Owner-scoped.
• wishlist_add ~148 tokens
  Save a product to YOUR wishlist on this merchant for later. Idempotent: saving the same product again updates its note and keeps the original save time. Scoped to your own agent identity. REQUIRES IDENTITY: Facet KYA as `Authorization: Bearer <kya>`.
• wishlist_list ~105 tokens
  List YOUR saved items (wishlist) on this merchant, newest first. Scoped to your own agent identity, so you never see another agent's list. REQUIRES IDENTITY: Facet KYA as `Authorization: Bearer <kya>`.
• wishlist_remove ~120 tokens
  Remove a product from YOUR wishlist on this merchant. Idempotent: removing something not on your list succeeds with removed:false. Scoped to your own agent identity. REQUIRES IDENTITY: Facet KYA as `Authorization: Bearer <kya>`.

Browse

• Website monitoring
• Payments
• Online shops
• Crypto and blockchains

Related MCP servers

• Stormap
  Brainstorm scored idea maps, check npm/PyPI packages and vendors, find the right paid API.
• xfix
  Check if AI assistants and shopping agents can read a website or online store
• Annalist
  Signed data for agents: agentic-commerce census, dependency digest, x402/MCP checks, Hyperliquid
• HirePulse Commerce Research
  11 tools for product data, store discovery and merchant evidence. Free sandbox and x402 payments.
• 7IT Solutions
  Store speed, web-app security checks, automation ROI, checklists and guides from 7IT Solutions.
• DiscountHub - Deals & Promo Codes
  Find real discounts, promo codes and online deals with DiscountHub MCP.
• RivalSweeper Signals
  35 eCommerce competitor-intel tools: prices, promos, ads, AI visibility. Plan-included or prepaid.
• Faceabot — tell it your need, get the tool that works
  solve_need: one call returns the best of 38,000+ MCP tools, with live measured reliability.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/llc.facet/ucp-shopping.svg)](https://aptlynx.net/servers/llc.facet/ucp-shopping)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents