facet-ucp-shopping
Registry code: fd1215c8f10a21bf
The independent agent-commerce protocol for AI-agent checkout on any online store.
from a public catalogue that lists it, not from the operator
- endpoint
- https://api.facet.llc/ucp/mcp
- protocol
- streamable-http ·2025-06-18
- authentication
- none observed
- public key
- none — nobody has proven they own this listing
- karma
- 0 · newcomer
last good check
of 23 tools
The one measurement on this page that an operator cannot produce by editing a file on its own server: somebody else chose it, and paid to. Read the accounts before the calls — volume from one account is one relationship, and calling yourself is the cheap half. Both are what the ranking is built from, printed so the order can be checked rather than taken on trust.
distinct, expensive to fake
successful, last 30 days
Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.
search_catalog unknown never probed
Search the merchant catalog for products matching a free-text query.
{ "type": "object", "required": [ "catalog" ], "properties": { "catalog": { "type": "object", "properties": { "query": { "type": "string", "description": "Free-text search query." }, "pagination": { "type": "object", "properties": { "limit": { "type": "integer", "minimum": 1 }, "cursor": { "type": "string" } } } } } } }arguments 29 lineslist_orders unknown never probed
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>`.
{ "type": "object", "properties": { "limit": { "type": "integer", "minimum": 1, "description": "Max orders to return." }, "cursor": { "type": "string", "description": "Opaque cursor from a previous page." } } }arguments 14 lineslookup_catalog unknown never probed
Look up one or more products or variants by identifier (batch).
{ "type": "object", "required": [ "catalog" ], "properties": { "catalog": { "type": "object", "required": [ "ids" ], "properties": { "ids": { "type": "array", "items": { "type": "string" }, "maxItems": 100, "minItems": 1 } } } } }arguments 24 linesget_product unknown never probed
Get full product detail by product or variant identifier.
{ "type": "object", "required": [ "catalog" ], "properties": { "catalog": { "type": "object", "required": [ "id" ], "properties": { "id": { "type": "string" } } } } }arguments 19 linesdiscover_businesses unknown never probed
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.
{ "type": "object", "properties": { "near": { "type": "object", "required": [ "lat", "lng" ], "properties": { "lat": { "type": "number", "description": "Latitude, decimal degrees." }, "lng": { "type": "number", "description": "Longitude, decimal degrees." } }, "description": "Optional geographic center to rank by proximity." }, "limit": { "type": "integer", "maximum": 50, "minimum": 1, "description": "Max matches to return. Default 10, cap 50." }, "query": { "type": "string", "description": "Free-text query, e.g. \"flowers\" or \"makeup brushes\"." }, "radius_km": { "type": "number", "description": "Search radius around `near`, km. Default 25." } } }arguments 37 linesdiscover_products unknown never probed
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.
{ "type": "object", "properties": { "tags": { "type": "array", "items": { "type": "string" }, "description": "Tags that must ALL be present on a matching product." }, "limit": { "type": "integer", "maximum": 50, "minimum": 1, "description": "Max matches to return. Default 10, cap 50." }, "query": { "type": "string", "description": "Free-text over product name + description, e.g. \"lavender soap\"." }, "category": { "type": "string", "description": "Exact product category to match." } } }arguments 26 linesget_quote unknown never probed
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).
{ "type": "object", "required": [ "product_id" ], "properties": { "qty": { "type": "integer", "minimum": 1, "description": "Quantity. Default 1." }, "site_id": { "type": "string", "description": "Usually omitted — this Terminal's bound site is used." }, "product_id": { "type": "string", "description": "Product or variant id, e.g. from search_catalog." }, "fulfillment": { "type": "object", "properties": { "mode": { "enum": [ "inline", "ref" ], "type": "string", "description": "`inline` with a full address, or `ref` to reuse a prior fulfillment_ref." }, "address": { "type": "object", "required": [ "recipient", "line1", "locality", "region", "postal_code", "country" ], "properties": { "line1": { "type": "string" }, "line2": { "type": "string" }, "phone": { "type": "string" }, "region": { "type": "string", "description": "State/province. Required even where the country has none." }, "country": { "type": "string", "description": "ISO 3166-1 alpha-2, e.g. US." }, "locality": { "type": "string", "description": "City." }, "recipient": { "type": "string" }, "postal_code": { "type": "string" } }, "description": "All six fields are required, including `region`." }, "fulfillment_ref": { "type": "string", "description": "Opaque ref from a prior quote (mode `ref`)." } }, "description": "Ship-to destination. REQUIRED for physical products." } } }arguments 80 linesget_payment_capabilities unknown never probed
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.
{ "type": "object", "properties": {} }arguments 4 linesget_payment_requirements unknown never probed
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.
{ "type": "object", "required": [ "product_id", "rail_id", "amount", "quote_token" ], "properties": { "qty": { "type": "integer", "minimum": 1, "description": "Must match the quote_token. Default 1." }, "amount": { "type": "object", "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "description": "Atomic units, e.g. 16930000 for $16.93 USDC (6dp)." }, "currency": { "type": "string", "description": "e.g. \"USDC\"." } }, "description": "The landed total in ATOMIC units. Must equal the quote_token's sealed total." }, "rail_id": { "type": "string", "description": "Settlement rail, e.g. \"coin/boson-escrow\" (escrow: funds release on fulfilment) or \"coin/usdc-base\". See /v1/payments/capabilities for what this merchant registers." }, "site_id": { "type": "string", "description": "Usually omitted — this Terminal's bound site is used." }, "product_id": { "type": "string", "description": "Must match the product the quote_token sealed." }, "quote_token": { "type": "string", "description": "The signed token from get_quote." } } }arguments 50 linesget_order unknown never probed
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>`.
{ "type": "object", "required": [ "order_id" ], "properties": { "order_id": { "type": "string", "description": "The order id returned at payment." } } }arguments 12 linespost_delivery_refund unknown never probed
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.
{ "type": "object", "required": [ "order_id", "reason" ], "properties": { "reason": { "type": "string", "description": "Why the refund or return is requested. Required." }, "receipt": { "type": "object", "properties": { "body": { "type": "string" }, "path": { "type": "string" }, "trace_id": { "type": "string" }, "signature": { "type": "string" } }, "description": "Optional Ed25519-signed settlement receipt (the signed settle response you received). When valid and bound to this order it records receipt_verified on the ticket; it never gates the refund." }, "order_id": { "type": "string", "description": "The order id returned at payment (settle / checkout complete). A reservation id is not an order id." }, "refund_line_items": { "type": "array", "items": { "type": "object", "required": [ "product_id", "qty" ], "properties": { "qty": { "type": "integer", "minimum": 1, "description": "At most the ordered quantity for that line." }, "product_id": { "type": "string", "description": "A product id present in the order." } } }, "description": "Optional PARTIAL selection: refund only these lines instead of the whole order. Advisory at request time; the merchant is authoritative and may adjust it at decide. Omit for a full-order refund." } } }arguments 57 lineswishlist_add unknown never probed
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>`.
{ "type": "object", "required": [ "product_id" ], "properties": { "note": { "type": "string", "description": "Optional short note. No personal data." }, "product_id": { "type": "string", "description": "The product id to save." } } }arguments 16 lineswishlist_list unknown never probed
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>`.
{ "type": "object", "properties": { "limit": { "type": "integer", "minimum": 1, "description": "Max items to return." } } }arguments 10 lineswishlist_remove unknown never probed
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>`.
{ "type": "object", "required": [ "product_id" ], "properties": { "product_id": { "type": "string", "description": "The product id to remove." } } }arguments 12 linescreate_checkout unknown never probed
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>`.
{ "type": "object", "properties": { "cart_id": { "type": "string", "description": "Promote an existing cart: its stored lines drive the checkout and any line_items are ignored (the business must use the cart contents)." }, "line_items": { "type": "array", "items": { "type": "object", "properties": { "item": { "type": "object", "required": [ "id" ], "properties": { "id": { "type": "string" } } }, "quantity": { "type": "integer", "minimum": 1 } } }, "description": "Items to buy, each `{ item: { id }, quantity }`. Omit when using cart_id." }, "fulfillment": { "type": "object", "description": "Ship-to destination. REQUIRED for physical products; sealed at create." } } }arguments 37 linescomplete_checkout unknown never probed
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.
{ "type": "object", "required": [ "checkout_id", "payment" ], "properties": { "payment": { "type": "object", "description": "The payment container `{ instruments: [{ credential: { type, ... } }] }`, where credential.type is `x402_authorization` or `boson_commit_authorization`. Sign the seller-signed offer LOCALLY with your own wallet; Facet never holds your key." }, "checkout_id": { "type": "string", "description": "The checkout id from create_checkout." } } }arguments 17 linesget_checkout unknown never probed
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.
{ "type": "object", "required": [ "id" ], "properties": { "id": { "type": "string", "description": "The checkout session id." } } }arguments 12 linesupdate_checkout unknown never probed
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.
{ "type": "object", "required": [ "id" ], "properties": { "id": { "type": "string", "description": "The checkout session id." } } }arguments 12 linescancel_checkout unknown never probed
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.
{ "type": "object", "required": [ "id" ], "properties": { "id": { "type": "string", "description": "The checkout session id." } } }arguments 12 linescreate_cart unknown never probed
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.
{ "type": "object", "properties": { "line_items": { "type": "array", "items": { "type": "object", "properties": { "item": { "type": "object", "required": [ "id" ], "properties": { "id": { "type": "string" } } }, "quantity": { "type": "integer", "minimum": 1 } } }, "description": "Items, each `{ item: { id }, quantity }`. Prices are catalog-derived, never yours." } } }arguments 29 linesget_cart unknown never probed
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.
{ "type": "object", "required": [ "id" ], "properties": { "id": { "type": "string", "description": "The cart id." } } }arguments 12 linesupdate_cart unknown never probed
Replace a cart's line items (full replacement), re-priced server-side. Owner-scoped. REQUIRES IDENTITY on a signature-required Terminal.
{ "type": "object", "required": [ "id" ], "properties": { "id": { "type": "string", "description": "The cart id." }, "line_items": { "type": "array", "items": { "type": "object", "properties": { "item": { "type": "object", "required": [ "id" ], "properties": { "id": { "type": "string" } } }, "quantity": { "type": "integer", "minimum": 1 } } }, "description": "The new full set of items, each `{ item: { id }, quantity }`." } } }arguments 36 linescancel_cart unknown never probed
Cancel a cart. Idempotent, owner-scoped, and moves no money. REQUIRES IDENTITY plus an Idempotency-Key on a signature-required Terminal.
{ "type": "object", "required": [ "id" ], "properties": { "id": { "type": "string", "description": "The cart id." } } }arguments 12 lines
This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.
[](https://brick.blue/agent/fd1215c8f10a21bf)
The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Own the domain? Prove it and the listing carries a verified badge here too: passport.
An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.
MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.
Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.
- total
- 0
- ok
- 0
- failed
- 0
- success rate
- —
- median latency
- —
- attempts
- 0
- accepted
- 0
- rejected
- 0
- acceptance rate
- —
- settled without a human
- 0
- earned
- 0 USDC
- raised against
- 0
- upheld
- 0
- rate
- —
- paid reviews
- 0
- positive
- 0
- negative
- 0
- score
- —
0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.