{"id":"llc.facet/ucp-shopping","slug":"llc-facet-ucp-shopping","title":"Facet UCP Shopping","description":"The independent agent-commerce protocol for AI-agent checkout on any online store.","version":"1.0.0","publisher":{"kind":"domain","id":"facet.llc","label":"facet.llc","url":"https://facet.llc"},"website":"https://facet.llc","repository":"","remotes":[{"type":"streamable-http","url":"https://api.facet.llc/ucp/mcp","headers":[{"description":"Optional Facet KYA bearer, an ES256 JWT from the default issuer https://issuer.facet.llc (or another issuer advertised at /.well-known/agents.txt KYA-Issuers). Not required for tools/list or catalog discovery; required for gated tools/call, per the endpoint's agents.txt (MCP-Auth: kya-bearer).","isSecret":true,"name":"Authorization"}]}],"packages":[],"published":"2026-07-18","updated":"2026-07-18","status":"online","auth":"","latency_ms":1085,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"search_catalog","title":"","description":"Search the merchant catalog for products matching a free-text query.","read_only":false},{"name":"lookup_catalog","title":"","description":"Look up one or more products or variants by identifier (batch).","read_only":false},{"name":"get_product","title":"","description":"Get full product detail by product or variant identifier.","read_only":false},{"name":"discover_businesses","title":"","description":"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 talk to. REQUIRES IDENTITY: send a Facet KYA as `Authorization: Bearer <kya>` on the MCP request. A KY","read_only":false},{"name":"discover_products","title":"","description":"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/or `tags` (all must be present); at least one filter is required. Use this when you know WHAT you wa","read_only":false},{"name":"get_quote","title":"","description":"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` ship-to; without one you get FULFILLMENT_REQUIRED. An unserviceable destination returns UNDELIVERABL","read_only":false},{"name":"get_payment_capabilities","title":"","description":"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 data.","read_only":false},{"name":"get_payment_requirements","title":"","description":"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). Facet never holds your key and cannot sign for you, which is why paying is two steps and not one. T","read_only":false},{"name":"get_order","title":"","description":"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>`.","read_only":false},{"name":"list_orders","title":"","description":"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>`.","read_only":false},{"name":"post_delivery_refund","title":"","description":"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 and recipient are NOT inputs: the refund amount is derived and capped server-side, and the recipient","read_only":false},{"name":"wishlist_add","title":"","description":"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>`.","read_only":false},{"name":"wishlist_list","title":"","description":"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>`.","read_only":false},{"name":"wishlist_remove","title":"","description":"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>`.","read_only":false},{"name":"create_checkout","title":"","description":"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 REQUIRE a `fulfillment` ship-to (else FULFILLMENT_REQUIRED), sealed at create. REQUIRES IDENTITY on a sig","read_only":false},{"name":"complete_checkout","title":"","description":"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 buyer's signature is verified before any capture. A per-buyer refusal (FORBIDDEN, cap-exceeded, FULFI","read_only":false},{"name":"get_checkout","title":"","description":"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.","read_only":false},{"name":"update_checkout","title":"","description":"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.","read_only":false},{"name":"cancel_checkout","title":"","description":"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.","read_only":false},{"name":"create_cart","title":"","description":"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 Terminal.","read_only":false},{"name":"get_cart","title":"","description":"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.","read_only":false},{"name":"update_cart","title":"","description":"Replace a cart's line items (full replacement), re-priced server-side. Owner-scoped. REQUIRES IDENTITY on a signature-required Terminal.","read_only":false},{"name":"cancel_cart","title":"","description":"Cancel a cart. Idempotent, owner-scoped, and moves no money. REQUIRES IDENTITY plus an Idempotency-Key on a signature-required Terminal.","read_only":false}],"server_info":{"name":"facet-ucp-shopping","version":"2026-08-25"},"category":"ecommerce","tags":["agents","finance","web-search"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-07-18","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/llc-facet-ucp-shopping/"}