Facet UCP Shopping

llc.facetPublished by facet.llcOfficial publisherv1.0.0Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

Facet UCP Shopping lets an AI assistant search merchant catalogs, get quotes, build carts and complete agent-paid checkouts on Facet-enabled online stores.

What you can do
Search and browse products: free-text catalog search, batch lookup by identifier, full product detail, and cross-merchant product discovery with business discovery in the Facet Universal Business Index. Price a purchase: get landed cost (goods, shipping, tax) for a destination with a signed quote token. Check payment options: list the merchant's settlement rails and turn a quote into a seller-signed payment offer. Manage carts and checkouts: create, read, update and cancel carts and checkout sessions, then complete a checkout with a buyer-signed payment credential. Track orders and returns: read one order or list your order history, and open a refund or return ticket on a delivered order. Ke
When to use it
Use it when an assistant needs to shop on Facet-enabled merchants: find products across stores, compare landed costs, assemble a cart, and pay through an agent wallet or escrow rail. It is aimed at agent-driven checkout rather than manual browsing.
Requirements
Remote streamable HTTP endpoint at api.facet.llc; nothing to install locally. Catalog and discovery tools work without identity. Order, wishlist, cart and checkout tools require a Facet KYA bearer token in the Authorization header, an ES256 JWT from the default issuer or another advertised issuer. Payment steps need a local wallet client to sign the payment offer.
Before you install
complete_checkout moves real money on-chain to the merchant or into escrow, so confirm amounts and destination before calling it. The Authorization bearer token is a credential and should be kept private. Orders, carts and wishlists are scoped to the agent identity, and refunds only open a merchant-approved ticket that moves no money by itself. Quotes and payment handlers are sealed server-side; changing items means a new checkout.

Installation

In SourceWeft

  1. Open Facet UCP Shopping in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/llc.facet%2Fucp-shopping/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

Tools

23

search_catalog

Search the merchant catalog for products matching a free-text query.

Parameterscatalogrequired

lookup_catalog

Look up one or more products or variants by identifier (batch).

Parameterscatalogrequired

get_product

Get full product detail by product or variant identifier.

Parameterscatalogrequired

discover_businesses

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 KYA is an ES256 JWT from Facet's default issuer https://issuer.facet.llc (or another issuer this Terminal trusts — see KYA-Issuers in its /.well-known/agents.txt). Calling without one returns 401 with a signup link.

Parametersnearlimitqueryradius_km

discover_products

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 want but not WHICH merchant sells it. REQUIRES IDENTITY: send a Facet KYA as `Authorization: Bearer <kya>` on the MCP request. A KYA is an ES256 JWT from Facet's default issuer https://issuer.facet.llc (or another issuer this Terminal trusts; see KYA-Issuers in its /.well-known/agents.txt). Calling without one returns 401 with a signup link.

Parameterstagslimitquerycategory

get_quote

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 UNDELIVERABLE (the merchant's own shipping zones, which Facet cannot waive). REQUIRES IDENTITY: send a Facet KYA as `Authorization: Bearer <kya>` (ES256 JWT from https://issuer.facet.llc, or another issuer in this Terminal's agents.txt KYA-Issuers).

Parametersqtysite_idproduct_idrequiredfulfillment

get_payment_capabilities

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.

Takes no parameters.

get_payment_requirements

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. The offer binds to the quote_token's sealed landed total and ship-to, so the amount is the merchant's, not one you name. REQUIRES IDENTITY: same Facet KYA as get_quote, and the SAME `aid` — the offer path rejects a quote_token issued to a different agent than the caller.

Parametersqtyamountrequiredrail_idrequiredsite_idproduct_idrequiredquote_tokenrequired

get_order

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>`.

Parametersorder_idrequired

list_orders

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>`.

Parameterslimitcursor

post_delivery_refund

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 is the order's stamped payer, never one you name. Pass `refund_line_items` to refund only part of the order; omit for the whole order. Owner-scoped: another agent's order returns FORBIDDEN. REQUIRES IDENTITY: a Facet KYA as `Authorization: Bearer <kya>` (an ES256 JWT from https://issuer.facet.llc, or another issuer in this Terminal's agents.txt KYA-Issuers). A wallet-bound KYA also authorizes a platform-originated order by its stamped payer.

Parametersreasonrequiredreceiptorder_idrequiredrefund_line_items

wishlist_add

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>`.

Parametersnoteproduct_idrequired

wishlist_list

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>`.

Parameterslimit

wishlist_remove

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>`.

Parametersproduct_idrequired

create_checkout

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 signature-required Terminal: a Facet KYA as `Authorization: Bearer <kya>`.

Parameterscart_idline_itemsfulfillment

complete_checkout

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, FULFILLMENT_REQUIRED) returns as an error result; a missing or invalid identity is a real 401. REQUIRES IDENTITY plus a signed Idempotency-Key on a signature-required Terminal.

Parameterspaymentrequiredcheckout_idrequired

get_checkout

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.

Parametersidrequired

update_checkout

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.

Parametersidrequired

cancel_checkout

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.

Parametersidrequired

create_cart

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.

Parametersline_items

get_cart

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.

Parametersidrequired

update_cart

Replace a cart's line items (full replacement), re-priced server-side. Owner-scoped. REQUIRES IDENTITY on a signature-required Terminal.

Parametersidrequiredline_items

cancel_cart

Cancel a cart. Idempotent, owner-scoped, and moves no money. REQUIRES IDENTITY plus an Idempotency-Key on a signature-required Terminal.

Parametersidrequired

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

72% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts

    Publish an icon in the registry entry.

  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.

Other Facet integrations

Facet

Published by GitHub account halfspacelabs

Facet builds, evaluates and serves a small model for one narrow task from a plain-language request, with repo-aware plugin skills.

Streamable HTTPWeb executableAuth
Developer ToolsCredential requiredNov 7, 2026

Facet

Published by GitHub account chndr-prksh

Facet checks a web page for responsive design problems and screenshots it across emulated phone, tablet and desktop devices.

STDIODesktop only
Browser AutomationNot validated yetOct 24, 2026