HOLY

HOLY is a German direct-to-consumer beverage brand offering sugar-free, powdered and syrup-based drink mixes that customers prepare with water or milk. Its product families span HOLY Energy (caffeine and vitamins), HOLY Iced Tea, HOLY Hydration (isotonic electrolytes), HOLY Milkshake (low-calorie), and HOLY Syrup. Founded by three friends (Matze, Fred, and Phil), the company grew from a shared apartment to 50+ employees, 2 million customers, and 500,000+ social followers, positioned on "great taste with a good conscience." HOLY sells online via a Shopify storefront and exposes a modern agentic-commerce surface: a hosted Storefront MCP server, a Universal Commerce Protocol (UCP) endpoint, llms.txt / agents.md agent instructions, and Shopify Customer Account OAuth/OIDC.

HOLY publishes 1 API on the APIs.io network. Tagged areas include Company, Consumer, Beverages, Direct-to-Consumer, and Ecommerce.

HOLY’s developer surface includes support, authentication, and 15 more developer resources.

🌐 Visit website 📡 Source on GitHub
22.2/100 emerging ▬ flat Agent 30/100 agent aware Full breakdown ↓
scored 2026-07-27 · rubric v0.5
AccessSelf serve
1 APIs 1 MCP Servers
CompanyConsumerBeveragesDirect-to-ConsumerEcommerceAgentic CommerceShopifyGermany

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5
Composite quality — 22.2/100 · emerging
Contract Quality 0.0 / 25
Developer Ergonomics 6.1 / 20
Commercial Clarity 6.8 / 20
Operational Transparency 0.0 / 13
Governance 0.0 / 12
Discoverability 9.3 / 10
Agent readiness — 30/100 · agent aware
Machine-Readable Contract 0 / 18
Agentic Access Contract 0 / 15
MCP Server 12 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 0 / 7
Typed Event Surface 0 / 6
Agent Skills 5 / 5
Well-Known Catalog 4 / 4
Consent & Bot Identity 0 / 3
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/holy: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 1

Individual APIs this provider publishes, each with its own machine-readable definition.

HOLY Storefront & Agentic Commerce

HOLY's Shopify-powered storefront and its agentic-commerce surface: a hosted Storefront MCP server (product search, cart, policies), a Universal Commerce Protocol (UCP) endpoint...

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

holy-mcp.yml

MCP SERVER

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Holy Authentication

oauth2/openIdConnect · 2 schemes

SECURITY

Holy Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Holy Scopes

4 scopes · authorizationCode

4 scopes

SCOPES

Resources

Get Started 1

Portal, sign-up, and the first successful call

Login
Login

Agent Surfaces 4

MCP servers, agent skills, and machine-readable catalogs

MCPServer
MCPServer
 WellKnown
WellKnown
 LLMsTxt
LLMsTxt
 AgentSkill
AgentSkill

Design & Contract 1

Pagination, idempotency, versioning, errors, and events

Conventions
Conventions

Access & Security 3

Authentication, authorization, and security posture

Authentication
Authentication
 OAuthScopes
OAuthScopes
 DomainSecurity
DomainSecurity

Operate 3

Status, limits, changes, and where to get help

Support
Support
 HelpCenter
HelpCenter
 Contact
Contact

Commercial 2

Pricing, plans, and the legal terms of use

TermsOfService
TermsOfService
 PrivacyPolicy
PrivacyPolicy

Company 2

The organization behind the API

Website
Website
 About
About

Other 1

Properties that don't map to a standard resource type

OpenIDConnect
OpenIDConnect

Source (apis.yml)

apis.yml Raw ↑ 
aid: holy
name: HOLY
description: 'HOLY is a German direct-to-consumer beverage brand offering sugar-free, powdered and syrup-based drink mixes
  that customers prepare with water or milk. Its product families span HOLY Energy (caffeine and vitamins), HOLY Iced Tea,
  HOLY Hydration (isotonic electrolytes), HOLY Milkshake (low-calorie), and HOLY Syrup. Founded by three friends (Matze, Fred,
  and Phil), the company grew from a shared apartment to 50+ employees, 2 million customers, and 500,000+ social followers,
  positioned on "great taste with a good conscience." HOLY sells online via a Shopify storefront and exposes a modern agentic-commerce
  surface: a hosted Storefront MCP server, a Universal Commerce Protocol (UCP) endpoint, llms.txt / agents.md agent instructions,
  and Shopify Customer Account OAuth/OIDC.'
url: https://raw.githubusercontent.com/api-evangelist/holy/refs/heads/main/apis.yml
x-type: company
x-source: vc-portfolio
x-backed-by:
- hv-capital
x-tier: stub
x-tier-reason: portfolio-lead
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: medium
  source:
  - authentication
  generated: '2026-07-22'
  method: derived
specificationVersion: '0.20'
created: '2026-07-17'
modified: '2026-07-19'
tags:
- Company
- Consumer
- Beverages
- Direct-to-Consumer
- Ecommerce
- Agentic Commerce
- Shopify
- Germany
image: https://de.holy.com/cdn/shop/files/holy-syrup-2.png?v=1775851476
apis:
- name: HOLY Storefront & Agentic Commerce
  description: 'HOLY''s Shopify-powered storefront and its agentic-commerce surface: a hosted Storefront MCP server (product
    search, cart, policies), a Universal Commerce Protocol (UCP) endpoint, Shopify Customer Account OAuth/OIDC + GraphQL,
    and llms.txt / agents.md agent instructions. Shopify store: holyenergy.myshopify.com.'
  humanURL: https://de.holy.com/llms.txt
  baseURL: https://de.holy.com
  tags:
  - Agentic Commerce
  - MCP
  - Ecommerce
  - Shopify
  properties: []
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: Website
  url: https://de.holy.com
- type: About
  url: https://de.holy.com/pages/our-story
- type: Support
  url: https://de.holy.com/pages/help-center
- type: HelpCenter
  url: https://de.holy.com/pages/help-center
- type: Contact
  url: https://de.holy.com/pages/contact-form
- type: TermsOfService
  url: https://de.holy.com/policies/terms-of-service
- type: PrivacyPolicy
  url: https://de.holy.com/policies/privacy-policy
- type: Login
  url: https://de.holy.com/account
- type: MCPServer
  url: mcp/holy-mcp.yml
- type: WellKnown
  url: well-known/holy-well-known.yml
- type: Authentication
  url: authentication/holy-authentication.yml
- type: OAuthScopes
  url: scopes/holy-scopes.yml
- type: OpenIDConnect
  url: well-known/holy-openid-configuration.json
- type: LLMsTxt
  url: llms/holy-llms.txt
- type: AgentSkill
  url: skills/_index.yml
- type: Conventions
  url: conventions/holy-conventions.yml
- type: DomainSecurity
  url: security/holy-domain-security.yml
x-enrichment:
  date: '2026-07-19'
  status: backfilled
  pass: local-v1
  note: backfilled from .gitignore signal + verified work evidence