Lemon Perfect

aid: lemon-perfect
name: Lemon Perfect
description: 'Lemon Perfect is an Atlanta-based beverage company founded in 2017 by Yanni Hufnagel, making organic, zero-sugar
  flavored lemon water powered by half a squeezed organic lemon per bottle and 100% daily value vitamin C. It sells direct-to-consumer
  at lemonperfect.com alongside national retail distribution. It is not a software vendor and publishes no developer program,
  yet its storefront exposes a substantial machine-readable surface on its own apex domain: a Storefront GraphQL API with
  open introspection, a hosted Model Context Protocol endpoint implementing the Universal Commerce Protocol for agent-driven
  search, cart and checkout, OpenID Connect and RFC 8414 discovery for customer accounts, and first-party agent instructions
  at /agents.md and /llms.txt that set an explicit human-approval-before-payment policy.'
url: https://raw.githubusercontent.com/api-evangelist/lemon-perfect/refs/heads/main/apis.yml
image: https://cdn.shopify.com/s/files/1/0032/0520/2020/files/Product_Lineup_52.jpg
x-type: company
x-source: harvest:secondary-market
specificationVersion: '0.20'
created: '2026-08-04'
modified: '2026-08-04'
tags:
- Company
- Beverages
- Consumer Packaged Goods
- Ecommerce
- Retail
- Direct to Consumer
- Agentic Commerce
- Model Context Protocol
- GraphQL
- Universal Commerce Protocol
- Shopify
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
apis:
- name: Lemon Perfect Storefront GraphQL API
  description: 'The Shopify Storefront GraphQL API served on lemonperfect.com. Introspection is open anonymously: 428 types,
    35 query fields and 41 mutations covering products, collections, search, carts, customer accounts and Shop Pay payment-request
    sessions. Calendar-versioned in the path; 2026-07 current.'
  humanURL: https://lemonperfect.com/agents.md
  baseURL: https://lemonperfect.com/api/2026-07/graphql.json
  tags:
  - GraphQL
  - Ecommerce
  - Products
  - Cart
  properties:
  - type: GraphQL
    url: graphql/lemon-perfect-storefront-2026-07.graphql
  - type: DataModel
    url: data-model/lemon-perfect-data-model.yml
  - type: ErrorCatalog
    url: errors/lemon-perfect-error-codes.yml
  - type: DeclineCodes
    url: errors/lemon-perfect-decline-codes.yml
  - type: AgentSkill
    url: skills/lemon-perfect-browse-catalog.md
- name: Lemon Perfect UCP Agentic Commerce (MCP)
  description: A hosted Model Context Protocol endpoint implementing the Universal Commerce Protocol dev.ucp.shopping service
    (version 2026-04-08) for agent-driven catalog search, cart, checkout, fulfillment and order lookup. Advertised in robots.txt,
    /agents.md, /llms.txt and /.well-known/ucp. tools/list is gated on a resolvable UCP-Agent profile; payment requires explicit
    human approval.
  humanURL: https://lemonperfect.com/agents.md
  baseURL: https://lemonperfect.com/api/ucp/mcp
  tags:
  - MCP
  - Agentic Commerce
  - Checkout
  properties:
  - type: MCPServer
    url: mcp/lemon-perfect-mcp.yml
  - type: ToolCrosswalk
    url: mcp/lemon-perfect-tool-crosswalk.yml
  - type: AgentSkill
    url: skills/lemon-perfect-agentic-purchase.md
common:
- type: Website
  url: https://lemonperfect.com/
- type: Documentation
  url: https://lemonperfect.com/agents.md
- type: APIReference
  url: https://lemonperfect.com/.well-known/ucp
- type: GettingStarted
  url: https://lemonperfect.com/llms.txt
- type: Blog
  url: https://lemonperfect.com/blogs/news
- type: BlogRSS
  url: https://lemonperfect.com/blogs/news.atom
- type: Support
  url: https://lemonperfect.com/pages/contact-us
- type: SignUp
  url: https://lemonperfect.com/account/login
- type: TermsOfService
  url: https://lemonperfect.com/policies/terms-of-service
- type: PrivacyPolicy
  url: https://lemonperfect.com/policies/privacy-policy
- type: RefundPolicy
  url: https://lemonperfect.com/policies/refund-policy
- type: ShippingPolicy
  url: https://lemonperfect.com/policies/shipping-policy
- type: LLMsTxt
  url: llms/lemon-perfect-llms.txt
- type: AgentsMd
  url: llms/lemon-perfect-agents.md
- type: WellKnown
  url: well-known/lemon-perfect-well-known.yml
- type: Authentication
  url: authentication/lemon-perfect-authentication.yml
- type: OAuthScopes
  url: scopes/lemon-perfect-scopes.yml
- type: OpenIDConnect
  url: well-known/lemon-perfect-openid-configuration.json
- type: Conventions
  url: conventions/lemon-perfect-conventions.yml
- type: Idempotency
  url: conventions/lemon-perfect-conventions.yml
- type: RateLimits
  url: rate-limits/lemon-perfect-rate-limits.yml
- type: Conformance
  url: conformance/lemon-perfect-conformance.yml
- type: Lifecycle
  url: lifecycle/lemon-perfect-lifecycle.yml
- type: DomainSecurity
  url: security/lemon-perfect-domain-security.yml
- type: AgentSkill
  url: skills/_index.yml
x-enrichment-notes:
  no_status_page: Lemon Perfect operates no status page for its API surface (status.lemonperfect.com does not resolve; /status
    is 404). No StatusPage pointer is emitted.
  no_deprecation_policy: Deprecation is signalled inside the GraphQL schema via @deprecated (54 fields) but no deprecation
    policy document is published. No Deprecation pointer.
  no_security_disclosure: /.well-known/security.txt returns 404 and no responsible-disclosure or bug bounty page was found.
    No Security/VulnerabilityDisclosure pointer.
  no_compliance_program: No trust center and no named certifications published. No Compliance or TrustCenter pointer.
  no_openapi: No OpenAPI/Swagger document exists on lemonperfect.com or the canonical the-lemon-perfect-company.myshopify.com
    host. The machine-readable contracts are GraphQL (introspected verbatim) and the UCP/MCP OpenRPC schema.
  no_sdks: No first-party Lemon Perfect client library exists in any public registry. No Packages/SDKs pointer.
  no_a2a: Both /.well-known/agent-card.json and /.well-known/agent.json returned 404. Nothing was written to a2a/ — agent
    cards are never authored on a provider's behalf.
  platform_note: The API surface is Shopify-provided but served from, and configured for, the company's own apex domain. Platform-level
    facts are attributed as such inside each artifact rather than claimed as first-party commitments.
x-enrichment:
  date: '2026-08-04'
  status: enriched
  artifacts_added: 24
  pass: local-v1