{"schema_version":"agent-card/1.0","name":"Fengshui Tea","description":"","url":"https://hou-tea.com","api_base":"https://hou-tea.com","capabilities":{"payment":{"protocol":"x402","standard":"HTTP 402 Payment Required","networks":["base"],"currency":"USDC","checkout_flow":"agent-native","buy_endpoint":"http://payment-middleware:8003/api/v1/buy","recipient":"0x7c371c008Cb02fA8183C72589E179086d5dc4F84","usdc_contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Standard x402 protocol. POST to /pay/api/v1/buy — returns HTTP 402 with X-Payment-Requirements header. Send USDC on Base chain, retry with X-Payment header containing tx_hash. No browser or human interaction required."},"catalog":true,"recommendation":true,"comparison":true,"bundle_suggestion":true,"constraint_filtering":true,"product_explanation":true,"order_tracking":true,"order_cancellation":true},"authentication":{"type":"api_key","header":"X-Agent-Key","description":"Contact store operator to obtain an Agent API key."},"mcp":{"package":"@hou-tea/mcp-server","version_tag":"next","install":"npx -y @hou-tea/mcp-server@next","npm":"https://www.npmjs.com/package/@hou-tea/mcp-server","transport":"stdio","tools":{"core":["hou_tea_browse","hou_tea_recommend","hou_tea_explain","hou_tea_get_payment_requirements","hou_tea_check_order","hou_tea_list_my_orders","hou_tea_cancel_order","hou_tea_discover_extended"],"extended":["hou_tea_compare","hou_tea_filter_by_health","hou_tea_agent_card"]},"wallet_pairing":{"recommended":"@coinbase/payments-mcp","note":"Hou Tea returns x402 payment requirements; a wallet MCP signs and submits Base USDC payments."}},"agent_ui":{"schema_version":"agent-ui/v1","contract_package":"@hou-tea/agent-ui-contract","contract_version":"0.1.0","npm":"https://www.npmjs.com/package/@hou-tea/agent-ui-contract","docs_url":"https://shop.hou-tea.com/agents","schema_url":"https://shop.hou-tea.com/api/agent-ui-contract","components":[{"name":"TeaRecommendationGrid","resource_uri":"ui://hou-tea/tea-recommendation-grid.html","result_mapping_id":"hou_tea.products","tools":["hou_tea_browse","hou_tea_recommend"]},{"name":"PaymentReviewCard","resource_uri":"ui://hou-tea/payment-review-card.html","result_mapping_id":"hou_tea.payment_review","tools":["hou_tea_get_payment_requirements"]},{"name":"OrderTimeline","resource_uri":"ui://hou-tea/order-timeline.html","result_mapping_id":"hou_tea.orders","tools":["hou_tea_check_order","hou_tea_list_my_orders","hou_tea_cancel_order"]}]},"skills":[{"id":"catalog","name":"Browse Product Catalog","description":"List all active products with full semantic metadata. Filter by category, price range, season, difficulty. Each product includes a `card` object (name, price, image, images[], url, variants) ready to render as a buyer-facing product card.","method":"GET","endpoint":"https://hou-tea.com/api/agent/catalog","parameters":{"store_id":{"type":"string","default":"fengshui"},"category":{"type":"string","example":"green tea"},"price_min":{"type":"number"},"price_max":{"type":"number"},"season":{"type":"string","example":"spring"},"difficulty":{"type":"string","enum":["beginner","intermediate","advanced"]},"page":{"type":"integer","default":1},"per_page":{"type":"integer","default":20}},"product_card_fields":{"card.id":"skill_id — use in create-order","card.name":"English product name","card.name_zh":"Chinese product name","card.tagline":"One-sentence sales pitch","card.price":"USD retail price","card.image":"Primary display image URL","card.images":"Array of up to 6 stable image URLs (permanent CDN / wp-content only)","card.url":"WooCommerce product page URL","card.variants":"Available sizes/options with prices, e.g. [{option:'100g', price:28}, ...]"}},{"id":"recommend","name":"Get Product Recommendations","description":"Semantic recommendation from a natural-language query. Returns ranked products with intent parsing and match reasoning.","method":"POST","endpoint":"https://hou-tea.com/api/agent/recommend","body":{"query":{"type":"string","required":true,"example":"light floral tea for summer afternoon"},"store_id":{"type":"string","default":"fengshui"},"budget_max":{"type":"number","example":40},"occasion":{"type":"string","example":"gift"},"limit":{"type":"integer","default":3}}},{"id":"compare","name":"Compare Products","description":"Side-by-side comparison of 2–4 products across sensory, price, and use-case dimensions.","method":"POST","endpoint":"https://hou-tea.com/api/agent/compare","body":{"skill_ids":{"type":"array","items":"string","required":true},"store_id":{"type":"string","default":"fengshui"}}},{"id":"explain","name":"Explain Product","description":"Full knowledge package: story, brewing guide, health info, talking points, cultural context, and cross-sell suggestions.","method":"GET","endpoint":"https://hou-tea.com/api/agent/explain/{skill_id}","path_params":{"skill_id":{"type":"string","required":true}},"query_params":{"store_id":{"type":"string","default":"fengshui"}}},{"id":"bundle","name":"Find Bundle & Pairings","description":"Return the configured bundle partners and season/element pairings for a product.","method":"POST","endpoint":"https://hou-tea.com/api/agent/bundle","body":{"skill_id":{"type":"string","required":true},"store_id":{"type":"string","default":"fengshui"}}},{"id":"constraints","name":"Filter by Health Constraints","description":"Return only products safe for given conditions (e.g. pregnant, insomnia, children, diabetic).","method":"POST","endpoint":"https://hou-tea.com/api/agent/constraints","body":{"conditions":{"type":"array","items":"string","required":true,"example":["insomnia","pregnant"]},"store_id":{"type":"string","default":"fengshui"},"limit":{"type":"integer","default":10}}},{"id":"buy","name":"Buy Product (Standard x402)","description":"Standard HTTP 402 x402 payment endpoint. POST without X-Payment → 402 + payment requirements. POST with X-Payment (tx_hash) → 200 + order confirmation. Compatible with Coinbase AgentKit and any x402 wallet client.","method":"POST","endpoint":"http://payment-middleware:8003/api/v1/buy","requires_auth":false,"body":{"product_name":{"type":"string","required":true,"description":"Product name from catalog"},"unit_price":{"type":"string","required":true,"description":"Price in USDC e.g. '35.00'"},"quantity":{"type":"integer","default":1},"currency":{"type":"string","default":"usdc"},"fulfillment_mode":{"type":"string","enum":["with_address","defer_address","customer_ref_only"],"optional":true},"shipping":{"type":"object","optional":true,"description":"Structured address when fulfillment_mode=with_address"},"customer_ref":{"type":"string","optional":true},"register_buyer_list_token":{"type":"boolean","default":true,"description":"Issue buyer_list_token on 200 if none supplied"},"buyer_list_token":{"type":"string","optional":true,"description":"Reuse to group orders; list via GET /api/v1/buyer/orders"}},"payment_flow":{"step1":"POST without X-Payment → HTTP 402 + X-Payment-Requirements header","step2":"Send USDC to 'to' address on Base chain, get tx_hash","step3":"POST identical JSON body as step1 + X-Payment: base64({x402Version:1,scheme:'exact',network:'base-mainnet',payload:{tx_hash:'0x...'}})","step4":"HTTP 200 → {status:'confirmed', order_id, buyer_list_token?, fulfillment?}"},"x402_requirements_format":{"x402Version":1,"accepts":[{"scheme":"exact","network":"base-mainnet","maxAmountRequired":"<amount in USDC units, 6 decimals>","to":"0x7c371c008Cb02fA8183C72589E179086d5dc4F84","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}]}},{"id":"order_status","name":"Check Order Status","description":"Poll order status after payment. Status: pending_payment → confirmed.","method":"GET","endpoint":"http://payment-middleware:8003/api/v1/orders/{order_id}","path_params":{"order_id":{"type":"string","required":true}}},{"id":"buyer_orders","name":"List buyer x402 orders","description":"List middleware orders scoped by buyer_list_token (no merchant API key).","method":"GET","endpoint":"http://payment-middleware:8003/api/v1/buyer/orders","headers":{"Authorization":"Bearer <buyer_list_token>"},"query_params":{"status":{"type":"string","optional":true},"limit":{"type":"integer","optional":true},"offset":{"type":"integer","optional":true}}},{"id":"cancel_order","name":"Cancel Order","description":"Cancel a pending or on-hold order. Updates WooCommerce status to 'cancelled' and notifies the x402 payment middleware. Only orders in 'pending' or 'on-hold' status can be cancelled.","method":"POST","endpoint":"https://hou-tea.com/api/agent/orders/{order_id}/cancel","requires_auth":true,"path_params":{"order_id":{"type":"integer","required":true}},"body":{"store_id":{"type":"string","default":"fengshui"},"reason":{"type":"string","optional":true,"description":"Optional cancellation reason"}},"response":{"order_id":"integer","previous_status":"string (original status before cancellation)","current_status":"cancelled","message":"string — human-readable confirmation","x402_intent_id":"string — the linked x402 payment intent"}}],"example_flow":[{"step":1,"action":"GET https://hou-tea.com/api/agent/catalog","note":"Browse products, find product_name and unit_price (in USDC)"},{"step":2,"action":"POST https://hou-tea.com/api/agent/recommend","note":"Optional: natural language recommendation"},{"step":3,"action":"POST http://payment-middleware:8003/api/v1/buy","note":"No X-Payment header → HTTP 402 with X-Payment-Requirements (amount + recipient address)"},{"step":4,"action":"Send USDC on Base chain","note":"Transfer to 0x7c371c008Cb02fA8183C72589E179086d5dc4F84, USDC contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},{"step":5,"action":"POST http://payment-middleware:8003/api/v1/buy  (with X-Payment header)","note":"X-Payment: base64({{x402Version:1,scheme:'exact',network:'base-mainnet',payload:{{tx_hash:'0x...'}}}})"},{"step":6,"action":"HTTP 200 OK","note":"Response: {status: 'confirmed', order_id: 'ord_xxx'} — purchase complete"}],"contact":{"support_email":"","docs_url":""}}