generated: '2026-08-02'
method: probed
source: https://www.brooklinen.com/.well-known/ucp
status: published
server:
  name: brooklinen-ucp-shopping
  transport: http
  protocol: mcp
  url: https://www.brooklinen.com/api/ucp/mcp
  canonical_url: https://brooklinen2.myshopify.com/api/ucp/mcp
  advertised_by:
  - https://www.brooklinen.com/robots.txt
  - https://www.brooklinen.com/agents.md
  - https://www.brooklinen.com/llms.txt
  - https://www.brooklinen.com/.well-known/ucp
protocol:
  name: Universal Commerce Protocol (UCP)
  spec: https://ucp.dev/2026-04-08/specification/overview/
  version: '2026-04-08'
  supported_versions:
  - '2026-04-08'
  - '2026-01-23'
  service: dev.ucp.shopping
  schema: https://ucp.dev/2026-04-08/services/shopping/mcp.openrpc.json
  schema_file: brooklinen-ucp-shopping-mcp.openrpc.json
  platform: Shopify
capabilities:
- dev.ucp.shopping.cart
- dev.ucp.shopping.checkout
- dev.ucp.shopping.fulfillment
- dev.ucp.shopping.discount
- dev.ucp.shopping.order
- dev.ucp.shopping.catalog.search
- dev.ucp.shopping.catalog.lookup
- dev.shopify.catalog
payment_handlers:
- id: gpay
  handler: com.google.pay
  version: '2026-01-11'
- id: shopify.card
  handler: dev.shopify.card
  version: '2026-01-15'
- id: shop_pay
  handler: dev.shopify.shop_pay
  version: '2026-04-08'
introspection:
  tools_list_attempted: true
  tools_list_status: gated
  http_status: 422
  error_code: -32001
  error: 'UCP discovery failed / invalid_profile_url: Unable to fetch agent profile: Missing profile uri'
  note: >-
    Anonymous MCP tools/list is refused. The endpoint requires a resolvable UCP agent profile — the
    `meta.ucp-agent.profile` request property, which maps to the HTTP `UCP-Agent` header, is `required` in
    the published UCP shopping schema. Live tool schemas therefore need an agent that publishes its own UCP
    profile document. The tool set below is NOT guessed: it is read from
    https://ucp.dev/2026-04-08/services/shopping/mcp.openrpc.json, the exact schema Brooklinen's own
    /.well-known/ucp names for its `dev.ucp.shopping` MCP transport (saved verbatim alongside this file).
  probes:
  - {url: 'https://www.brooklinen.com/api/ucp/mcp', method: 'tools/list', auth: none, http_status: 422}
  - {url: 'https://www.brooklinen.com/api/ucp/mcp', method: 'tools/list', auth: 'meta.ucp-agent.profile', http_status: 422}
tools:
- name: search_catalog
  description: Search for products in the catalog.
  params: [meta, catalog]
  capability: dev.ucp.shopping.catalog.search
- name: lookup_catalog
  description: Batch lookup products or variants by identifier.
  params: [meta, catalog]
  capability: dev.ucp.shopping.catalog.lookup
- name: get_product
  description: Get product details.
  params: [meta, catalog]
  capability: dev.ucp.shopping.catalog.lookup
- name: create_cart
  description: Create a cart.
  params: [meta, cart]
  capability: dev.ucp.shopping.cart
- name: get_cart
  description: Get cart.
  params: [meta, id]
  capability: dev.ucp.shopping.cart
- name: update_cart
  description: Update cart.
  params: [meta, id, cart]
  capability: dev.ucp.shopping.cart
- name: cancel_cart
  description: Cancel cart.
  params: [meta, id]
  capability: dev.ucp.shopping.cart
- name: create_checkout
  description: Create a new checkout session.
  params: [meta, checkout]
  capability: dev.ucp.shopping.checkout
- name: get_checkout
  description: Get checkout.
  params: [meta, id]
  capability: dev.ucp.shopping.checkout
- name: update_checkout
  description: Update checkout.
  params: [meta, id, checkout]
  capability: dev.ucp.shopping.checkout
- name: complete_checkout
  description: Complete checkout and place order. Requires explicit human buyer approval of payment.
  params: [meta, id, checkout]
  capability: dev.ucp.shopping.checkout
  human_in_the_loop: required
- name: cancel_checkout
  description: Cancel checkout.
  params: [meta, id]
  capability: dev.ucp.shopping.checkout
- name: get_order
  description: Get order.
  params: [meta, id]
  capability: dev.ucp.shopping.order
request_meta:
  required:
  - ucp-agent.profile
  optional:
  - idempotency-key
  notes: >-
    `meta.ucp-agent.profile` (URI, required) maps to the HTTP `UCP-Agent` header.
    `meta.idempotency-key` (UUID, optional) maps to the HTTP `Idempotency-Key` header and provides retry
    safety. See conventions/brooklinen-conventions.yml.
rules:
- Checkout requires contemporaneous human buyer approval; agents must not complete payment autonomously.
- The MCP endpoint is rate-limited per IP; back off on 429.
- Pass `context.address_country` and `context.currency` for accurate pricing and availability.
alternatives:
- name: Shop skill
  url: https://shop.app/SKILL.md
  note: >-
    Brooklinen's /agents.md recommends personal shopping agents install the Shopify Shop skill and transact
    via Shop Pay rather than scripting the storefront directly. This is a Shopify-wide surface, not
    Brooklinen-specific.
x-evidence:
  fetched: '2026-08-02'
  urls:
  - {url: 'https://www.brooklinen.com/.well-known/ucp', http_status: 200, content_type: 'application/json; charset=utf-8'}
  - {url: 'https://www.brooklinen.com/api/ucp/mcp', http_status: 422, content_type: 'application/json; charset=utf-8'}
  - {url: 'https://ucp.dev/2026-04-08/services/shopping/mcp.openrpc.json', http_status: 200, content_type: 'application/json; charset=utf-8'}
  - {url: 'https://www.brooklinen.com/agents.md', http_status: 200, content_type: 'text/markdown; charset=utf-8'}