mcpbeat

Facet UCP Shopping MCP Server

llc.facet/ucp-shopping
answering

Facet UCP Shopping is answering right now. Last checked 3 min ago. It exposes 9 tools.

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

Uptime history 40 hours of history
40 hours agonow
100.0%
Uptime 24h
92 of 92 checks
9
Tools
read from the server
424 ms
Response time
average over 24h
open, no key
Access
streamable-http

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 3 min ago.

run in your terminal
claude mcp add ucp-shopping --transport http https://api.facet.llc/ucp/mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "ucp-shopping": {
      "url": "https://api.facet.llc/ucp/mcp"
    }
  }
}
~/.codex/config.toml
[mcp_servers.ucp-shopping]
url = "https://api.facet.llc/ucp/mcp"
.cursor/mcp.json
{
  "mcpServers": {
    "ucp-shopping": {
      "url": "https://api.facet.llc/ucp/mcp"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "ucp-shopping": {
      "url": "https://api.facet.llc/ucp/mcp"
    }
  }
}

Available tools 9

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

payment
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.
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.
catalog
search_catalog
Search the merchant catalog for products matching a free-text query.
discover
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.
lookup
lookup_catalog
Look up one or more products or variants by identifier (batch).
order
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>`.
orders
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>`.
product
get_product
Get full product detail by product or variant identifier.
quote
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).

Endpoints

URLTransportStateLatencyChecked
https://api.facet.llc/ucp/mcp streamable-http answering 550 ms 3 min ago

Facet UCP Shopping — questions

Answers built from our own checks of this server.

What can Facet UCP Shopping do?
It exposes 9 tools, read directly from the server on our last check. Among them: discover_businesses, get_order, get_payment_capabilities, get_payment_requirements, get_product, get_quote and 3 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →
Is Facet UCP Shopping working right now?
We send a real MCP handshake every 15 minutes. Over the last 24 hours 92 of 92 checks got a reply (100.0%), average response time 424 ms. The bar chart above shows every period we have measured.
How do I connect Facet UCP Shopping?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.
Does Facet UCP Shopping need an API key?
No. Facet UCP Shopping completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 9 of them are readable on this page. This is what we observed, not what the docs claim.
How fast is Facet UCP Shopping?
It answers our handshake in 424 ms on average, which is faster than 30% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.