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 E-Commerce.

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

🌐 Visit website 📡 Source on GitHub

19.0/100 emerging ▬ flat Agent 23/100 agent aware Full breakdown ↓
scored 2026-08-20 · rubric v0.12.0

AccessSelf serve

1 APIs 1 MCP Servers

CompanyConsumerBeveragesDirect to ConsumerE-CommerceAgentic CommerceShopifyGermany

Kin Score

Kin Score How this is scored →
scored 2026-08-20 · rubric v0.12.0

Composite quality — 19.0/100 · emerging

Contract Quality 0.0 / 25

Developer Ergonomics 4.8 / 20

Access Clarity 5.5 / 20

Operational Transparency 0.0 / 13

Contract Governance 0.0 / 12

Discoverability 8.7 / 10

Agent readiness — 23/100 · agent aware

Machine-Readable Contract 0 / 18

Agentic Access Contract 0 / 10

Documented Reversibility 0 / 6

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 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

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.

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

Agent Surfaces 4

MCP servers, agent skills, and machine-readable catalogs

MCPServer

WellKnown

LLMsTxt

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)

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.23'
created: '2026-07-17'
modified: '2026-07-19'
tags:
- Company
- Consumer
- Beverages
- Direct to Consumer
- E-Commerce
- Agentic Commerce
- Shopify
- Germany
tags_raw:
- 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
  - E-Commerce
  - Shopify
  tags_raw:
  - 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