Flaviar website screenshot

Flaviar

Flaviar is an online spirits retailer and members club for whiskey, tequila, rum, gin and other premium spirits, offering curated tasting boxes, full-size bottles, and a subscription membership. Its direct-to-consumer storefront runs on Shopify and exposes a modern agent-commerce surface: a Universal Commerce Protocol (UCP) merchant profile and hosted MCP shopping endpoint, an llms.txt / agents.md agent-instruction document, and Shopify Customer Account authentication via OAuth 2.0 + OpenID Connect. This profile was added to the API Evangelist network as a portfolio lead and enriched from Flaviar's live public discovery documents.

Flaviar publishes 1 API on the APIs.io network. Tagged areas include Company, Spirits, Whiskey, Ecommerce, and Retail.

Flaviar’s developer surface includes documentation, signup flow, pricing, authentication, and 13 more developer resources.

🌐 Visit website 📡 Source on GitHub
24.8/100 emerging ▬ flat Agent 23/100 agent aware Full breakdown ↓
scored 2026-08-10 · rubric v0.9.1
AccessSelf serve
1 APIs 1 MCP Servers
CompanySpiritsWhiskeyEcommerceRetailBeveragesSubscriptionAgent CommerceShopify

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-10 · rubric v0.9.1
Composite quality — 24.8/100 · emerging
Contract Quality 0.0 / 25
Developer Ergonomics 5.7 / 20
Commercial Clarity 8.9 / 20
Operational Transparency 0.0 / 13
Governance 1.5 / 12
Discoverability 8.7 / 10
Agent readiness — 23/100 · agent aware
Machine-Readable Contract 0 / 18
Agentic Access Contract 0 / 10
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 0 / 5
Well-Known Catalog 4 / 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/flaviar: 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.

Flaviar Agent Commerce (UCP + MCP)

Flaviar's Shopify storefront exposes an agent-driven commerce surface built on the Universal Commerce Protocol (ucp.dev): a discovery document at /.well-known/ucp and a hosted M...

MCP Servers 1

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

flaviar-mcp.yml

MCP SERVER

Security Posture 2

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

Flaviar Authentication

oauth2/openIdConnect · 1 scheme

SECURITY

Flaviar Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Flaviar Scopes

4 scopes · authorizationCode

4 scopes

SCOPES

Resources

Get Started 2

Portal, sign-up, and the first successful call

SignUp
SignUp
 Login
Login

Documentation 1

Reference material describing how the API behaves

Documentation
Documentation

Agent Surfaces 3

MCP servers, agent skills, and machine-readable catalogs

MCPServer
MCPServer
 LLMsTxt
LLMsTxt
 WellKnown
WellKnown

Design & Contract 2

Pagination, idempotency, versioning, errors, and events

Conventions
Conventions
 Conformance
Conformance

Access & Security 3

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity
 Authentication
Authentication
 OAuthScopes
OAuthScopes

Commercial 3

Pricing, plans, and the legal terms of use

Pricing
Pricing
 TermsOfService
TermsOfService
 PrivacyPolicy
PrivacyPolicy

Company 1

The organization behind the API

Website
Website

Other 2

Properties that don't map to a standard resource type

RefundPolicy
RefundPolicy
 ShippingPolicy
ShippingPolicy

Source (apis.yml)

apis.yml Raw ↑ 
aid: flaviar
name: Flaviar
description: 'Flaviar is an online spirits retailer and members club for whiskey, tequila, rum, gin and other premium spirits,
  offering curated tasting boxes, full-size bottles, and a subscription membership. Its direct-to-consumer storefront runs
  on Shopify and exposes a modern agent-commerce surface: a Universal Commerce Protocol (UCP) merchant profile and hosted
  MCP shopping endpoint, an llms.txt / agents.md agent-instruction document, and Shopify Customer Account authentication via
  OAuth 2.0 + OpenID Connect. This profile was added to the API Evangelist network as a portfolio lead and enriched from Flaviar''s
  live public discovery documents.'
url: https://raw.githubusercontent.com/api-evangelist/flaviar/refs/heads/main/apis.yml
x-type: company
x-source: vc-portfolio
x-backed-by:
- speedinvest
- y-combinator
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'
image: https://flaviar.com/cdn/shop/files/image_29.png?v=1694778656
tags:
- Company
- Spirits
- Whiskey
- Ecommerce
- Retail
- Beverages
- Subscription
- Agent Commerce
- Shopify
apis:
- name: Flaviar Agent Commerce (UCP + MCP)
  description: 'Flaviar''s Shopify storefront exposes an agent-driven commerce surface built on the Universal Commerce Protocol
    (ucp.dev): a discovery document at /.well-known/ucp and a hosted MCP endpoint for catalog search, cart, and buyer-approved
    checkout, alongside Shopify''s Customer Account GraphQL and MCP APIs behind OAuth 2.0 / OpenID Connect.'
  humanURL: https://flaviar.com/llms.txt
  baseURL: https://flaviar.com
  tags:
  - Agent Commerce
  - MCP
  - Ecommerce
  - Spirits
  properties:
  - url: https://flaviar.com/llms.txt
    type: LLMsTxt
  - url: llms/flaviar-llms.txt
    type: LLMsTxt
  - url: mcp/flaviar-mcp.yml
    type: MCPServer
  - url: well-known/flaviar-well-known.yml
    type: WellKnown
  - url: well-known/flaviar-ucp.json
    type: APICatalog
  - url: authentication/flaviar-authentication.yml
    type: Authentication
  - url: scopes/flaviar-scopes.yml
    type: OAuthScopes
  - url: conventions/flaviar-conventions.yml
    type: Conventions
  - url: conformance/flaviar-conformance.yml
    type: Conformance
common:
- type: DomainSecurity
  url: security/flaviar-domain-security.yml
- url: https://flaviar.com
  type: Website
- url: https://flaviar.com/llms.txt
  type: Documentation
- url: https://flaviar.com/account/login
  type: SignUp
- url: https://flaviar.com/account/login
  type: Login
- url: https://flaviar.com/pages/flaviar-black-membership
  type: Pricing
- url: https://flaviar.com/policies/terms-of-service
  type: TermsOfService
- url: https://flaviar.com/policies/privacy-policy
  type: PrivacyPolicy
- url: https://flaviar.com/policies/refund-policy
  type: RefundPolicy
- url: https://flaviar.com/policies/shipping-policy
  type: ShippingPolicy
- url: mcp/flaviar-mcp.yml
  type: MCPServer
- url: llms/flaviar-llms.txt
  type: LLMsTxt
- url: well-known/flaviar-well-known.yml
  type: WellKnown
- url: authentication/flaviar-authentication.yml
  type: Authentication
- url: scopes/flaviar-scopes.yml
  type: OAuthScopes
- url: conventions/flaviar-conventions.yml
  type: Conventions
- url: conformance/flaviar-conformance.yml
  type: Conformance
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
x-enrichment:
  date: '2026-07-19'
  status: backfilled
  pass: local-v1
  note: backfilled from .gitignore signal + verified work evidence