Cirkul

Cirkul, Inc. is a Tampa, Florida direct-to-consumer beverage company founded in 2016 by Garrett Waggoner and Andy Gay. Cirkul sells a reusable bottle system paired with patented flavor cartridges — called Sips — that sit in the bottle lid behind a dial, letting a drinker adjust flavor intensity without pre-mixing. The cartridge lines include LifeSip, FitSip and GoSip, covering more than 100 zero-sugar, zero-calorie flavors spanning fruit blends, iced teas, iced coffees and caffeinated and electrolyte formulations. Cirkul does not publish a general-purpose developer API or an OpenAPI definition; its machine-readable surface is an agent-commerce one, served from its own drinkcirkul.com Shopify storefront: an anonymous Model Context Protocol server at /api/mcp, a Universal Commerce Protocol (UCP) merchant profile at /.well-known/ucp, a UCP shopping MCP endpoint at /api/ucp/mcp, published agent instructions at /agents.md and /llms.txt, and OAuth 2.0 / OpenID Connect discovery for the Shopify Customer Account API.

Cirkul publishes 1 API on the APIs.io network. Tagged areas include Company, Beverages, Consumer Packaged Goods, Direct to Consumer, and Ecommerce.

Cirkul’s developer surface includes documentation, getting-started guide, support, engineering blog, pricing, signup flow, authentication, and 21 more developer resources.

🌐 Visit website 📡 Source on GitHub
29.3/100 thin ▬ flat Agent 28/100 agent aware Full breakdown ↓
scored 2026-08-05 · rubric v0.9.1
1 APIs 1 MCP Servers
CompanyBeveragesConsumer Packaged GoodsDirect to ConsumerEcommerceRetailSubscription CommerceAgentic CommerceModel Context ProtocolUniversal Commerce ProtocolShopifyHydration

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-05 · rubric v0.9.1
Composite quality — 29.3/100 · thin
Contract Quality 0.0 / 25
Developer Ergonomics 9.5 / 20
Commercial Clarity 8.9 / 20
Operational Transparency 0.7 / 13
Governance 1.5 / 12
Discoverability 8.7 / 10
Agent readiness — 28/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 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/cirkul: 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.

Cirkul Storefront Agent API

The agent-facing commerce surface Cirkul serves from its own drinkcirkul.com host. It comprises an anonymous Model Context Protocol (MCP) server at /api/mcp exposing five tools ...

MCP Servers 1

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

cirkul-mcp.yml

MCP SERVER

Security Posture 2

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

Cirkul Authentication

none/oauth2/openIdConnect/ucp-agent-profile · 4 schemes

SECURITY

Cirkul Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Cirkul Scopes

4 scopes · authorizationCode

4 scopes

SCOPES

Resources

Get Started 2

Portal, sign-up, and the first successful call

GettingStarted
GettingStarted
 SignUp
SignUp

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 4

Pagination, idempotency, versioning, errors, and events

Conformance
Conformance
 ErrorCatalog
ErrorCatalog
 Conventions
Conventions
 Lifecycle
Lifecycle

Build 2

SDKs, sample code, and the tooling you integrate with

GitHubOrganization
GitHubOrganization
 ToolCrosswalk
ToolCrosswalk

Access & Security 3

Authentication, authorization, and security posture

Authentication
Authentication
 OAuthScopes
OAuthScopes
 DomainSecurity
DomainSecurity

Operate 2

Status, limits, changes, and where to get help

Support
Support
 HelpCenter
HelpCenter

Commercial 3

Pricing, plans, and the legal terms of use

Pricing
Pricing
 TermsOfService
TermsOfService
 PrivacyPolicy
PrivacyPolicy

Company 4

The organization behind the API

Website
Website
 About
About
 Blog
Blog
 Careers
Careers

Other 3

Properties that don't map to a standard resource type

SecondaryMarket
SecondaryMarket
 StoreLocator
StoreLocator
 Sustainability
Sustainability

Source (apis.yml)

apis.yml Raw ↑ 
aid: cirkul
name: Cirkul
description: 'Cirkul, Inc. is a Tampa, Florida direct-to-consumer beverage company founded in 2016 by Garrett Waggoner and
  Andy Gay. Cirkul sells a reusable bottle system paired with patented flavor cartridges — called Sips — that sit in the bottle
  lid behind a dial, letting a drinker adjust flavor intensity without pre-mixing. The cartridge lines include LifeSip, FitSip
  and GoSip, covering more than 100 zero-sugar, zero-calorie flavors spanning fruit blends, iced teas, iced coffees and caffeinated
  and electrolyte formulations. Cirkul does not publish a general-purpose developer API or an OpenAPI definition; its machine-readable
  surface is an agent-commerce one, served from its own drinkcirkul.com Shopify storefront: an anonymous Model Context Protocol
  server at /api/mcp, a Universal Commerce Protocol (UCP) merchant profile at /.well-known/ucp, a UCP shopping MCP endpoint
  at /api/ucp/mcp, published agent instructions at /agents.md and /llms.txt, and OAuth 2.0 / OpenID Connect discovery for
  the Shopify Customer Account API.'
url: https://raw.githubusercontent.com/api-evangelist/cirkul/refs/heads/main/apis.yml
image: https://drinkcirkul.com/cdn/shop/files/MRKTG_0108_25_Meta_Data_Image_Update-You-got-CirkulArtboard_1.jpg
x-type: company
x-source: harvest:secondary-market
x-tier: profiled
x-tier-reason: enrichment
specificationVersion: '0.20'
created: '2026-08-02'
modified: '2026-08-02'
x-enrichment:
  date: '2026-08-02'
  status: enriched
  artifacts_added: 20
  pass: local-v1
tags:
- Company
- Beverages
- Consumer Packaged Goods
- Direct to Consumer
- Ecommerce
- Retail
- Subscription Commerce
- Agentic Commerce
- Model Context Protocol
- Universal Commerce Protocol
- Shopify
- Hydration
apis:
- aid: cirkul:storefront-agent-api
  name: Cirkul Storefront Agent API
  description: The agent-facing commerce surface Cirkul serves from its own drinkcirkul.com host. It comprises an anonymous
    Model Context Protocol (MCP) server at /api/mcp exposing five tools with real JSON Schema inputs (search_catalog, get_cart,
    update_cart, search_shop_policies_and_faqs, get_product_details), a Universal Commerce Protocol merchant discovery profile
    at /.well-known/ucp declaring cart, checkout, fulfillment, discount, order and catalog capabilities plus Shop Pay, Google
    Pay and card payment handlers, and a UCP shopping MCP endpoint at /api/ucp/mcp whose tools/list is gated behind a UCP
    agent-profile URI. Read-only catalog JSON (products.json, collection products.json) is documented for agents that only
    need to browse. Checkout explicitly requires contemporaneous human buyer approval.
  humanURL: https://drinkcirkul.com/agents.md
  baseURL: https://drinkcirkul.com
  tags:
  - Agentic Commerce
  - Model Context Protocol
  - Universal Commerce Protocol
  - Ecommerce
  - Catalog
  - Cart
  - Checkout
  properties:
  - type: MCPServer
    url: mcp/cirkul-mcp.yml
  - type: ToolCrosswalk
    url: mcp/cirkul-tool-crosswalk.yml
  - type: LLMsTxt
    url: llms/cirkul-llms.txt
  - type: Authentication
    url: authentication/cirkul-authentication.yml
  - type: OAuthScopes
    url: scopes/cirkul-scopes.yml
  - type: ErrorCatalog
    url: errors/cirkul-problem-types.yml
  - type: Conventions
    url: conventions/cirkul-conventions.yml
  - type: AgentSkill
    url: skills/_index.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: Website
  url: https://drinkcirkul.com/
- type: SecondaryMarket
  url: https://forgeglobal.com/cirkul_stock/
- type: About
  url: https://drinkcirkul.com/pages/about
- type: Documentation
  url: https://drinkcirkul.com/agents.md
- type: GettingStarted
  url: https://drinkcirkul.com/pages/getting-started
- type: Support
  url: https://drinkcirkul.com/pages/contact-us
- type: HelpCenter
  url: https://drinkcirkul.com/pages/faq
- type: Blog
  url: https://drinkcirkul.com/blogs/cirkular
- type: GitHubOrganization
  url: https://github.com/drinkcirkul
- type: Pricing
  url: https://drinkcirkul.com/pages/plans
- type: SignUp
  url: https://drinkcirkul.com/account/login
- type: TermsOfService
  url: https://drinkcirkul.com/policies/terms-of-service
- type: PrivacyPolicy
  url: https://drinkcirkul.com/policies/privacy-policy
- type: Careers
  url: https://drinkcirkul.com/pages/careers
- type: StoreLocator
  url: https://drinkcirkul.com/pages/store-locator
- type: Sustainability
  url: https://drinkcirkul.com/pages/recycling
- type: MCPServer
  url: mcp/cirkul-mcp.yml
- type: ToolCrosswalk
  url: mcp/cirkul-tool-crosswalk.yml
- type: LLMsTxt
  url: llms/cirkul-llms.txt
- type: WellKnown
  url: well-known/cirkul-well-known.yml
- type: Authentication
  url: authentication/cirkul-authentication.yml
- type: OAuthScopes
  url: scopes/cirkul-scopes.yml
- type: Conformance
  url: conformance/cirkul-conformance.yml
- type: ErrorCatalog
  url: errors/cirkul-problem-types.yml
- type: Conventions
  url: conventions/cirkul-conventions.yml
- type: Lifecycle
  url: lifecycle/cirkul-lifecycle.yml
- type: DomainSecurity
  url: security/cirkul-domain-security.yml
- type: AgentSkill
  url: skills/_index.yml