# Lemon Perfect

**Canonical:** https://apis.io/providers/lemon-perfect/  
**Website:** https://lemonperfect.com/  
**APIs profiled:** 2

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.

## Kin Score — 41.4 / 100 (developing)

Scored 2026-08-19 under rubric 0.12.0. Trend: flat (+0.3 from 41.1).

| Facet | Score |
|---|---|
| Discoverability | 75.9 |
| Contract Quality | 43.3 |
| Governance | 18.2 |
| Contract Governance | 18.2 |
| Operational Transparency | 31.6 |
| Developer Ergonomics | 49.4 |
| Commercial Clarity | 34.2 |
| Access Clarity | 34.2 |

## Agent readiness — 42.1 (agent-ready)

| Dimension | Value |
|---|---|
| Spec Presence | yes |
| Agentic Access | no |
| Reversibility Documented | no |
| MCP Server | verified |
| Auth Clarity | yes |
| Idempotency | documented |
| Error Semantics | no |
| OpenAPI Examples | no |
| Rate Limit Signal | documented |
| Event Surface Described | no |
| Agent Skills | derived |
| Well Known Catalog | no |
| Consent Identity | no |
| Agent Card | no |
| Dry Run Mode | no |

## APIs (2)

- **Lemon Perfect Storefront GraphQL API** — The Shopify Storefront GraphQL API served on lemonperfect.com. Introspection is open anonymously: 428 types, 35 query fields and 41 mutations covering products, collections, sea...
- **Lemon Perfect UCP Agentic Commerce (MCP)** — 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, checko...

## MCP servers (1)

- **lemon-perfect-mcp.yml**

## Security (2)

- **Lemon Perfect Authentication** — oauth2/openIdConnect/apiKey/agentIdentity · 4 schemes
- **Lemon Perfect Domain Security** — TLSv1.3 · HSTS · DMARC

## Tags

Company, Beverages, Consumer Packaged Goods, Ecommerce, Retail, Direct to Consumer, Agentic Commerce, Model Context Protocol, GraphQL, Universal Commerce Protocol, Shopify

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/lemon-perfect/). Scores are computed from the provider's own public artifacts under a published rubric.