aid: numi-tea
name: Numi Tea
description: >-
  Numi Tea (Numi Organic Tea) is an Oakland, California social enterprise founded in
  1999 by siblings Ahmed Rahim and Reem Hassani, selling premium organic and Fair
  Trade certified teas and herbal teasans built from real fruits, flowers, herbs and
  spices. It is a consumer packaged-goods company with no developer program, no API
  keys and no developer portal -- but its Shopify storefront at numitea.com serves a
  genuine, live agent-commerce surface: a Universal Commerce Protocol (UCP) MCP
  server at /api/ucp/mcp exposing 13 catalog, cart, checkout and order tools with
  full JSON Schema, a UCP discovery document pinned to protocol version 2026-04-08,
  RFC 8414/9728 OAuth metadata, OpenID Connect discovery on its own account host, and
  a substantive hand-written llms.txt and agents.md instructing AI shopping agents.
  Payment completion is explicitly fenced behind contemporaneous human approval.
url: https://raw.githubusercontent.com/api-evangelist/numi-tea/refs/heads/main/apis.yml
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
image: https://numitea.com/cdn/shop/files/group1200x628.jpg?v=1714413933
x-type: company
x-source: harvest:secondary-market
specificationVersion: '0.20'
created: '2026-08-26'
modified: '2026-08-26'
tags:
- Tea
- Beverages
- Consumer Packaged Goods
- Retail
- E-Commerce
- Organic
- Fair Trade
- Agentic Commerce
- Universal Commerce Protocol
- MCP
- Shopify
tags_raw:
- Tea
- Beverages
- Consumer Packaged Goods
- Retail
- E-Commerce
- Organic
- Fair Trade
- Agentic Commerce
- Universal Commerce Protocol
- Model Context Protocol
- Shopify
apis:
- name: Numi Tea UCP Shopping MCP
  description: >-
    Numi Tea's Universal Commerce Protocol shopping service, exposed over MCP at
    numitea.com/api/ucp/mcp. Thirteen tools cover catalog search and lookup, product
    detail, cart create/update/cancel, checkout create/update/complete/cancel and
    order read. Capability discovery (initialize, tools/list) is anonymous; every
    tools/call requires a customer-account bearer JWT, and every tool additionally
    requires the calling agent to identify itself with a published UCP agent profile
    URI. Provisioned by Shopify for the merchant storefront and served from Numi
    Tea's own domain.
  humanURL: https://numitea.com/agents.md
  baseURL: https://numitea.com/api/ucp/mcp
  tags:
  - Agentic Commerce
  - E-Commerce
  - MCP
  - Universal Commerce Protocol
  tags_raw:
  - Agentic Commerce
  - E-Commerce
  - Model Context Protocol
  - Universal Commerce Protocol
  properties:
  - type: MCPServer
    url: mcp/numi-tea-mcp.yml
  - type: Authentication
    url: authentication/numi-tea-authentication.yml
  - type: OAuthScopes
    url: scopes/numi-tea-scopes.yml
  - type: ErrorCatalog
    url: errors/numi-tea-problem-types.yml
  - type: Conventions
    url: conventions/numi-tea-conventions.yml
  - type: RateLimits
    url: rate-limits/numi-tea-rate-limits.yml
  - type: Lifecycle
    url: lifecycle/numi-tea-lifecycle.yml
  - type: Conformance
    url: conformance/numi-tea-conformance.yml
  - type: Documentation
    url: https://numitea.com/agents.md
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: Website
  url: https://numitea.com/
- type: Documentation
  url: https://numitea.com/agents.md
- type: LLMsTxt
  url: llms/numi-tea-llms.txt
- type: MCPServer
  url: mcp/numi-tea-mcp.yml
- type: WellKnown
  url: well-known/numi-tea-well-known.yml
- type: Authentication
  url: authentication/numi-tea-authentication.yml
- type: OAuthScopes
  url: scopes/numi-tea-scopes.yml
- type: Conformance
  url: conformance/numi-tea-conformance.yml
- type: ErrorCatalog
  url: errors/numi-tea-problem-types.yml
- type: Conventions
  url: conventions/numi-tea-conventions.yml
- type: Lifecycle
  url: lifecycle/numi-tea-lifecycle.yml
- type: RateLimits
  url: rate-limits/numi-tea-rate-limits.yml
- type: Plans
  url: plans/numi-tea-plans-pricing.yml
- type: DomainSecurity
  url: security/numi-tea-domain-security.yml
- type: Support
  url: https://numitea.com/pages/contact
- type: HelpCenter
  url: https://numitea.com/pages/faq
- type: Blog
  url: https://numitea.com/blogs/news
- type: TermsOfService
  url: https://numitea.com/policies/terms-of-service
- type: PrivacyPolicy
  url: https://numitea.com/policies/privacy-policy
- type: SignUp
  url: https://numitea.com/account/login
- type: AgentSkill
  url: skills/_index.yml
- type: AgentSkill
  url: skills/numi-tea-shop-and-checkout.md
- type: AgentSkill
  url: skills/numi-tea-catalog-research.md
x-enrichment:
  date: '2026-08-26'
  status: enriched
  artifacts_added: 23
  pass: local-v1
x-coverage:
  state: covered
  reason: agent-commerce-surface-published
  detail: >-
    Numi Tea has no developer program, but it serves a live Universal Commerce
    Protocol MCP server at numitea.com/api/ucp/mcp whose tools/list returned 13 tools
    with full JSON Schema anonymously, plus llms.txt, agents.md and seven /.well-known
    documents on its own hosts.
  evidence:
    - url: https://numitea.com/api/ucp/mcp
      status: 200
    - url: https://numitea.com/.well-known/ucp
      status: 200
    - url: https://numitea.com/llms.txt
      status: 200
    - url: https://numitea.com/.well-known/oauth-protected-resource
      status: 200
    - url: https://numitea.com/.well-known/agent-card.json
      status: 404
  checked: '2026-08-26'