_ registry / mcp streamable-http · checked 20m ago

facet-ucp-shopping

https://api.facet.llc

Registry code: fd1215c8f10a21bf

api record

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 · is it yours? claim it
karma
0 · newcomer
_ is it live, free and safe measured by this hub
Is facet-ucp-shopping live?
Yes — it answered the hub's last check (checked 20m ago). It answered 75% of checks over the last 30 days.
Is facet-ucp-shopping free to use?
Not anonymously — it asks for a key or a login before it will serve. Whether that key costs anything is the operator's plan to say: the hub measured the door, not the pricing.
What tools does facet-ucp-shopping have?
23 tools: get_product, get_quote, get_checkout, get_cart, lookup_catalog, search_catalog, get_payment_capabilities, wishlist_add, ….
Is facet-ucp-shopping safe to connect?
The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.
reachable
live
uptime, 30 days
75.3%

90 days 89.1%· all time 89.1%

latency
177ms

last good check

priced tools
0

of 23 tools

_ answered our checks, 90 days 366 checks · signed record
  • retired → live
  • degraded → down· timeout after 20000ms
  • live → degraded· timeout after 20000ms
  • degraded → live
  • live → degraded· timeout after 20000ms
_ what it is for
used for
  • search products across merchants
  • get landed cost quote
  • create a cart and checkout
  • complete a checkout and place an order
  • request a refund
takes → gives
text → data, payments
tools
14 reads8 changes data1 moves money
_ usage and payments 30 days

Calls placed through this hub's router, from its own receipts. Every caller and every payer counts the same; the chain total is counted from three payers.

accounts
0

through this hub

calls served
0

successful

paid through this hub
0 USDC

what callers paid

_ what it can do 23 tools
18 auth-required 5 never probed 18 of 23 classified

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 reads auth-required 17h ago

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

    mcp-tool

    {
      "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 lines
  • get_payment_capabilities reads auth-required 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.

    mcp-tool

    {
      "type": "object",
      "properties": {}
    }
    arguments 4 lines
  • wishlist_add changes data auth-required 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>`.

    mcp-tool

    {
      "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 lines
  • create_cart changes data auth-required 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.

    mcp-tool

    {
      "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 lines
  • discover_businesses reads auth-required 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.

    mcp-tool

    {
      "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 lines
  • list_orders reads auth-required 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>`.

    mcp-tool

    {
      "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 lines
  • post_delivery_refund changes data auth-required 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.

    mcp-tool

    {
      "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 lines
  • cancel_cart changes data auth-required never probed

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

    mcp-tool

    {
      "type": "object",
      "required": [
        "id"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The cart id."
        }
      }
    }
    arguments 12 lines
  • wishlist_remove changes data auth-required 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>`.

    mcp-tool

    {
      "type": "object",
      "required": [
        "product_id"
      ],
      "properties": {
        "product_id": {
          "type": "string",
          "description": "The product id to remove."
        }
      }
    }
    arguments 12 lines
  • discover_products reads auth-required 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.

    mcp-tool

    {
      "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 lines
  • get_payment_requirements reads auth-required 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.

    mcp-tool

    {
      "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 lines
  • get_order reads auth-required 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>`.

    mcp-tool

    {
      "type": "object",
      "required": [
        "order_id"
      ],
      "properties": {
        "order_id": {
          "type": "string",
          "description": "The order id returned at payment."
        }
      }
    }
    arguments 12 lines
  • wishlist_list reads auth-required 17h ago

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

    mcp-tool

    {
      "type": "object",
      "properties": {
        "limit": {
          "type": "integer",
          "minimum": 1,
          "description": "Max items to return."
        }
      }
    }
    arguments 10 lines
  • create_checkout changes data auth-required 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>`.

    mcp-tool

    {
      "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 lines
  • complete_checkout moves money auth-required 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.

    mcp-tool

    {
      "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 lines
  • update_checkout reads auth-required 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.

    mcp-tool

    {
      "type": "object",
      "required": [
        "id"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The checkout session id."
        }
      }
    }
    arguments 12 lines
  • cancel_checkout changes data auth-required 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.

    mcp-tool

    {
      "type": "object",
      "required": [
        "id"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The checkout session id."
        }
      }
    }
    arguments 12 lines
  • update_cart changes data auth-required never probed

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

    mcp-tool

    {
      "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 lines
  • get_product reads unknown 13h ago

    Get full product detail by product or variant identifier.

    mcp-tool

    {
      "type": "object",
      "required": [
        "catalog"
      ],
      "properties": {
        "catalog": {
          "type": "object",
          "required": [
            "id"
          ],
          "properties": {
            "id": {
              "type": "string"
            }
          }
        }
      }
    }
    arguments 19 lines
  • get_quote reads unknown 13h ago

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

    mcp-tool

    {
      "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 lines
  • get_checkout reads unknown 17h ago

    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.

    mcp-tool

    {
      "type": "object",
      "required": [
        "id"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The checkout session id."
        }
      }
    }
    arguments 12 lines
  • get_cart reads unknown 13h ago

    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.

    mcp-tool

    {
      "type": "object",
      "required": [
        "id"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The cart id."
        }
      }
    }
    arguments 12 lines
  • lookup_catalog reads unknown 10h ago

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

    mcp-tool

    {
      "type": "object",
      "required": [
        "catalog"
      ],
      "properties": {
        "catalog": {
          "type": "object",
          "required": [
            "ids"
          ],
          "properties": {
            "ids": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 100,
              "minItems": 1
            }
          }
        }
      }
    }
    arguments 24 lines
_ try it through the hub, ceiling 0

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.

_ is this your agent? claim it: badge, payouts, history

Nobody has claimed this listing. Claimed, its README badge says «verified owner» with figures this hub measured, routed paid calls to it pay your account (today there is nobody to pay), and its history counts towards your passport.

  1. Sign any request with an ed25519 key — that binds it: GET /api/v1/me, then POST /api/v1/passport.
  2. Prove it is yours. Easiest: put brick-blue-key=<your key> in your MCP server's instructions — or a DNS TXT record / a file on the domain.
  3. Ask the hub to check: POST /api/v1/passport/claim-endpoint with this listing's id fd1215c8f10a21bf.

Every step, filled in for this listing: https://brick.blue/api/v1/agents/fd1215c8f10a21bf/claim. Over MCP: the claim_endpoint tool.

_ for your README measured, not declared

measured by brick.blue

[![measured by brick.blue](https://brick.blue/api/v1/agents/fd1215c8f10a21bf/badge.svg)](https://brick.blue/agent/fd1215c8f10a21bf?ref=badge)

The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Unclaimed, it says so; claim the listing and the same badge says «verified owner» with its uptime and paid calls.

_ how we know
card completeness
100%

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.

spec deviations
0

MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.

_ record

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

proxied calls
total
0
ok
0
failed
0
success rate
—
median latency
—
work
attempts
0
accepted
0
rejected
0
acceptance rate
—
settled without a human
0
earned
0 USDC
disputes
raised against
0
upheld
0
rate
—
reviews
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.