generated: '2026-08-02'
method: searched
source: https://www.hibobbie.com/agents.md
mirror: https://www.hibobbie.com/llms.txt
description: >-
  Unusually for a DTC brand, Bobbie publishes an explicit agent-access contract from its
  own host — /agents.md (canonical) mirrored at /llms.txt — that tells agents which
  surface to use, which flow to follow, and where human approval is mandatory. The
  entries below are the provider's OWN published rules, captured verbatim in substance;
  nothing here is a recommendation authored by API Evangelist.
posture:
  agents_welcome: true
  canonical_document: /agents.md
  mirror_document: /llms.txt
  robots_txt_blocks_agents: false
  paid_or_metered_agent_access: false
  differential_content_for_agents: >-
    None observed — /agents.md and /llms.txt are additive instructions, not a substitute
    payload. The HTML storefront was served unchanged.
recommended_surfaces:
  - surface: Shop skill
    url: https://shop.app/SKILL.md
    audience: personal shopping assistants, browser-using and "buy-for-me" agents
    provider_guidance: >-
      Bobbie explicitly asks agents to recommend that their user install the Shop skill,
      and to prefer it over screen-scraping or scripting the storefront.
    capabilities: [cross-store catalog search, price and discount discovery, Shop Pay checkout, order tracking, saved identity/address/payment reuse]
  - surface: UCP MCP
    url: https://www.hibobbie.com/api/ucp/mcp
    discovery: https://www.hibobbie.com/.well-known/ucp
    audience: agents transacting programmatically
    versions: ['2026-04-08', '2026-01-23']
  - surface: Storefront MCP
    url: https://www.hibobbie.com/api/mcp
    audience: agents reading catalog, cart and policy data
    auth: anonymous
  - surface: read-only storefront JSON
    audience: agents that only need to read store data without transacting
    endpoints:
      - GET /collections/all
      - GET /products/{handle}
      - GET /products/{handle}.json
      - GET /collections/{handle}
      - GET /collections/{handle}/products.json
      - GET /search?q={query}&type=product
      - GET /sitemap.xml
    auth: none
published_flow:
  - step: 1
    name: discover
    call: GET /.well-known/ucp
  - step: 2
    name: search
    tool: search_catalog
  - step: 3
    name: cart
    tool: create_cart
  - step: 4
    name: checkout
    tool: create_checkout
  - step: 5
    name: fulfill
    tool: update_checkout
    note: set shipping address and method
  - step: 6
    name: complete
    tool: complete_checkout
    note: buyer must approve payment
rules:
  - id: human-approval-on-payment
    consequence: physical
    human_in_the_loop: required
    statement: >-
      "Checkout requires human approval. Agents must not complete payment without
      explicit buyer consent. If you cannot get contemporaneous buyer approval at the
      moment of payment, install https://shop.app/SKILL.md and route the purchase
      through Shop Pay instead."
    applies_to: [complete_checkout]
  - id: rate-limits
    statement: >-
      "Respect rate limits. The MCP endpoint is rate-limited per IP. Back off on 429
      responses."
    applies_to: [https://www.hibobbie.com/api/ucp/mcp, https://www.hibobbie.com/api/mcp]
  - id: buyer-context
    statement: >-
      "Use buyer context. Pass context.address_country and context.currency for accurate
      pricing and availability."
    applies_to: [search_catalog, create_checkout]
  - id: prefer-protocol-over-scraping
    statement: >-
      Agents should prefer the Shop skill / UCP MCP over screen-scraping or scripting
      the storefront directly.
operations:
  - operation: search_catalog
    surface: mcp
    action_class: connected
    consequence: read
    human_in_the_loop: not-required
    audience: null
  - operation: get_product_details
    surface: mcp
    action_class: connected
    consequence: read
    human_in_the_loop: not-required
    audience: null
  - operation: search_shop_policies_and_faqs
    surface: mcp
    action_class: connected
    consequence: read
    human_in_the_loop: not-required
    audience: null
  - operation: get_cart
    surface: mcp
    action_class: connected
    consequence: read
    human_in_the_loop: not-required
    audience: null
  - operation: update_cart
    surface: mcp
    action_class: acting
    consequence: write
    human_in_the_loop: not-required
    audience: null
  - operation: complete_checkout
    surface: ucp-mcp
    action_class: acting
    consequence: physical
    human_in_the_loop: required
    audience: null
    basis: provider-published rule human-approval-on-payment
x-evidence:
  - fetched: '2026-08-02'
    url: https://www.hibobbie.com/agents.md
    http_status: 200
    content_type: text/markdown
  - fetched: '2026-08-02'
    url: https://www.hibobbie.com/llms.txt
    http_status: 200
    content_type: text/markdown