aid: brooklinen name: Brooklinen description: >- Brooklinen is a direct-to-consumer home essentials brand founded in Brooklyn, New York in 2014 by Rich and Vicki Fulop, selling sheets, duvet covers, comforters, pillows, towels, robes and loungewear direct from the mill to the customer. Brooklinen publishes no traditional developer API program, but its storefront runs on Shopify and exposes a substantial machine-readable agent surface: an agent instruction document at /agents.md (mirrored at /llms.txt), a Universal Commerce Protocol (UCP) merchant profile at /.well-known/ucp declaring protocol versions 2026-04-08 and 2026-01-23, a live UCP/MCP JSON-RPC endpoint at /api/ucp/mcp for agent-driven catalog search, cart, checkout and order operations, OAuth 2.0 / OIDC customer-account authorization metadata at /.well-known/oauth-authorization-server and /.well-known/oauth-protected-resource, and the read-only Shopify storefront JSON endpoints for products, collections, search suggestions and cart. Checkout explicitly requires contemporaneous human buyer approval. url: https://raw.githubusercontent.com/api-evangelist/brooklinen/refs/heads/main/apis.yml image: https://cdn.shopify.com/s/files/1/0951/7126/files/0126_Shopify_Social_Image.jpg?v=1765839763 x-type: company x-source: harvest:secondary-market specificationVersion: '0.20' created: '2026-08-02' modified: '2026-08-02' tags: - ecommerce - retail - direct-to-consumer - home-goods - bedding - shopify - agentic-commerce - universal-commerce-protocol - mcp - agent-native - catalog - checkout apis: - name: Brooklinen UCP / MCP Agentic Commerce API description: >- Live Universal Commerce Protocol (UCP) endpoint exposed over MCP JSON-RPC at https://www.brooklinen.com/api/ucp/mcp, advertised by the store's own /agents.md, /robots.txt and /.well-known/ucp discovery profile. Provides agent-driven catalog search and lookup, cart management, checkout creation/update/completion and order retrieval against the Brooklinen storefront. Requires a resolvable UCP agent profile (meta.ucp-agent.profile / UCP-Agent header) — anonymous tools/list returns JSON-RPC error -32001 invalid_profile_url. Payment completion requires explicit human buyer approval. humanURL: https://www.brooklinen.com/agents.md baseURL: https://www.brooklinen.com/api/ucp/mcp tags: - agentic-commerce - universal-commerce-protocol - mcp - agent-native - checkout - catalog properties: - type: MCPServer url: mcp/brooklinen-mcp.yml - type: MCP url: https://www.brooklinen.com/api/ucp/mcp - type: ToolCrosswalk url: mcp/brooklinen-tool-crosswalk.yml - type: Documentation url: https://www.brooklinen.com/agents.md - type: WellKnown url: well-known/brooklinen-ucp.json - type: Authentication url: authentication/brooklinen-authentication.yml - type: OAuthScopes url: scopes/brooklinen-scopes.yml - type: Idempotency url: conventions/brooklinen-conventions.yml - type: ErrorCatalog url: errors/brooklinen-problem-types.yml - name: Brooklinen Shopify Storefront JSON API description: >- Read-only, unauthenticated JSON endpoints over the Brooklinen Shopify storefront, documented by the store itself in /agents.md for agents that only need to read store data without transacting. Covers the full product list, per-product detail, per-collection product lists, predictive search suggestions and the session cart. Every operation captured here was probed live and returned HTTP 200. humanURL: https://www.brooklinen.com/agents.md baseURL: https://www.brooklinen.com/ tags: - ecommerce - catalog - shopify - retail - product-data properties: - type: OpenAPI url: openapi/brooklinen-storefront-openapi.yml - type: Overlay url: overlays/brooklinen-storefront-overlay.yaml - type: Documentation url: https://www.brooklinen.com/agents.md - type: DataModel url: data-model/brooklinen-data-model.yml - type: ErrorCatalog url: errors/brooklinen-problem-types.yml maintainers: - FN: Kin Lane email: kin@apievangelist.com - FN: APIs.json email: info@apis.io common: - type: DomainSecurity url: security/brooklinen-domain-security.yml - type: Website url: https://www.brooklinen.com/ - type: Documentation url: https://www.brooklinen.com/agents.md - type: APIReference url: https://www.brooklinen.com/agents.md - type: GettingStarted url: https://www.brooklinen.com/agents.md - type: Support url: https://www.brooklinen.com/pages/contact - type: HelpCenter url: https://www.brooklinen.com/pages/faq - type: Blog url: https://www.brooklinen.com/blogs/brookliving - type: GitHubOrganization url: https://github.com/Brooklinen - type: SignUp url: https://www.brooklinen.com/pages/sign-up - type: Login url: https://www.brooklinen.com/account/login - type: TermsOfService url: https://www.brooklinen.com/policies/terms-of-service - type: PrivacyPolicy url: https://www.brooklinen.com/policies/privacy-policy - type: MCPServer url: mcp/brooklinen-mcp.yml - type: ToolCrosswalk url: mcp/brooklinen-tool-crosswalk.yml - type: LLMsTxt url: llms/brooklinen-llms.txt - type: WellKnown url: well-known/brooklinen-well-known.yml - type: Authentication url: authentication/brooklinen-authentication.yml - type: OAuthScopes url: scopes/brooklinen-scopes.yml - type: Conventions url: conventions/brooklinen-conventions.yml - type: Idempotency url: conventions/brooklinen-conventions.yml - type: Lifecycle url: lifecycle/brooklinen-lifecycle.yml - type: Conformance url: conformance/brooklinen-conformance.yml - type: ErrorCatalog url: errors/brooklinen-problem-types.yml - type: DataModel url: data-model/brooklinen-data-model.yml - type: AgentSkill url: skills/_index.yml - type: Overlay url: overlays/brooklinen-storefront-overlay.yaml - type: SecondaryMarketListing url: https://forgeglobal.com/brooklinen_stock/ x-enrichment: date: '2026-08-02' status: enriched artifacts_added: 22 pass: local-v1