Bespoken Spirits

Bespoken Spirits is a Lexington, Kentucky beverage-alcohol technology company that uses a patented, data-driven precision maturation process — micro staves plus machine learning over tasting-panel data — to finish whiskey, bourbon and other spirits in days rather than years, and to produce custom private-label and one-of-one barrel expressions for brands, distillers and retailers. Its public technical surface is not a developer program but an agentic-commerce one: the bespokenspirits.com storefront runs on Shopify and publishes an llms.txt, an agents.md, a Universal Commerce Protocol (UCP) discovery document at /.well-known/ucp, and two anonymous, live MCP endpoints that expose catalog search, cart, checkout and order tools to AI shopping agents.

Bespoken Spirits publishes 3 APIs on the APIs.io network. Tagged areas include Company, Spirits, Beverage Alcohol, E-Commerce, and Agentic Commerce.

Bespoken Spirits’ developer surface includes documentation, authentication, code examples, engineering blog, support, pricing, and 23 more developer resources.

🌐 Visit website 📡 Source on GitHub

25.5/100 emerging ▬ flat Agent 37/100 agent ready saas Full breakdown ↓
scored 2026-09-08 · rubric v0.20.0

AccessSelf serve

3 APIs 1 MCP Servers

Company SpiritsBeverage AlcoholE-Commerce Agentic Commerce Universal Commerce Protocol MCP Shopify Retail Manufacturing

Kin Score

Kin Score How this is scored →
scored 2026-09-08 · rubric v0.20.0

Composite quality — 25.5/100 · emerging

Contract Quality 1.7 / 25

Developer Ergonomics 7.1 / 20

Access Clarity 6.3 / 20

Operational Transparency 0.0 / 13

Contract Governance 2.2 / 12

Discoverability 8.2 / 10

Agent readiness — 37/100 · agent ready

Machine-Readable Contract 0 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 0 / 6

MCP Server 12 / 12

Machine-Readable Auth 10 / 10

Idempotency 9 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 7 / 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

Delegated User Identity 6 / 6

Protected Resource Metadata 5 / 5

Registration Without a Human 0 / 6

Agentic Commerce Well-Known Document 5 / 5

Create-or-Update Ergonomics could not be measured. We hold no machine-readable contract for this provider to read, so there is nothing to measure a write surface against. Excluded rather than scored zero: never-measured and measured-empty are different facts. Publishing an OpenAPI is what makes this facet — and several others — scorable at all.

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from github.com/api-evangelist/bespoken-spirits: open an issue to ask a question, or submit a pull request to add artifacts. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

APIs 3

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

Bespoken Spirits UCP Commerce MCP

The Universal Commerce Protocol (UCP) shopping service for the Bespoken Spirits storefront, exposed over MCP as a JSON-RPC 2.0 endpoint. An anonymous tools/list returns 13 tools...

Bespoken Spirits Storefront MCP

The Shopify storefront-renderer MCP endpoint for bespokenspirits.com. An anonymous tools/list returns 5 tools — search_catalog, get_cart, update_cart, search_shop_policies_and_f...

Bespoken Spirits Storefront Catalog JSON

The public, unauthenticated Shopify storefront product JSON surface documented in the store's own llms.txt and agents.md: /products.json for the catalog (30 by default, 47 with ...

MCP Servers 1

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

Bespoken Spirits MCP Server

MCP SERVER

Examples 1

Example request and response payloads for these APIs.

Bespoken Spirits Products Sample

1 fields

EXAMPLE

Security Posture 2

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

Bespoken Spirits Authentication

none/openIdConnect/oauth2 · 4 schemes

SECURITY

Bespoken Spirits Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Bespoken Spirits Scopes

4 scopes · authorizationCode

4 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Bespoken Spirits Agentic Access

18 operations · 8 acting · 1 human-in-the-loop

18 operations · 8 acting

AGENTIC

Resources

Documentation 1

Reference material describing how the API behaves

Documentation

Documentation

Agent Surfaces 5

MCP servers, agent skills, and machine-readable catalogs

LLMsTxt

MCPServer

WellKnown

AgentSkill

AgenticAccess

Design & Contract 6

Pagination, idempotency, versioning, errors, and events

Conventions

Idempotency

ErrorCatalog

Conformance

Lifecycle

DataModel

Build 1

SDKs, sample code, and the tooling you integrate with

Examples

Examples

Access & Security 3

Authentication, authorization, and security posture

Authentication

Authentication

OAuthScopes

OAuthScopes

DomainSecurity

DomainSecurity

Operate 1

Status, limits, changes, and where to get help

Support

Support

Commercial 3

Pricing, plans, and the legal terms of use

Pricing

Pricing

TermsOfService

TermsOfService

PrivacyPolicy

PrivacyPolicy

Company 6

The organization behind the API

Website

Blog

BlogRSS

About

Press

LinkedIn

Other 3

Properties that don't map to a standard resource type

RefundPolicy

RefundPolicy

ShippingPolicy

ShippingPolicy

Sitemap

Sitemap

Source (apis.yml)

aid: bespoken-spirits
name: Bespoken Spirits
description: 'Bespoken Spirits is a Lexington, Kentucky beverage-alcohol technology company that uses a patented, data-driven
  precision maturation process — micro staves plus machine learning over tasting-panel data — to finish whiskey, bourbon and
  other spirits in days rather than years, and to produce custom private-label and one-of-one barrel expressions for brands,
  distillers and retailers. Its public technical surface is not a developer program but an agentic-commerce one: the bespokenspirits.com
  storefront runs on Shopify and publishes an llms.txt, an agents.md, a Universal Commerce Protocol (UCP) discovery document
  at /.well-known/ucp, and two anonymous, live MCP endpoints that expose catalog search, cart, checkout and order tools to
  AI shopping agents.'
deliveryModel:
  model: saas
  open_source: false
  commercial: true
  callable_host: false
  label: Hosted service · you call their endpoint
  confidence: medium
  source:
  - pricing
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: medium
  source:
  - authentication
  - scopes
  - security
  generated: '2026-09-02'
  method: derived
image: https://bespokenspirits.com/cdn/shop/files/HERO_IMAGE_0808cb9f-0b04-48f3-851a-6f6bd2307ad4.png?v=1749075439
url: https://raw.githubusercontent.com/api-evangelist/bespoken-spirits/refs/heads/main/apis.yml
x-type: company
x-source: harvest:secondary-market
specificationVersion: '0.23'
created: '2026-08-07'
modified: '2026-08-07'
tags:
- Company
- Spirits
- Beverage Alcohol
- E-Commerce
- Agentic Commerce
- Universal Commerce Protocol
- MCP
- Shopify
- Retail
- Manufacturing
tags_raw:
- Company
- Spirits
- Beverage Alcohol
- Ecommerce
- Agentic Commerce
- Universal Commerce Protocol
- Model Context Protocol
- Shopify
- Retail
- Manufacturing
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
apis:
- name: Bespoken Spirits UCP Commerce MCP
  description: The Universal Commerce Protocol (UCP) shopping service for the Bespoken Spirits storefront, exposed over MCP
    as a JSON-RPC 2.0 endpoint. An anonymous tools/list returns 13 tools covering catalog search and lookup, cart lifecycle,
    checkout lifecycle and order retrieval. Every tools/call requires a UCP agent profile URI in meta.ucp-agent.profile, and
    complete_checkout additionally requires a meta.idempotency-key. Payment always requires contemporaneous buyer approval.
  humanURL: https://bespokenspirits.com/agents.md
  baseURL: https://bespokenspirits.com/api/ucp/mcp
  tags:
  - Agentic Commerce
  - MCP
  - Universal Commerce Protocol
  - Checkout
  - Catalog
  properties:
  - type: MCPServer
    url: mcp/bespoken-spirits-mcp.yml
  - type: Documentation
    url: https://bespokenspirits.com/agents.md
- name: Bespoken Spirits Storefront MCP
  description: The Shopify storefront-renderer MCP endpoint for bespokenspirits.com. An anonymous tools/list returns 5 tools
    — search_catalog, get_cart, update_cart, search_shop_policies_and_faqs and get_product_details — a narrower, read-and-cart
    surface than the UCP endpoint, with no checkout or order tools.
  humanURL: https://bespokenspirits.com/agents.md
  baseURL: https://bespokenspirits.com/api/mcp
  tags:
  - Agentic Commerce
  - MCP
  - Catalog
  - Shopify
  properties:
  - type: MCPServer
    url: mcp/bespoken-spirits-mcp.yml
- name: Bespoken Spirits Storefront Catalog JSON
  description: 'The public, unauthenticated Shopify storefront product JSON surface documented in the store''s own llms.txt
    and agents.md: /products.json for the catalog (30 by default, 47 with ?limit=250 at probe time), /products/{handle}.json
    for a single product, and /collections/{handle}/products.json for a collection. Read-only, no key required.'
  humanURL: https://bespokenspirits.com/llms.txt
  baseURL: https://bespokenspirits.com/products.json
  tags:
  - Catalog
  - E-Commerce
  - Product
  tags_raw:
  - Catalog
  - Ecommerce
  - Products
  properties:
  - type: Documentation
    url: https://bespokenspirits.com/llms.txt
common:
- type: Website
  url: https://bespokenspirits.com/
- type: Documentation
  url: https://bespokenspirits.com/agents.md
- type: LLMsTxt
  url: llms/bespoken-spirits-llms.txt
- type: MCPServer
  url: mcp/bespoken-spirits-mcp.yml
- type: WellKnown
  url: well-known/bespoken-spirits-well-known.yml
- type: AgentSkill
  url: skills/_index.yml
- type: Authentication
  url: authentication/bespoken-spirits-authentication.yml
- type: OAuthScopes
  url: scopes/bespoken-spirits-scopes.yml
- type: Conventions
  url: conventions/bespoken-spirits-conventions.yml
- type: Idempotency
  url: conventions/bespoken-spirits-conventions.yml
- type: ErrorCatalog
  url: errors/bespoken-spirits-problem-types.yml
- type: Conformance
  url: conformance/bespoken-spirits-conformance.yml
- type: Lifecycle
  url: lifecycle/bespoken-spirits-lifecycle.yml
- type: DataModel
  url: data-model/bespoken-spirits-data-model.yml
- type: AgenticAccess
  url: agentic-access/bespoken-spirits-agentic-access.yml
- type: Examples
  url: examples/bespoken-spirits-products-sample.json
- type: DomainSecurity
  url: security/bespoken-spirits-domain-security.yml
- type: Blog
  url: https://bespokenspirits.com/blogs/news
- type: BlogRSS
  url: https://bespokenspirits.com/blogs/news.atom
- type: Support
  url: https://bespokenspirits.com/pages/contact
- type: Pricing
  url: https://bespokenspirits.com/collections/all
- type: TermsOfService
  url: https://bespokenspirits.com/policies/terms-of-service
- type: PrivacyPolicy
  url: https://bespokenspirits.com/policies/privacy-policy
- type: RefundPolicy
  url: https://bespokenspirits.com/policies/refund-policy
- type: ShippingPolicy
  url: https://bespokenspirits.com/policies/shipping-policy
- type: Sitemap
  url: https://bespokenspirits.com/sitemap.xml
- type: About
  url: https://bespokenspirits.com/pages/our-story
- type: Press
  url: https://bespokenspirits.com/pages/in-the-news
- type: LinkedIn
  url: https://www.linkedin.com/company/bespoken-spirits-inc
x-enrichment:
  date: '2026-08-07'
  status: enriched
  artifacts_added: 23
  pass: local-v1

Work with this as data

Every provider here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this

find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This provider

curl "https://apis.io/api/v1/providers/bespoken-spirits"

All providers

curl "https://apis.io/api/v1/providers?limit=25"

Every operation they expose

curl "https://apis.io/api/v1/providers/bespoken-spirits/operations?limit=25"

How their score was established

curl "https://apis.io/api/v1/providers/bespoken-spirits/evidence"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.