Cirkul Storefront Agent API

aid: cirkul:storefront-agent-api
name: Cirkul Storefront Agent API
description: The agent-facing commerce surface Cirkul serves from its own drinkcirkul.com host. It comprises
  an anonymous Model Context Protocol (MCP) server at /api/mcp exposing five tools with real JSON Schema
  inputs (search_catalog, get_cart, update_cart, search_shop_policies_and_faqs, get_product_details),
  a Universal Commerce Protocol merchant discovery profile at /.well-known/ucp declaring cart, checkout,
  fulfillment, discount, order and catalog capabilities plus Shop Pay, Google Pay and card payment handlers,
  and a UCP shopping MCP endpoint at /api/ucp/mcp whose tools/list is gated behind a UCP agent-profile
  URI. Read-only catalog JSON (products.json, collection products.json) is documented for agents that
  only need to browse. Checkout explicitly requires contemporaneous human buyer approval.
humanURL: https://drinkcirkul.com/agents.md
baseURL: https://drinkcirkul.com
tags:
- Agentic Commerce
- Model Context Protocol
- Universal Commerce Protocol
- Ecommerce
- Catalog
- Cart
- Checkout
properties:
- type: MCPServer
  url: mcp/cirkul-mcp.yml
- type: ToolCrosswalk
  url: mcp/cirkul-tool-crosswalk.yml
- type: LLMsTxt
  url: llms/cirkul-llms.txt
- type: Authentication
  url: authentication/cirkul-authentication.yml
- type: OAuthScopes
  url: scopes/cirkul-scopes.yml
- type: ErrorCatalog
  url: errors/cirkul-problem-types.yml
- type: Conventions
  url: conventions/cirkul-conventions.yml
- type: AgentSkill
  url: skills/_index.yml