@hou-tea/mcp-server
Agent-app MCP server for hou-tea.com — let your AI agent browse, recommend, and buy authentic Chinese tea with USDC via the x402 protocol.
Designed for Claude Desktop, Cursor, Cline, Continue, Zed, and any Model Context Protocol compatible AI agent.
v0.3.0-beta - server now ships as an agent app layer, not just a tool list: progressive tool discovery (core + extended), strict JSON Schemas, structured response/error envelopes (
ok,data,error,next_action,meta.request_id), stable error codes, explicit hand-off hints to wallet MCPs, and MCP Apps UI metadata backed by the public@hou-tea/agent-ui-contractpackage. See What changed in 0.3.0 below.
What it does
Exposes the hou-tea agent API as MCP tools so your AI assistant can shop on your behalf.
Default tools/list (core + meta) — always visible:
| Tool | What it does |
|---|---|
hou_tea_browse |
List tea catalog with filters (category, price, season, difficulty) |
hou_tea_recommend |
Natural-language recommendations: "warming tea for cold winter nights" |
hou_tea_explain |
Deep dive on one product: brewing guide, story, health info |
hou_tea_get_payment_requirements |
Initiate x402 payment intent (returns recipient + amount; auto register_buyer_list_token / buyer_list_token for buyer order history) |
hou_tea_check_order |
Poll order status after payment |
hou_tea_list_my_orders |
List your x402 orders by buyer_list_token (Bearer; uses HOU_TEA_BUYER_LIST_TOKEN env) |
hou_tea_discover_extended |
Reveal extended tools (compare / health-filter / agent-card) on demand |






