Matchaful

Matchaful is a premium Japanese matcha brand selling single-origin, organically-grown ceremonial matcha from Shizuoka, Japan — ground to order, pesticide-free, and third-party tested under its Farm-to-Whisk program. It sells direct-to-consumer through a Shopify storefront and runs physical cafes, and is a Techstars portfolio company. Matchaful publishes no traditional developer REST API or OpenAPI, but its Shopify storefront exposes a live agent-commerce surface: an /llms.txt and /agents.md agent instruction set, a Universal Commerce Protocol (UCP, ucp.dev) merchant profile at /.well-known/ucp, a first-party MCP shopping endpoint at /api/ucp/mcp, and Shopify Customer Account OIDC/OAuth discovery documents served under the store domain.

Matchaful publishes 1 API on the APIs.io network. Tagged areas include Company, Matcha, Tea, Food and Beverage, and CPG.

Matchaful’s developer surface includes engineering blog, signup flow, support, and 7 more developer resources.

🌐 Visit website 📡 Source on GitHub
20.4/100 emerging ▬ flat Agent 20/100 agent aware Full breakdown ↓
scored 2026-07-27 · rubric v0.5
1 APIs 1 MCP Servers
CompanyMatchaTeaFood and BeverageCPGE-CommerceDirect-to-ConsumerShopifyAgent CommerceUCPMCP

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5
Composite quality — 20.4/100 · emerging
Contract Quality 0.0 / 25
Developer Ergonomics 4.3 / 20
Commercial Clarity 6.8 / 20
Operational Transparency 0.0 / 13
Governance 0.0 / 12
Discoverability 9.3 / 10
Agent readiness — 20/100 · agent aware
Machine-Readable Contract 0 / 18
Agentic Access Contract 0 / 15
MCP Server 12 / 12
Machine-Readable Auth 0 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 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
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/matchaful: 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.

Matchaful Agent Commerce (UCP)

The store's Shopify-provided Universal Commerce Protocol agent-commerce surface — a live MCP shopping endpoint (search_catalog, create_cart, create_checkout, update_checkout, co...

MCP Servers 1

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

matchaful-mcp.yml

MCP SERVER

Resources

Get Started 1

Portal, sign-up, and the first successful call

SignUp
SignUp

Agent Surfaces 4

MCP servers, agent skills, and machine-readable catalogs

WellKnown
WellKnown
 LLMsTxt
LLMsTxt
 MCPServer
MCPServer
 AgentSkill
AgentSkill

Operate 1

Status, limits, changes, and where to get help

Support
Support

Commercial 2

Pricing, plans, and the legal terms of use

TermsOfService
TermsOfService
 PrivacyPolicy
PrivacyPolicy

Company 2

The organization behind the API

Website
Website
 Blog
Blog

Source (apis.yml)

apis.yml Raw ↑ 
aid: matchaful
name: Matchaful
description: 'Matchaful is a premium Japanese matcha brand selling single-origin, organically-grown ceremonial matcha from
  Shizuoka, Japan — ground to order, pesticide-free, and third-party tested under its Farm-to-Whisk program. It sells direct-to-consumer
  through a Shopify storefront and runs physical cafes, and is a Techstars portfolio company. Matchaful publishes no traditional
  developer REST API or OpenAPI, but its Shopify storefront exposes a live agent-commerce surface: an /llms.txt and /agents.md
  agent instruction set, a Universal Commerce Protocol (UCP, ucp.dev) merchant profile at /.well-known/ucp, a first-party
  MCP shopping endpoint at /api/ucp/mcp, and Shopify Customer Account OIDC/OAuth discovery documents served under the store
  domain.'
url: https://raw.githubusercontent.com/api-evangelist/matchaful/refs/heads/main/apis.yml
x-type: company
x-source: vc-portfolio
x-backed-by:
- techstars
x-tier: stub
x-tier-reason: portfolio-lead
accessModel:
  pricing: unknown
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Unknown
  confidence: low
  source: []
  generated: '2026-07-22'
  method: derived
specificationVersion: '0.20'
created: '2026-07-17'
modified: '2026-07-20'
image: https://www.matchaful.com/cdn/shop/files/matchaful-organic-matcha-website-hero.jpg?v=1780489902
tags:
- Company
- Matcha
- Tea
- Food and Beverage
- CPG
- E-Commerce
- Direct-to-Consumer
- Shopify
- Agent Commerce
- UCP
- MCP
apis:
- name: Matchaful Agent Commerce (UCP)
  description: The store's Shopify-provided Universal Commerce Protocol agent-commerce surface — a live MCP shopping endpoint
    (search_catalog, create_cart, create_checkout, update_checkout, complete_checkout) documented in /llms.txt and the UCP
    merchant profile. Checkout requires human buyer approval.
  humanURL: https://www.matchaful.com/llms.txt
  baseURL: https://www.matchaful.com/api/ucp/mcp
  properties:
  - type: MCPServer
    url: mcp/matchaful-mcp.yml
  - type: LLMsTxt
    url: llms/matchaful-llms.txt
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: Website
  url: https://matchaful.com/
- type: Blog
  url: https://www.matchaful.com/blogs/the-matchaful-blog
- type: SignUp
  url: https://www.matchaful.com/account/register
- type: Support
  url: https://www.matchaful.com/pages/contact-us
- type: TermsOfService
  url: https://www.matchaful.com/policies/terms-of-service
- type: PrivacyPolicy
  url: https://www.matchaful.com/policies/privacy-policy
- type: WellKnown
  url: well-known/matchaful-well-known.yml
- type: LLMsTxt
  url: llms/matchaful-llms.txt
- type: MCPServer
  url: mcp/matchaful-mcp.yml
- type: AgentSkill
  url: skills/_index.yml
x-enrichment:
  date: '2026-07-20'
  status: enriched
  artifacts_added: 8
  pass: local-v1