Flying Embers

Flying Embers is a Ventura, California beverage company founded in 2017 by Bill Moses (co-founder of KeVita) that brews USDA-organic hard kombucha, canned cocktails and hard seltzers, sold in retail across the United States and direct-to-consumer from flyingembers.com. It is not a software vendor and runs no developer program, but its Shopify-hosted storefront serves a real, live agent surface from its own domain: a Universal Commerce Protocol (UCP) merchant profile at /.well-known/ucp, an anonymous Model Context Protocol endpoint at /api/ucp/mcp exposing 13 catalog, cart, checkout and order tools with full JSON Schema input contracts, a published /llms.txt and /agents.md carrying agent operating instructions, and OIDC/OAuth 2.0 discovery documents for customer accounts. Payment completion is explicitly gated on contemporaneous human approval and on an idempotency key.

Flying Embers publishes 2 APIs on the APIs.io network. Tagged areas include Company, Commerce, E-Commerce, Retail, and Beverages.

Flying Embers’ developer surface includes documentation, engineering blog, support, authentication, and 21 more developer resources.

🌐 Visit website 📡 Source on GitHub
26.9/100 emerging Agent 35/100 agent ready Full breakdown ↓
scored 2026-08-17 · rubric v0.11.0
2 APIs 1 MCP Servers
CompanyCommerceE-CommerceRetailBeveragesConsumer Packaged GoodsAgentic CommerceMCPShopifyDirect to Consumer

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-17 · rubric v0.11.0
Composite quality — 26.9/100 · emerging
Contract Quality 0.0 / 25
Developer Ergonomics 8.3 / 20
Commercial Clarity 6.8 / 20
Operational Transparency 2.7 / 13
Governance 1.5 / 12
Discoverability 7.6 / 10
Agent readiness — 35/100 · agent ready
Machine-Readable Contract 0 / 18
Agentic Access Contract 0 / 10
MCP Server 12 / 12
Machine-Readable Auth 10 / 10
Idempotency 9 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 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/flying-embers: 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 2

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

Flying Embers Commerce API (UCP over MCP)

Anonymous JSON-RPC 2.0 / Model Context Protocol endpoint implementing the Universal Commerce Protocol shopping service (version 2026-04-08). A tools/list call returns 13 tools w...

Flying Embers Storefront Product JSON

Unauthenticated read-only storefront JSON the merchant documents for agents that only need to read store data: product and collection JSON, product search, and the sitemap. Docu...

MCP Servers 1

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

flying-embers-mcp.yml

MCP SERVER

Pricing Plans 1

Published pricing tiers and plan structures.

Flying Embers Plans Pricing

0 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Flying Embers Rate Limits

1 limits

RATE LIMITS

Security Posture 2

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

Flying Embers Authentication

none/oauth2/openIdConnect · 2 schemes

SECURITY

Flying Embers Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Flying Embers Scopes

4 scopes · authorizationCode

4 scopes

SCOPES

Resources

Get Started 1

Portal, sign-up, and the first successful call

Login
Login

Documentation 1

Reference material describing how the API behaves

Documentation
Documentation

Agent Surfaces 4

MCP servers, agent skills, and machine-readable catalogs

MCPServer
MCPServer
 LLMsTxt
LLMsTxt
 WellKnown
WellKnown
 AgentSkill
AgentSkill

Design & Contract 6

Pagination, idempotency, versioning, errors, and events

Conventions
Conventions
 Idempotency
Idempotency
 Conformance
Conformance
 ErrorCatalog
ErrorCatalog
 Lifecycle
Lifecycle
 DataModel
DataModel

Build 1

SDKs, sample code, and the tooling you integrate with

Packages
Packages

Access & Security 3

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity
 Authentication
Authentication
 OAuthScopes
OAuthScopes

Operate 3

Status, limits, changes, and where to get help

Support
Support
 HelpCenter
HelpCenter
 RateLimits
RateLimits

Commercial 3

Pricing, plans, and the legal terms of use

TermsOfService
TermsOfService
 PrivacyPolicy
PrivacyPolicy
 Plans
Plans

Company 2

The organization behind the API

Website
Website
 Blog
Blog

Other 1

Properties that don't map to a standard resource type

SecondaryMarket
SecondaryMarket

Source (apis.yml)

apis.yml Raw ↑ 
aid: flying-embers
name: Flying Embers
description: 'Flying Embers is a Ventura, California beverage company founded in 2017 by Bill Moses (co-founder of KeVita)
  that brews USDA-organic hard kombucha, canned cocktails and hard seltzers, sold in retail across the United States and direct-to-consumer
  from flyingembers.com. It is not a software vendor and runs no developer program, but its Shopify-hosted storefront serves
  a real, live agent surface from its own domain: a Universal Commerce Protocol (UCP) merchant profile at /.well-known/ucp,
  an anonymous Model Context Protocol endpoint at /api/ucp/mcp exposing 13 catalog, cart, checkout and order tools with full
  JSON Schema input contracts, a published /llms.txt and /agents.md carrying agent operating instructions, and OIDC/OAuth
  2.0 discovery documents for customer accounts. Payment completion is explicitly gated on contemporaneous human approval
  and on an idempotency key.'
image: https://www.flyingembers.com/cdn/shop/files/fe-social-logo.png?v=1692298714
url: https://raw.githubusercontent.com/api-evangelist/flying-embers/refs/heads/main/apis.yml
x-type: company
x-source: harvest:secondary-market
specificationVersion: '0.20'
created: '2026-08-16'
modified: '2026-08-16'
tags:
- Company
- Commerce
- E-Commerce
- Retail
- Beverages
- Consumer Packaged Goods
- Agentic Commerce
- MCP
- Shopify
- Direct to Consumer
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
apis:
- aid: flying-embers-commerce-mcp
  name: Flying Embers Commerce API (UCP over MCP)
  description: Anonymous JSON-RPC 2.0 / Model Context Protocol endpoint implementing the Universal Commerce Protocol shopping
    service (version 2026-04-08). A tools/list call returns 13 tools with JSON Schema input contracts covering catalog search
    and lookup, cart lifecycle, checkout lifecycle and order retrieval. Every call requires an agent profile URI in meta.ucp-agent.profile;
    complete_checkout additionally requires meta.idempotency-key and explicit human approval of payment.
  humanURL: https://www.flyingembers.com/agents.md
  baseURL: https://www.flyingembers.com/api/ucp/mcp
  tags:
  - Commerce
  - MCP
  - Agentic Commerce
  - Checkout
  - Catalog
  properties:
  - type: MCPServer
    url: mcp/flying-embers-mcp.yml
  - type: Documentation
    url: https://www.flyingembers.com/agents.md
- aid: flying-embers-storefront-json
  name: Flying Embers Storefront Product JSON
  description: 'Unauthenticated read-only storefront JSON the merchant documents for agents that only need to read store data:
    product and collection JSON, product search, and the sitemap. Documented in the merchant''s own /llms.txt; robots.txt
    directs agents to the UCP/MCP endpoint for cart and checkout instead.'
  humanURL: https://www.flyingembers.com/llms.txt
  baseURL: https://www.flyingembers.com
  tags:
  - Commerce
  - Catalog
  - Products
  properties:
  - type: LLMsTxt
    url: https://www.flyingembers.com/llms.txt
common:
- type: DomainSecurity
  url: security/flying-embers-domain-security.yml
- type: Website
  url: https://www.flyingembers.com/
- type: Documentation
  url: https://www.flyingembers.com/agents.md
- type: Blog
  url: https://www.flyingembers.com/blogs/news
- type: Support
  url: https://www.flyingembers.com/pages/contact
- type: HelpCenter
  url: https://www.flyingembers.com/pages/faq
- type: Login
  url: https://www.flyingembers.com/account/login
- type: TermsOfService
  url: https://www.flyingembers.com/policies/terms-of-service
- type: PrivacyPolicy
  url: https://www.flyingembers.com/policies/privacy-policy
- type: MCPServer
  url: mcp/flying-embers-mcp.yml
- type: LLMsTxt
  url: llms/flying-embers-llms.txt
- type: WellKnown
  url: well-known/flying-embers-well-known.yml
- type: Authentication
  url: authentication/flying-embers-authentication.yml
- type: OAuthScopes
  url: scopes/flying-embers-scopes.yml
- type: Conventions
  url: conventions/flying-embers-conventions.yml
- type: Idempotency
  url: conventions/flying-embers-conventions.yml
- type: Conformance
  url: conformance/flying-embers-conformance.yml
- type: ErrorCatalog
  url: errors/flying-embers-problem-types.yml
- type: Lifecycle
  url: lifecycle/flying-embers-lifecycle.yml
- type: DataModel
  url: data-model/flying-embers-data-model.yml
- type: RateLimits
  url: rate-limits/flying-embers-rate-limits.yml
- type: Plans
  url: plans/flying-embers-plans-pricing.yml
- type: Packages
  url: packages/flying-embers-packages.yml
- type: AgentSkill
  url: skills/_index.yml
- type: SecondaryMarket
  name: Forge Global listing
  url: https://forgeglobal.com/flying-embers_stock/
x-enrichment:
  date: '2026-08-16'
  status: enriched
  artifacts_added: 23
  pass: local-v1