Beekeeper's Naturals

Beekeeper's Naturals is a direct-to-consumer bee-derived wellness and supplement brand founded in 2017 by Carly Stein Kremer, selling propolis throat sprays, B.LXR royal-jelly brain fuel, superfood honey, bee pollen and kids' immunity products through beekeepersnaturals.com and retail partners. The company has no traditional developer program, but its Shopify-hosted storefront publishes a genuine machine-readable agent surface: a Universal Commerce Protocol (UCP) merchant profile at /.well-known/ucp, a live MCP endpoint at /api/ucp/mcp implementing the UCP Shopping service (catalog search, cart, checkout, order), an agent instruction document at /agents.md mirrored to /llms.txt, an agentic-discovery sitemap, OIDC/OAuth discovery for Shopify customer accounts, and read-only storefront product/collection JSON endpoints.

Beekeeper’s Naturals publishes 2 APIs on the APIs.io network. Tagged areas include Company, Retail, E-Commerce, Consumer Packaged Goods, and Health and Wellness.

Beekeeper’s Naturals’ developer surface includes documentation, API reference, getting-started guide, support, engineering blog, pricing, signup flow, and 15 more developer resources.

🌐 Visit website 📡 Source on GitHub
30.9/100 thin ▬ flat Agent 25/100 agent aware Full breakdown ↓
scored 2026-08-05 · rubric v0.9.1
2 APIs 1 MCP Servers
CompanyRetailE-CommerceConsumer Packaged GoodsHealth and WellnessSupplementsShopifyAgentic CommerceUniversal Commerce ProtocolModel Context Protocol

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-05 · rubric v0.9.1
Composite quality — 30.9/100 · thin
Contract Quality 0.0 / 25
Developer Ergonomics 11.7 / 20
Commercial Clarity 8.9 / 20
Operational Transparency 0.0 / 13
Governance 1.5 / 12
Discoverability 8.7 / 10
Agent readiness — 25/100 · agent aware
Machine-Readable Contract 0 / 18
Agentic Access Contract 0 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 9 / 9
Stable Error Semantics 8 / 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
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/beekeepers-naturals: 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.

Beekeeper's Naturals UCP Shopping MCP API

Agent-facing commerce API for the Beekeeper's Naturals storefront, exposed over the Model Context Protocol as the Universal Commerce Protocol (UCP) Shopping service. The endpoin...

Beekeeper's Naturals Storefront Product JSON

Read-only JSON representations of the Beekeeper's Naturals storefront catalog, documented by the store's own agent instructions: product detail at /products/{handle}.json and co...

MCP Servers 1

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

beekeepers-naturals-mcp.yml

MCP SERVER

Security Posture 2

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

Beekeepers Naturals Authentication

openIdConnect/oauth2/none · 3 schemes

SECURITY

Beekeepers Naturals Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Beekeepers Naturals Scopes

4 scopes · authorizationCode

4 scopes

SCOPES

Resources

Get Started 3

Portal, sign-up, and the first successful call

DeveloperPortal
DeveloperPortal
 GettingStarted
GettingStarted
 SignUp
SignUp

Documentation 2

Reference material describing how the API behaves

Documentation
Documentation
 APIReference
APIReference

Agent Surfaces 3

MCP servers, agent skills, and machine-readable catalogs

LLMsTxt
LLMsTxt
 WellKnown
WellKnown
 AgentSkill
AgentSkill

Design & Contract 5

Pagination, idempotency, versioning, errors, and events

Conventions
Conventions
 Idempotency
Idempotency
 ErrorCatalog
ErrorCatalog
 Conformance
Conformance
 Lifecycle
Lifecycle

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 2

The organization behind the API

Website
Website
 Blog
Blog

Source (apis.yml)

apis.yml Raw ↑ 
aid: beekeepers-naturals
name: Beekeeper's Naturals
description: 'Beekeeper''s Naturals is a direct-to-consumer bee-derived wellness and supplement brand founded in 2017 by Carly
  Stein Kremer, selling propolis throat sprays, B.LXR royal-jelly brain fuel, superfood honey, bee pollen and kids'' immunity
  products through beekeepersnaturals.com and retail partners. The company has no traditional developer program, but its Shopify-hosted
  storefront publishes a genuine machine-readable agent surface: a Universal Commerce Protocol (UCP) merchant profile at /.well-known/ucp,
  a live MCP endpoint at /api/ucp/mcp implementing the UCP Shopping service (catalog search, cart, checkout, order), an agent
  instruction document at /agents.md mirrored to /llms.txt, an agentic-discovery sitemap, OIDC/OAuth discovery for Shopify
  customer accounts, and read-only storefront product/collection JSON endpoints.'
url: https://raw.githubusercontent.com/api-evangelist/beekeepers-naturals/refs/heads/main/apis.yml
image: https://www.beekeepersnaturals.com/cdn/shop/files/BestSeller-1200x630.webp?v=1776441784
x-type: company
x-source: harvest:secondary-market
x-tier: profiled
x-tier-reason: enrichment pipeline local-v1
specificationVersion: '0.20'
created: '2026-08-02'
modified: '2026-08-02'
tags:
- Company
- Retail
- E-Commerce
- Consumer Packaged Goods
- Health and Wellness
- Supplements
- Shopify
- Agentic Commerce
- Universal Commerce Protocol
- Model Context Protocol
apis:
- aid: beekeepers-naturals-ucp-shopping-mcp
  name: Beekeeper's Naturals UCP Shopping MCP API
  description: Agent-facing commerce API for the Beekeeper's Naturals storefront, exposed over the Model Context Protocol
    as the Universal Commerce Protocol (UCP) Shopping service. The endpoint is advertised by the store's own /.well-known/ucp
    merchant profile and /agents.md, and implements catalog search and lookup, cart create/get/update/cancel, checkout create/get/update/complete/cancel,
    and order retrieval. Requests must carry a UCP-Agent profile; checkout completion requires explicit contemporaneous buyer
    approval and an idempotency key.
  humanURL: https://www.beekeepersnaturals.com/agents.md
  baseURL: https://www.beekeepersnaturals.com/api/ucp/mcp
  tags:
  - Agentic Commerce
  - MCP
  - Checkout
  - Catalog
  properties:
  - type: MCPServer
    url: mcp/beekeepers-naturals-mcp.yml
  - type: ToolCrosswalk
    url: mcp/beekeepers-naturals-tool-crosswalk.yml
- aid: beekeepers-naturals-storefront-json
  name: Beekeeper's Naturals Storefront Product JSON
  description: 'Read-only JSON representations of the Beekeeper''s Naturals storefront catalog, documented by the store''s
    own agent instructions: product detail at /products/{handle}.json and collection listings at /collections/{handle}/products.json.
    No authentication is required. Shopify''s standard storefront JSON surface, published by this merchant for agents that
    only need to read catalog data without transacting.'
  humanURL: https://www.beekeepersnaturals.com/collections/all
  baseURL: https://www.beekeepersnaturals.com
  tags:
  - Catalog
  - Products
  - E-Commerce
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: Website
  url: https://www.beekeepersnaturals.com/
- type: DeveloperPortal
  url: https://www.beekeepersnaturals.com/agents.md
- type: Documentation
  url: https://www.beekeepersnaturals.com/agents.md
- type: APIReference
  url: https://ucp.dev/2026-04-08/services/shopping/mcp.openrpc.json
- type: GettingStarted
  url: https://www.beekeepersnaturals.com/agents.md
- type: Support
  url: https://help.beekeepersnaturals.com/en-US
- type: Blog
  url: https://www.beekeepersnaturals.com/blogs/blog
- type: Pricing
  url: https://www.beekeepersnaturals.com/collections/all
- type: SignUp
  url: https://www.beekeepersnaturals.com/account/login
- type: TermsOfService
  url: https://www.beekeepersnaturals.com/policies/terms-of-service
- type: PrivacyPolicy
  url: https://www.beekeepersnaturals.com/policies/privacy-policy
- type: LLMsTxt
  url: llms/beekeepers-naturals-llms.txt
- type: WellKnown
  url: well-known/beekeepers-naturals-well-known.yml
- type: AgentSkill
  url: skills/_index.yml
- type: Authentication
  url: authentication/beekeepers-naturals-authentication.yml
- type: OAuthScopes
  url: scopes/beekeepers-naturals-scopes.yml
- type: Conventions
  url: conventions/beekeepers-naturals-conventions.yml
- type: Idempotency
  url: conventions/beekeepers-naturals-conventions.yml
- type: ErrorCatalog
  url: errors/beekeepers-naturals-problem-types.yml
- type: Conformance
  url: conformance/beekeepers-naturals-conformance.yml
- type: Lifecycle
  url: lifecycle/beekeepers-naturals-lifecycle.yml
- type: DomainSecurity
  url: security/beekeepers-naturals-domain-security.yml
x-enrichment:
  date: '2026-08-02'
  status: enriched
  artifacts_added: 19
  pass: local-v1