Hint

Hint Inc. is a San Francisco based beverage company founded in 2005 by Kara Goldin, known for fruit-infused unsweetened water sold in still, sparkling, caffeinated and kids formats across 25+ flavors. A large share of its business is direct-to-consumer through its own storefront at drinkhint.com, which runs on Shopify. Hint publishes no traditional developer program, SDKs or OpenAPI, but the storefront does expose a live, anonymous agent surface: an agents.md / llms.txt agent instruction document, a Universal Commerce Protocol (UCP) merchant profile at /.well-known/ucp, and a Model Context Protocol endpoint at /api/ucp/mcp that answers tools/list with 13 real catalog, cart, checkout and order tools. Checkout explicitly requires contemporaneous human approval before payment.

Hint publishes 1 API on the APIs.io network. Tagged areas include Company, Beverages, Consumer Packaged Goods, E-Commerce, and Direct to Consumer.

Hint’s developer surface includes documentation, support, engineering blog, signup flow, authentication, and 17 more developer resources.

🌐 Visit website 📡 Source on GitHub

22.7/100 emerging ▬ flat Agent 16/100 agent aware saas Full breakdown ↓
scored 2026-09-14 · rubric v0.22.0

1 APIs 1 MCP Servers

Company Beverages Consumer Packaged Goods E-Commerce Direct to Consumer Retail Agentic Commerce MCP Universal Commerce Protocol Shopify

Kin Score

Kin Score How this is scored →
scored 2026-09-14 · rubric v0.22.0

Composite quality — 22.7/100 · emerging

Contract Quality 0.0 / 25

Developer Ergonomics 6.1 / 20

Access Clarity 6.8 / 20

Operational Transparency 0.0 / 13

Contract Governance 2.2 / 12

Discoverability 7.6 / 10

Agent readiness — 16/100 · agent aware

Machine-Readable Contract 0 / 18

Agentic Access Contract 0 / 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 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

Delegated User Identity 0 / 6

Protected Resource Metadata 0 / 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/hint: 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 1

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

Hint Agentic Commerce (UCP / MCP)

The agent-facing commerce surface of the drinkhint.com storefront. Discovery is published at https://www.drinkhint.com/.well-known/ucp (Universal Commerce Protocol merchant prof...

MCP Servers 1

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

Hint Storefront Agentic Commerce MCP

MCP SERVER

Pricing Plans 1

Published pricing tiers and plan structures.

Hint Plans Pricing

0 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Hint Rate Limits

0 limits

RATE LIMITS

Security Posture 2

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

Hint Authentication

2 schemes

SECURITY

Hint Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Hint Scopes

OAuth 2.0 · no documented scopes

0 scopes

SCOPES

Resources

Get Started 1

Portal, sign-up, and the first successful call

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

LLMsTxt

WellKnown

AgentSkill

Design & Contract 6

Pagination, idempotency, versioning, errors, and events

Conventions

Idempotency

ErrorCatalog

Conformance

Lifecycle

DataModel

Access & Security 3

Authentication, authorization, and security posture

DomainSecurity

DomainSecurity

Authentication

Authentication

OAuthScopes

OAuthScopes

Operate 2

Status, limits, changes, and where to get help

Support

Support

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

Source (apis.yml)

aid: hint
name: Hint
description: 'Hint Inc. is a San Francisco based beverage company founded in 2005 by Kara Goldin, known for fruit-infused
  unsweetened water sold in still, sparkling, caffeinated and kids formats across 25+ flavors. A large share of its business
  is direct-to-consumer through its own storefront at drinkhint.com, which runs on Shopify. Hint publishes no traditional
  developer program, SDKs or OpenAPI, but the storefront does expose a live, anonymous agent surface: an agents.md / llms.txt
  agent instruction document, a Universal Commerce Protocol (UCP) merchant profile at /.well-known/ucp, and a Model Context
  Protocol endpoint at /api/ucp/mcp that answers tools/list with 13 real catalog, cart, checkout and order tools. Checkout
  explicitly requires contemporaneous human approval before payment.'
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: unknown
  trial: false
  try_now: false
  public: false
  label: Unknown
  confidence: low
  source:
  - authentication
  - scopes
  - rate-limits
  - security
  generated: '2026-09-03'
  method: derived
image: https://www.drinkhint.com/cdn/shop/files/Logo_Hint-Wordmark-Droplet-Secondary-2_Color.png?v=1762813167
url: https://raw.githubusercontent.com/api-evangelist/hint/refs/heads/main/apis.yml
x-type: company
x-source: harvest:secondary-market
x-tier: profiled
x-tier-reason: agentic-commerce-surface
specificationVersion: '0.20'
created: '2026-08-22'
modified: '2026-08-22'
tags:
- Company
- Beverages
- Consumer Packaged Goods
- E-Commerce
- Direct to Consumer
- Retail
- Agentic Commerce
- MCP
- Universal Commerce Protocol
- Shopify
tags_raw:
- Company
- Beverages
- Consumer Packaged Goods
- Ecommerce
- Direct to Consumer
- Retail
- Agentic Commerce
- Model Context Protocol
- Universal Commerce Protocol
- Shopify
apis:
- name: Hint Agentic Commerce (UCP / MCP)
  description: The agent-facing commerce surface of the drinkhint.com storefront. Discovery is published at https://www.drinkhint.com/.well-known/ucp
    (Universal Commerce Protocol merchant profile, versions 2026-04-08 and 2026-01-23) and the callable surface is a Model
    Context Protocol endpoint at https://www.drinkhint.com/api/ucp/mcp. An anonymous tools/list returns 13 tools covering
    catalog search and lookup, product detail, cart create/update/cancel, checkout create/update/complete/cancel and order
    retrieval. The surface is provided natively by the Shopify platform for this merchant's own catalog and is served from
    Hint's own hosts.
  humanURL: https://www.drinkhint.com/agents.md
  baseURL: https://www.drinkhint.com/api/ucp/mcp
  tags:
  - Agentic Commerce
  - MCP
  - Universal Commerce Protocol
  - E-Commerce
  tags_raw:
  - Agentic Commerce
  - Model Context Protocol
  - Universal Commerce Protocol
  - Ecommerce
  properties:
  - type: MCPServer
    url: mcp/hint-mcp.yml
  - type: LLMsTxt
    url: llms/hint-llms.txt
  - type: DataModel
    url: data-model/hint-data-model.yml
  - type: ErrorCatalog
    url: errors/hint-problem-types.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: DomainSecurity
  url: security/hint-domain-security.yml
- type: Website
  url: https://www.drinkhint.com/
- type: Documentation
  url: https://www.drinkhint.com/agents.md
- type: Support
  url: https://www.drinkhint.com/pages/contact-us
- type: Blog
  url: https://www.drinkhint.com/blogs/news
- type: SignUp
  url: https://www.drinkhint.com/account/login
- type: TermsOfService
  url: https://www.drinkhint.com/policies/terms-of-service
- type: PrivacyPolicy
  url: https://www.drinkhint.com/policies/privacy-policy
- type: MCPServer
  url: mcp/hint-mcp.yml
- type: LLMsTxt
  url: llms/hint-llms.txt
- type: WellKnown
  url: well-known/hint-well-known.yml
- type: Authentication
  url: authentication/hint-authentication.yml
- type: OAuthScopes
  url: scopes/hint-scopes.yml
- type: Conventions
  url: conventions/hint-conventions.yml
- type: Idempotency
  url: conventions/hint-conventions.yml
- type: ErrorCatalog
  url: errors/hint-problem-types.yml
- type: Conformance
  url: conformance/hint-conformance.yml
- type: Lifecycle
  url: lifecycle/hint-lifecycle.yml
- type: RateLimits
  url: rate-limits/hint-rate-limits.yml
- type: Plans
  url: plans/hint-plans-pricing.yml
- type: DataModel
  url: data-model/hint-data-model.yml
- type: AgentSkill
  url: skills/_index.yml
x-enrichment:
  date: '2026-08-22'
  status: enriched
  artifacts_added: 22
  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/hint"

All providers

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

Every operation they expose

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

How their score was established

curl "https://apis.io/api/v1/providers/hint/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.