The independent agent-commerce protocol for AI-agent checkout on any online store.
Abgeleitet aus den Transporten, die dieser Eintrag deklariert (streamable-http). Ein Client, der hier nicht steht, ist damit nicht ausgeschlossen — Forge kann ihn nur nicht bestätigen.
Die Verifizierung bestätigt die Identität des Publishers (die Inhaberschaft am Repo), nicht die Sicherheit des Codes. Der Sicherheits-Scan deckt bekannte CVEs und verdächtige Installationsskripte ab.
Aus einem echten MCP-Handshake initialize → tools/list gegen den deklarierten Endpunkt gelesen. Es wurde nie ein Tool aufgerufen — tools/list ist der lesende Introspektionsaufruf, den das Protokoll dafür vorsieht. Es spiegelt wider, was der Server in diesem Moment angeboten hat; ein gehosteter Endpunkt ist an keine Version gebunden und kann sich ohne Ankündigung ändern.
https://api.facet.llc/ucp/mcp23 Tools · 334 mssearch_catalogSearch the merchant catalog for products matching a free-text query.Search the merchant catalog for products matching a free-text query.
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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 | Typ | Beschreibung |
|---|---|---|
| catalog* | object | — |
get_productGet full product detail by product or variant identifier.Get full product detail by product or variant identifier.
| Parameter | Typ | Beschreibung |
|---|---|---|
| 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 | Typ | Beschreibung |
|---|---|---|
| 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 | Typ | Beschreibung |
|---|---|---|
| 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 | Typ | Beschreibung |
|---|---|---|
| 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…
Für dieses Tool wurde kein Eingabeschema veröffentlicht.
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 | Typ | Beschreibung |
|---|---|---|
| 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 | Typ | Beschreibung |
|---|---|---|
| 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 | Typ | Beschreibung |
|---|---|---|
| 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 | Typ | Beschreibung |
|---|---|---|
| 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 | Typ | Beschreibung |
|---|---|---|
| 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 | Typ | Beschreibung |
|---|---|---|
| limit | integer | Max items to return. |
wishlist_removeprivilegiertRemove 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 | Typ | Beschreibung |
|---|---|---|
| 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 | Typ | Beschreibung |
|---|---|---|
| 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 | Typ | Beschreibung |
|---|---|---|
| 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 | Typ | Beschreibung |
|---|---|---|
| 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 | Typ | Beschreibung |
|---|---|---|
| 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 | Typ | Beschreibung |
|---|---|---|
| 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 | Typ | Beschreibung |
|---|---|---|
| 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 | Typ | Beschreibung |
|---|---|---|
| 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 | Typ | Beschreibung |
|---|---|---|
| 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 | Typ | Beschreibung |
|---|---|---|
| id* | string | The cart id. |
23 von 23 Tools haben eine Beschreibung veröffentlicht.
Tool-Namen und -Beschreibungen stammen vom Publisher und werden wortgetreu als inerter Text angezeigt. Es sind die Zeichenketten, die ein MCP-Client an ein Modell übergibt, deshalb prüft Forge sie auf Prompt-Injection-Muster — jeder Befund erscheint oben beim Sicherheits-Scan. „Privilegiert“ ist ein Schlagwort-Treffer im Tool-Namen, keine Prüfung dessen, was das Tool tut: ein harmlos klingender Name kann trotzdem alles tun.
The independent agent-commerce protocol for AI-agent checkout on any online store.
Verlinkte Namen öffnen den Forge-Index aller Einträge, bei denen dieses Tool beobachtet wurde. Alle indexierten Tools durchsuchen.
Dieser Eintrag veröffentlicht kein npm-Paket, daher hat Forge keinen Abhängigkeitsbaum dafür. Das ist eine Lücke in der Abdeckung — keine Aussage, dass er keine Abhängigkeiten hat.