Hou Tea — Buy Chinese tea via x402 USDC

@jackrain19743

About Hou Tea — Buy Chinese tea via x402 USDC

The first Model Context Protocol server that lets AI agents browse, recommend, compare, and BUY real physical products with USDC stablecoin via the x402 protocol.

#commerce #payments #x402 #usdc #tea #agent-commerce

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "hou-tea": {
      "command": "npx",
      "args": [
        "-y",
        "@hou-tea/mcp-server"
      ],
      "env": {
        "HOU_TEA_AGENT_KEY": "optional-leave-empty-for-public-catalog"
      }
    }
  }
}

Tools

Browse the hou-tea Chinese tea catalog. Returns products with name, price (USD/USDC), images, taste profile, fermentation level, season, and a ready-to-render `card` object. Filter by category, price range, season, or brewing difficulty.

Get curated tea recommendations from a natural-language query. The server parses intent, applies semantic match, and returns ranked products with explanation. Use this whenever the user asks 'recommend me a tea for X' or describes a mood/occasion/use-case.

Get a deep explainer for one product: origin story, brewing guide (water temp, steep time, ratio), health benefits, talking points, cultural context, and cross-sell suggestions. Use after the user shows interest in a specific product.

Side-by-side comparison of 2–4 products across sensory profile, price, brewing difficulty, season, and use-case. Use when the user is choosing between specific candidates.

Filter products by health constraints. Returns only teas safe under the given conditions (e.g. avoid caffeine for insomnia or pregnancy, avoid strong tannins for sensitive stomachs).

Initiate an x402 USDC payment intent for a product. Returns HTTP 402-style payment requirements (recipient address, amount, Base chain network). The agent should then use a wallet MCP (e.g. @coinbase/payments-mcp) to send USDC and complete the order. This tool does NOT sign or send transactions.

Poll the status of a previously created order. Status transitions: pending_payment → confirmed (after on-chain USDC settlement is verified).

Fetch the full hou-tea agent capability descriptor (/.well-known/agent). Useful for discovering the latest API surface, payment recipient address, and supported networks. Call this if other tools behave unexpectedly.

Overview

What is Hou Tea — Buy Chinese tea via x402 USDC?

Hou Tea is an MCP (Model Context Protocol) server that lets AI agents browse, recommend, and buy authentic Chinese tea using USDC via the x402 protocol. It connects to the hou-tea.com agent API and is designed for use with Claude Desktop, Cursor, Cline, Continue, Zed, and any MCP-compatible assistant.

How to use Hou Tea — Buy Chinese tea via x402 USDC?

Install by running npx -y @hou-tea/mcp-server and configure it in your MCP client’s config file (e.g. claude_desktop_config.json for Claude Desktop, ~/.cursor/mcp.json for Cursor). No environment variables are required for basic use. Ask your agent to recommend tea or make a purchase — payment handling requires a separate x402-capable wallet MCP like @coinbase/payments-mcp.

Key features of Hou Tea — Buy Chinese tea via x402 USDC

Browse catalog with filters (category, price, season, difficulty)
Natural-language tea recommendations
Deep product explanations with brewing guides and stories
Initiate x402 USDC payment intents
Poll order status and list past orders
Progressive tool discovery (core + extended tools)
Structured response envelopes with error codes and hand-off hints

Use cases of Hou Tea — Buy Chinese tea via x402 USDC

Let an AI assistant buy tea for you via USDC on Base
Get personalized tea recommendations based on mood or season
Compare multiple teas side-by-side before purchasing
Filter tea options by health conditions (pregnant, insomnia, caffeine sensitive)
Keep a history of your x402 tea orders under one identity

FAQ from Hou Tea — Buy Chinese tea via x402 USDC

What tools does the server expose?

Core tools: hou_tea_browse, hou_tea_recommend, hou_tea_explain, hou_tea_get_payment_requirements, hou_tea_check_order, hou_tea_list_my_orders, and hou_tea_discover_extended. Extended tools (revealed on demand): hou_tea_compare, hou_tea_filter_by_health, and hou_tea_agent_card.

How does payment work?

The server only emits payment intents (recipient + amount on Base chain). Actual USDC transfer and transaction signing are handled by a separate x402-capable wallet MCP such as @coinbase/payments-mcp. The server never holds private keys.

Do I need to configure environment variables?

No configuration is required for

Frequently asked questions

What tools does the server expose?

Core tools: `hou_tea_browse`, `hou_tea_recommend`, `hou_tea_explain`, `hou_tea_get_payment_requirements`, `hou_tea_check_order`, `hou_tea_list_my_orders`, and `hou_tea_discover_extended`. Extended tools (revealed on demand): `hou_tea_compare`, `hou_tea_filter_by_health`, and `hou_tea_agent_card`.

How does payment work?

The server only emits payment intents (recipient + amount on Base chain). Actual USDC transfer and transaction signing are handled by a separate x402-capable wallet MCP such as `@coinbase/payments-mcp`. The server never holds private keys.

Do I need to configure environment variables?

No configuration is required for

Comments

Basic information

More Other MCP servers

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K