The independent agent-commerce protocol for AI-agent checkout on any online store.
Inferred from the transports this listing declares (streamable-http). A client not listed here hasn’t been ruled out — it just isn’t something Forge can confirm.
Verification confirms publisher identity (repo ownership), not code safety. The security scan covers known CVEs and suspicious install scripts.
Read from a real MCP initialize → tools/list handshake against the declared endpoint. No tool was ever invoked — tools/list is the read-only introspection call the protocol defines for this. It reflects what the server advertised at that moment; a hosted endpoint is not pinned to any version and can change without notice.
https://api.facet.llc/ucp/mcp23 tools · 334mssearch_catalogSearch the merchant catalog for products matching a free-text query.Search the merchant catalog for products matching a free-text query.
| Parameter | Type | Description |
|---|---|---|
| catalog* | object | — |
lookup_catalogLook up one or more products or variants by identifier (batch).Look up one or more products or variants by identifier (batch).
| Parameter | Type | Description |
|---|---|---|
| catalog* | object | — |
get_productGet full product detail by product or variant identifier.Get full product detail by product or variant identifier.
| Parameter | Type | Description |
|---|---|---|
| catalog* | object | — |
discover_businessesFind 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 t…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 t…
| Parameter | Type | Description |
|---|---|---|
| query | string | Free-text query, e.g. "flowers" or "makeup brushes". |
| near | object | Optional geographic center to rank by proximity. |
| radius_km | number | Search radius around `near`, km. Default 25. |
| limit | integer | Max matches to return. Default 10, cap 50. |
discover_productsSearch 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…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…
| Parameter | Type | Description |
|---|---|---|
| query | string | Free-text over product name + description, e.g. "lavender soap". |
| category | string | Exact product category to match. |
| tags | array | Tags that must ALL be present on a matching product. |
| limit | integer | Max matches to return. Default 10, cap 50. |
get_quoteGet 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`…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`…
| Parameter | Type | Description |
|---|---|---|
| product_id* | string | Product or variant id, e.g. from search_catalog. |
| qty | integer | Quantity. Default 1. |
| site_id | string | Usually omitted — this Terminal's bound site is used. |
| fulfillment | object | Ship-to destination. REQUIRED for physical products. |
get_payment_capabilitiesWhich 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…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…
No input schema was published for this tool.
get_payment_requirementsTurn 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)…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)…
| Parameter | Type | Description |
|---|---|---|
| product_id* | string | Must match the product the quote_token sealed. |
| qty | integer | Must match the quote_token. Default 1. |
| rail_id* | string | Settlement rail, e.g. "coin/boson-escrow" (escrow: funds release on fulfilment) or "coin/usdc-base". See /v1/payments/capabilities for what this merchant regis… |
| amount* | object | The landed total in ATOMIC units. Must equal the quote_token's sealed total. |
| quote_token* | string | The signed token from get_quote. |
| site_id | string | Usually omitted — this Terminal's bound site is used. |
get_orderRead 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 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>`.
| Parameter | Type | Description |
|---|---|---|
| order_id* | string | The order id returned at payment. |
list_ordersList 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>`.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>`.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max orders to return. |
| cursor | string | Opaque cursor from a previous page. |
post_delivery_refundRequest 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…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…
| Parameter | Type | Description |
|---|---|---|
| order_id* | string | The order id returned at payment (settle / checkout complete). A reservation id is not an order id. |
| reason* | string | Why the refund or return is requested. Required. |
| refund_line_items | array | 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 de… |
| receipt | object | Optional Ed25519-signed settlement receipt (the signed settle response you received). When valid and bound to this order it records receipt_verified on the tic… |
wishlist_addSave 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>`.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>`.
| Parameter | Type | Description |
|---|---|---|
| product_id* | string | The product id to save. |
| note | string | Optional short note. No personal data. |
wishlist_listList 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>`.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>`.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max items to return. |
wishlist_removeprivilegedRemove 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>`.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>`.
| Parameter | Type | Description |
|---|---|---|
| product_id* | string | The product id to remove. |
create_checkoutOpen 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 REQU…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 REQU…
| Parameter | Type | Description |
|---|---|---|
| line_items | array | Items to buy, each `{ item: { id }, quantity }`. Omit when using cart_id. |
| cart_id | string | Promote an existing cart: its stored lines drive the checkout and any line_items are ignored (the business must use the cart contents). |
| fulfillment | object | Ship-to destination. REQUIRED for physical products; sealed at create. |
complete_checkoutComplete 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…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…
| Parameter | Type | Description |
|---|---|---|
| checkout_id* | string | The checkout id from create_checkout. |
| payment* | object | The payment container `{ instruments: [{ credential: { type, ... } }] }`, where credential.type is `x402_authorization` or `boson_commit_authorization`. Sign t… |
get_checkoutRead 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 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.
| Parameter | Type | Description |
|---|---|---|
| id* | string | The checkout session id. |
update_checkoutReturn 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.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.
| Parameter | Type | Description |
|---|---|---|
| id* | string | The checkout session id. |
cancel_checkoutCancel 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.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.
| Parameter | Type | Description |
|---|---|---|
| id* | string | The checkout session id. |
create_cartCreate 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 Ter…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 Ter…
| Parameter | Type | Description |
|---|---|---|
| line_items | array | Items, each `{ item: { id }, quantity }`. Prices are catalog-derived, never yours. |
get_cartRead 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 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.
| Parameter | Type | Description |
|---|---|---|
| id* | string | The cart id. |
update_cartReplace a cart's line items (full replacement), re-priced server-side. Owner-scoped. REQUIRES IDENTITY on a signature-required Terminal.Replace a cart's line items (full replacement), re-priced server-side. Owner-scoped. REQUIRES IDENTITY on a signature-required Terminal.
| Parameter | Type | Description |
|---|---|---|
| id* | string | The cart id. |
| line_items | array | The new full set of items, each `{ item: { id }, quantity }`. |
cancel_cartCancel a cart. Idempotent, owner-scoped, and moves no money. REQUIRES IDENTITY plus an Idempotency-Key on a signature-required Terminal.Cancel a cart. Idempotent, owner-scoped, and moves no money. REQUIRES IDENTITY plus an Idempotency-Key on a signature-required Terminal.
| Parameter | Type | Description |
|---|---|---|
| id* | string | The cart id. |
23 of 23 tools published a description.
Tool names and descriptions are written by the publisher and shown verbatim as inert text. They are the strings an MCP client passes to a model, so Forge scans them for prompt-injection patterns — any finding appears with the security scan above. “Privileged” is a keyword match on the tool name, not an audit of what the tool does: a benign-sounding name can still do anything.
The independent agent-commerce protocol for AI-agent checkout on any online store.
Linked names open Forge’s index of every entry observed exposing that tool. Browse all indexed tools.
This entry publishes no npm package, so Forge has no dependency tree for it. That is a gap in coverage — not a statement that it has no dependencies.