generated: '2026-08-06'
method: searched
source: https://athleticbrewing.com/api/ucp/mcp
status: live
name: Athletic Brewing UCP Commerce MCP Server
description: >-
  Athletic Brewing's Shopify storefront serves a live, anonymous Model Context Protocol
  endpoint implementing the Universal Commerce Protocol (UCP) dev.ucp.shopping service.
  Discovered from the store's own /llms.txt, /agents.md and /robots.txt, confirmed against
  /.well-known/ucp, and introspected directly: an unauthenticated tools/list returned all
  thirteen tools with complete JSON Schema. This is not a developer program Athletic
  Brewing built — it is the Shopify commerce platform's agent surface, served from
  Athletic Brewing's own host and advertised in Athletic Brewing's own robots.txt.
transport: streamable-http
endpoint: https://athleticbrewing.com/api/ucp/mcp
alternate_endpoint: https://athletic-brewing-company.myshopify.com/api/ucp/mcp
protocol:
  jsonrpc: '2.0'
  mcp_protocol_version: '2025-06-18'
  server_info:
    name: universal-commerce
    version: 0.1.0
  server_capabilities:
    tools:
      listChanged: true
    prompts:
      listChanged: true
    resources:
      listChanged: true
    logging: {}
  ucp_api_version: '2026-04-08'
  ucp_supported_versions:
  - '2026-04-08'
  - '2026-01-23'
authentication:
  tools_list: anonymous
  tools_call: >-
    Requires meta.ucp-agent.profile — a resolvable UCP agent profile URI. Calls without it
    return HTTP 422 with JSON-RPC error -32001 "UCP discovery failed". Buyer-scoped
    operations additionally require Shopify customer-account OAuth (see
    authentication/athletic-brewing-authentication.yml).
tool_count: 13
tools:
- name: search_catalog
  category: catalog
  description: Search for products from the online store using natural language.
  parameters: [meta, catalog]
  notable: >-
    catalog.query, catalog.filters (categories, price min/max in minor units, available),
    catalog.context (address_country, address_region, postal_code, language, currency,
    intent), catalog.pagination (cursor, limit default 10).
- name: lookup_catalog
  category: catalog
  description: Look up multiple products or variants by identifier in a single request.
  parameters: [meta, catalog]
- name: get_product
  category: catalog
  description: Retrieve complete product detail by identifier, with variants and exact pricing.
  parameters: [meta, catalog]
- name: create_cart
  category: cart
  description: Creates a new cart.
  parameters: [meta, cart]
- name: get_cart
  category: cart
  description: Get the cart contents.
  parameters: [meta, id]
- name: update_cart
  category: cart
  description: Perform updates to a cart.
  parameters: [meta, cart, id]
- name: cancel_cart
  category: cart
  description: Cancels a cart.
  parameters: [meta, id]
- name: create_checkout
  category: checkout
  description: Creates a checkout; returns line items, totals, discounts and taxes.
  parameters: [meta, checkout]
- name: get_checkout
  category: checkout
  description: Returns details about the checkout, including line items, totals, discounts and taxes.
  parameters: [meta, id]
- name: update_checkout
  category: checkout
  description: Updates a checkout (shipping address, fulfillment method, discounts).
  parameters: [meta, checkout, id]
- name: complete_checkout
  category: checkout
  description: Completes a checkout and returns the order result.
  parameters: [meta, checkout, id]
  requires_idempotency_key: true
  note: >-
    meta.idempotency-key is a REQUIRED property on this tool — the only tool of the
    thirteen that requires one. Buyer approval of payment is mandatory per the store's
    published agent rules.
- name: cancel_checkout
  category: checkout
  description: Cancels a checkout.
  parameters: [meta, id]
- name: get_order
  category: order
  description: Get the details of an order.
  parameters: [meta, id]
capabilities_declared:
- dev.ucp.shopping.catalog.search
- dev.ucp.shopping.catalog.lookup
- dev.ucp.shopping.cart
- dev.ucp.shopping.checkout
- dev.ucp.shopping.fulfillment
- dev.ucp.shopping.discount
- dev.ucp.shopping.order
payment_handlers:
- dev.shopify.card
- dev.shopify.shop_pay
- google_pay
schemas:
  verbatim: mcp/athletic-brewing-tools-list.json
  upstream_openrpc: https://ucp.dev/2026-04-08/services/shopping/mcp.openrpc.json
  note: >-
    The full inputSchema for every tool is saved verbatim in
    mcp/athletic-brewing-tools-list.json exactly as the endpoint returned it. The generic
    UCP shopping OpenRPC schema is published by ucp.dev, not by Athletic Brewing.
rules:
- Checkout requires contemporaneous human 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.
x-evidence:
  fetched: '2026-08-06'
  probes:
  - url: https://athleticbrewing.com/api/ucp/mcp
    method: POST tools/list
    http_status: 200
    content_type: application/json
    bytes: 42650
  - url: https://athleticbrewing.com/api/ucp/mcp
    method: POST initialize
    http_status: 200
  - url: https://athleticbrewing.com/.well-known/ucp
    method: GET
    http_status: 200
  - url: https://athleticbrewing.com/llms.txt
    method: GET
    http_status: 200
  response_headers:
    x-shopify-ucp-mcp-api-version: '2026-04-08'
    x-request-id: present on every response
    server: cloudflare