True Botanicals

aid: true-botanicals
name: True Botanicals
description: True Botanicals is a clean-luxury skincare company selling clinically tested, MADE SAFE certified face and body
  products direct to consumers from truebotanicals.com. It is not a developer-tools company and publishes no developer portal,
  API keys or SDKs; its machine-readable surface is the agent-commerce layer its Shopify storefront exposes on its own domain
  — an llms.txt and agents.md at the site root, a Universal Commerce Protocol (UCP) merchant profile at /.well-known/ucp,
  an unauthenticated MCP endpoint at /api/ucp/mcp serving 13 catalog, cart, checkout and order tools, a keyless Shopify Storefront
  GraphQL endpoint, and OAuth 2.0 / OpenID Connect discovery documents for Shopify customer accounts. Every artifact in this
  repo was probed live from truebotanicals.com; the schemas behind them are platform-authored by Shopify and shared with every
  Shopify merchant, and are recorded here as served, not as contracts True Botanicals authored.
image: https://truebotanicals.com/cdn/shop/files/TB_True_Botanicals_f873166b-61da-41ce-8c3d-ea2ab3565a12.png?v=1772667499
url: https://raw.githubusercontent.com/api-evangelist/true-botanicals/refs/heads/main/apis.yml
x-type: company
x-source: harvest:secondary-market
x-tier: profiled
x-tier-reason: enrichment-pass-2026-08-30
specificationVersion: '0.20'
created: '2026-08-30'
modified: '2026-08-30'
tags:
- Company
- Retail
- E-Commerce
- Beauty
- Skincare
- Consumer Goods
- Direct to Consumer
- Agentic Commerce
- Shopify
- MCP
- Universal Commerce Protocol
tags_raw:
- Company
- Retail
- E-Commerce
- Beauty
- Skincare
- Consumer Goods
- Direct To Consumer
- Agentic Commerce
- Shopify
- MCP
- Universal Commerce Protocol
apis:
- name: True Botanicals UCP Agent Commerce (MCP)
  description: The Universal Commerce Protocol shopping service True Botanicals serves at its own domain. A POST to /api/ucp/mcp
    answers an unauthenticated MCP tools/list with 13 tools — search_catalog, lookup_catalog, get_product, create_cart, get_cart,
    update_cart, cancel_cart, create_checkout, get_checkout, update_checkout, complete_checkout, cancel_checkout and get_order
    — each carrying a JSON Schema 2020-12 inputSchema. Checkout completion requires contemporaneous human approval; the store
    states this in both robots.txt and llms.txt.
  humanURL: https://truebotanicals.com/agents.md
  baseURL: https://truebotanicals.com/api/ucp/mcp
  tags:
  - Agentic Commerce
  - MCP
  - UCP
  - Retail
  properties:
  - type: MCPServer
    url: mcp/true-botanicals-mcp.yml
  - type: ToolCrosswalk
    url: mcp/true-botanicals-tool-crosswalk.yml
  - type: Documentation
    url: https://truebotanicals.com/agents.md
- name: True Botanicals Storefront GraphQL (Shopify)
  description: The Shopify Storefront GraphQL API as served on True Botanicals' own domain. Introspection and catalog queries
    answered keyless on 2026-08-30 (424 types; shop.name returned "True Botanicals"), so the endpoint is a live, callable
    read surface over this merchant's catalog. The schema itself is version 2026-01 of Shopify's platform Storefront API,
    identical across Shopify merchants — recorded here as served by this host, not as a contract True Botanicals authored.
  humanURL: https://shopify.dev/docs/api/storefront
  baseURL: https://truebotanicals.com/api/2026-01/graphql.json
  tags:
  - GraphQL
  - Retail
  - E-Commerce
  properties:
  - type: GraphQL
    url: graphql/true-botanicals-graphql.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: Website
  url: https://truebotanicals.com/
- type: Documentation
  url: https://truebotanicals.com/agents.md
- type: Support
  url: https://truebotanicals.com/pages/contact-us
- type: Login
  url: https://truebotanicals.com/account/login
- type: Blog
  url: https://truebotanicals.com/blogs/news
- type: TermsOfService
  url: https://truebotanicals.com/policies/terms-of-service
- type: PrivacyPolicy
  url: https://truebotanicals.com/policies/privacy-policy
- type: LLMsTxt
  url: llms/true-botanicals-llms.txt
- type: MCPServer
  url: mcp/true-botanicals-mcp.yml
- type: WellKnown
  url: well-known/true-botanicals-well-known.yml
- type: Authentication
  url: authentication/true-botanicals-authentication.yml
- type: OAuthScopes
  url: scopes/true-botanicals-scopes.yml
- type: Conformance
  url: conformance/true-botanicals-conformance.yml
- type: Conventions
  url: conventions/true-botanicals-conventions.yml
- type: Lifecycle
  url: lifecycle/true-botanicals-lifecycle.yml
- type: RateLimits
  url: rate-limits/true-botanicals-rate-limits.yml
- type: Plans
  url: plans/true-botanicals-plans-pricing.yml
- type: DataModel
  url: data-model/true-botanicals-data-model.yml
- type: ErrorCatalog
  url: errors/true-botanicals-problem-types.yml
- type: AgentSkill
  url: skills/_index.yml
- type: DomainSecurity
  url: security/true-botanicals-domain-security.yml
x-pointer-liveness:
  checked: '2026-08-30'
  method: GET with a browser User-Agent, following redirects; body inspected, not just the status code
  pointers:
  - url: https://truebotanicals.com/
    status: 200
  - url: https://truebotanicals.com/agents.md
    status: 200
    content_type: text/markdown
  - url: https://truebotanicals.com/pages/contact-us
    status: 200
    note: Real page, <title>Contact Us | True Botanicals</title>
  - url: https://truebotanicals.com/blogs/news
    status: 200
    note: Real blog, <title>The Ritual | An Exploration Of Self-care</title>
  - url: https://truebotanicals.com/policies/terms-of-service
    status: 200
  - url: https://truebotanicals.com/policies/privacy-policy
    status: 200
  - url: https://truebotanicals.com/account/login
    status: 200
    note: Returned 406 to a plain crawler UA and 200 to a browser UA — an edge bot policy, not a dead page.
  - url: https://truebotanicals.com/api/ucp/mcp
    status: 200
    note: POST tools/list, 13 tools
  - url: https://truebotanicals.com/api/2026-01/graphql.json
    status: 200
    note: POST introspection, 424 types
  - url: https://shopify.dev/docs/api/storefront
    status: 200
    note: humanURL for the GraphQL entry; third-party platform documentation, labelled as such in the entry description.
  not_wired:
  - url: https://truebotanicals.com/pages/faq
    status: 404
    reason: No FAQ/help page exists, so no HelpCenter pointer was emitted.
  - url: https://developers.truebotanicals.com
    status: 0
    reason: DNS does not resolve; no DeveloperPortal pointer was emitted.
  - url: https://truebotanicals.com/.well-known/security.txt
    status: 404
    reason: No SecurityTxt or Security pointer was emitted.
  - url: https://truebotanicals.com/.well-known/agent-card.json
    status: 404
    reason: No AgentCard pointer and no a2a/ artifact were written.
x-enrichment:
  date: '2026-08-30'
  status: enriched
  artifacts_added: 24
  pass: local-v1