{"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":"https://hou-tea.com/pay/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,"selection_engine":true,"merchant_onboarding":true,"store_builder":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"]}]},"openclaw_plugin":{"package":"@hou-tea/openclaw-store-builder-plugin","version":"0.3.0","install":"npm install @hou-tea/openclaw-store-builder-plugin","env":{"HOU_SELECTION_API_BASE":"https://hou-tea.com","HOU_SELECTION_API_KEY":"<merchant key from /api/merchant/v1/register>"},"tools":["register_merchant","update_merchant_profile","start_selection_run","get_selection_run","list_opportunities","get_opportunity_detail","create_product","list_products","update_product","create_store_site","get_store_site","browse_public_directory","get_public_directory_entry","browse_public_products","get_public_product","create_public_product_order","get_public_product_order","request_payment_approval","get_payment_approval","decide_payment_approval","send_public_agent_message","get_public_agent_message_thread","list_agent_message_inbox","reply_agent_message_thread","list_merchant_orders","update_merchant_product_order","rotate_merchant_api_key"]},"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":"selection_engine","name":"Commerce Selection Engine","description":"Run the external product selection engine: Google Trends, video evidence, product opportunities, supplier candidates, structured product drafts, and data-only site blueprints for agent-side rendering.","method":"POST","endpoint":"https://hou-tea.com/api/selection/v1/runs","requires_auth":true,"auth":{"type":"api_key","header":"X-Selection-Key"},"body":{"theme":{"type":"string","required":true,"example":"portable tea brewer"},"geo":{"type":"string","default":"US"},"language":{"type":"string","default":"en"},"skip_video":{"type":"boolean","default":true},"with_site_blueprint":{"type":"boolean","default":true},"idempotency_key":{"type":"string","optional":true}},"followups":{"run_status":"GET https://hou-tea.com/api/selection/v1/runs/{run_id}","opportunities":"GET https://hou-tea.com/api/selection/v1/runs/{run_id}/opportunities","opportunity_detail":"GET https://hou-tea.com/api/selection/v1/opportunities/{id}"}},{"id":"merchant_onboarding","name":"Register External Merchant","description":"Create a merchant account and one-time API key for OpenClaw store-builder users.","method":"POST","endpoint":"https://hou-tea.com/api/merchant/v1/register","requires_auth":false,"body":{"name":{"type":"string","required":true},"industry":{"type":"string"},"email":{"type":"string","required":true},"target_market":{"type":"string","default":"US"},"payment_address":{"type":"string","required":true,"description":"Merchant EVM wallet address used as the locked x402 USDC recipient."}},"followups":{"profile":"GET https://hou-tea.com/api/merchant/v1/me","update_profile":"PATCH https://hou-tea.com/api/merchant/v1/me","rotate_api_key":"POST https://hou-tea.com/api/merchant/v1/api-key/rotate","auth_header":"X-Selection-Key"}},{"id":"store_builder","name":"Create Store Data Bundle","description":"Create a Product Skill/catalog bundle from selected opportunities or merchant products. The calling OpenClaw owns storefront rendering; set render_mode=hosted_preview only for legacy Hou Tea previews.","method":"POST","endpoint":"https://hou-tea.com/api/store-builder/v1/sites","requires_auth":true,"auth":{"type":"api_key","header":"X-Selection-Key"},"body":{"opportunity_id":{"type":"integer","optional":true},"run_id":{"type":"string","optional":true},"product_ids":{"type":"array","items":"string","optional":true},"include_manual_products":{"type":"boolean","default":false},"site_name":{"type":"string","optional":true},"render_mode":{"type":"string","enum":["data_only","hosted_preview"],"default":"data_only","description":"data_only returns the store bundle for OpenClaw rendering; hosted_preview also writes the legacy /s/ static page."}},"followups":{"site_bundle":"GET https://hou-tea.com/api/store-builder/v1/sites/{site_id}","lead_capture":"POST https://hou-tea.com/api/store-builder/v1/sites/{site_id}/leads","legacy_public_url_pattern":"https://hou-tea.com/s/{tenant_slug}/"}},{"id":"public_merchant_directory","name":"Browse Public Merchant Product Yellow Pages","description":"Public buyer-side yellow pages for OpenClaw merchant stores. Returns each merchant, categories sold, product count, featured products, and public follow-up endpoints.","method":"GET","endpoint":"https://hou-tea.com/api/store-builder/v1/public/directory","requires_auth":false,"parameters":{"category":{"type":"string","optional":true},"limit":{"type":"integer","default":50}},"followups":{"merchant_detail":"GET https://hou-tea.com/api/store-builder/v1/public/directory/{merchant_id}","merchant_products":"GET https://hou-tea.com/api/store-builder/v1/public/products?merchant_id={merchant_id}","message_merchant":"POST https://hou-tea.com/api/store-builder/v1/public/directory/{merchant_id}/messages"}},{"id":"public_merchant_products","name":"Browse Public Merchant Product Skills","description":"Public buyer-side discovery for external merchant products. Returns active Product Skill/catalog data without requiring a merchant management API key.","method":"GET","endpoint":"https://hou-tea.com/api/store-builder/v1/public/products","requires_auth":false,"parameters":{"merchant_id":{"type":"string","optional":true},"category":{"type":"string","optional":true},"limit":{"type":"integer","default":50}},"followups":{"product_detail":"GET https://hou-tea.com/api/store-builder/v1/public/products/{product_id}","create_order":"POST https://hou-tea.com/api/store-builder/v1/public/products/{product_id}/create-order","request_payment_approval":"POST https://hou-tea.com/api/store-builder/v1/public/products/{product_id}/payment-requests","order_status":"GET https://hou-tea.com/api/store-builder/v1/public/orders/{order_id}?access_token={access_token}","merchant_orders":"GET https://hou-tea.com/api/store-builder/v1/orders"}},{"id":"public_payment_approval","name":"Request Buyer Payment Approval","description":"Public buyer-side spend request for agent payments. Creates a pending approval before x402, Stripe Link Agent Wallet, or Alipay checkout details are released.","method":"POST","endpoint":"https://hou-tea.com/api/store-builder/v1/public/products/{product_id}/payment-requests","requires_auth":false,"path_params":{"product_id":{"type":"string","required":true}},"body":{"quantity":{"type":"integer","default":1},"customer_email":{"type":"string","optional":true},"customer_name":{"type":"string","optional":true},"buyer_agent_id":{"type":"string","optional":true},"buyer_contact":{"type":"string","optional":true},"payment_provider":{"type":"string","enum":["x402_usdc_base","stripe_link_agent","alipay"],"default":"x402_usdc_base"},"network":{"type":"string","default":"base"},"variant_label":{"type":"string","optional":true},"max_amount":{"type":"number","optional":true},"currency":{"type":"string","default":"USD"},"expires_in_minutes":{"type":"integer","default":30},"metadata":{"type":"object","optional":true}},"followups":{"approval_status":"GET https://hou-tea.com/api/store-builder/v1/public/payment-requests/{approval_id}?access_token={access_token}","approve":"POST https://hou-tea.com/api/store-builder/v1/public/payment-requests/{approval_id}/approve?access_token={access_token}","reject":"POST https://hou-tea.com/api/store-builder/v1/public/payment-requests/{approval_id}/reject?access_token={access_token}"}},{"id":"public_agent_message","name":"Send Buyer Agent Message To Merchant","description":"Public buyer-side relay for OpenClaw-to-merchant questions. Creates a thread in the merchant inbox and returns thread_id plus access_token for buyer-side polling.","method":"POST","endpoint":"https://hou-tea.com/api/store-builder/v1/public/directory/{merchant_id}/messages","requires_auth":false,"path_params":{"merchant_id":{"type":"string","required":true}},"body":{"subject":{"type":"string","optional":true},"message":{"type":"string","required":true},"buyer_agent_id":{"type":"string","optional":true},"buyer_contact":{"type":"string","optional":true},"product_id":{"type":"string","optional":true},"metadata":{"type":"object","optional":true}},"followups":{"thread_status":"GET https://hou-tea.com/api/store-builder/v1/public/messages/{thread_id}?access_token={access_token}"}},{"id":"merchant_agent_message_inbox","name":"Read Merchant Agent Message Inbox","description":"Merchant-side inbox for buyer OpenClaw questions. Requires the merchant's API key and is tenant-scoped.","method":"GET","endpoint":"https://hou-tea.com/api/store-builder/v1/messages/inbox","requires_auth":true,"auth":{"type":"api_key","header":"X-Selection-Key"},"parameters":{"status":{"type":"string","optional":true},"limit":{"type":"integer","default":50}},"followups":{"reply":"POST https://hou-tea.com/api/store-builder/v1/messages/{thread_id}/reply"}},{"id":"merchant_agent_message_reply","name":"Reply To Buyer Agent Message","description":"Merchant-side reply to a buyer OpenClaw thread. Requires the merchant API key.","method":"POST","endpoint":"https://hou-tea.com/api/store-builder/v1/messages/{thread_id}/reply","requires_auth":true,"auth":{"type":"api_key","header":"X-Selection-Key"},"path_params":{"thread_id":{"type":"string","required":true}},"body":{"message":{"type":"string","required":true},"status":{"type":"string","default":"answered"},"metadata":{"type":"object","optional":true}}},{"id":"public_merchant_product_order","name":"Create Public Merchant Product x402 Order","description":"Buyer-side x402 order creation for a public external-merchant product. The backend locks the payment recipient to the product owner's registered payment_address.","method":"POST","endpoint":"https://hou-tea.com/api/store-builder/v1/public/products/{product_id}/create-order","requires_auth":false,"path_params":{"product_id":{"type":"string","required":true}},"body":{"quantity":{"type":"integer","default":1},"customer_email":{"type":"string","optional":true},"customer_name":{"type":"string","optional":true},"network":{"type":"string","default":"base"},"variant_label":{"type":"string","optional":true}}},{"id":"agent_create_order","name":"Create Hou Tea x402 Order","description":"Preferred Hou Tea purchase flow. Creates a WooCommerce order and linked x402 payment intent from a catalog skill_id.","method":"POST","endpoint":"https://hou-tea.com/api/agent/create-order","requires_auth":true,"body":{"skill_id":{"type":"string","required":true,"description":"Product skill_id from catalog/recommend/explain"},"variant_label":{"type":"string","optional":true,"description":"Variant option label, e.g. 100g"},"quantity":{"type":"integer","default":1},"customer_email":{"type":"string","required":true},"customer_name":{"type":"string","optional":true},"shipping":{"type":"object","optional":true},"fulfillment_mode":{"type":"string","enum":["with_address","defer_address","customer_ref_only"],"optional":true},"register_buyer_list_token":{"type":"boolean","default":true},"buyer_list_token":{"type":"string","optional":true}},"response":{"order_id":"WooCommerce order id","intent_id":"x402 middleware order id; use for /pay/api/v1/payments/verify","x_payment_request":"encoded payment request","payment_details":"recipient, amount, network, expiry","buyer_list_token":"optional buyer order list token"},"followups":{"order_status":"GET https://hou-tea.com/api/agent/orders/{order_id}","verify_payment":"POST https://hou-tea.com/pay/api/v1/payments/verify"}},{"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":"https://hou-tea.com/pay/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 x402 Middleware Order Status","description":"Poll middleware order status after payment. Status: pending_payment → confirmed.","method":"GET","endpoint":"https://hou-tea.com/pay/api/v1/orders/{order_id}","path_params":{"order_id":{"type":"string","required":true}}},{"id":"agent_order_status","name":"Check Hou Tea WooCommerce Order Status","description":"Poll Hou Tea order status and linked x402 payment status by WooCommerce order id.","method":"GET","endpoint":"https://hou-tea.com/api/agent/orders/{order_id}","requires_auth":true,"path_params":{"order_id":{"type":"integer","required":true}},"query_params":{"store_id":{"type":"string","default":"fengshui"}}},{"id":"buyer_orders","name":"List buyer x402 orders","description":"List middleware orders scoped by buyer_list_token (no merchant API key).","method":"GET","endpoint":"https://hou-tea.com/pay/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 skill_id and buyer-facing price"},{"step":2,"action":"POST https://hou-tea.com/api/agent/recommend","note":"Optional: natural language recommendation"},{"step":3,"action":"POST https://hou-tea.com/api/agent/create-order","note":"Create WooCommerce order + x402 intent with {skill_id, customer_email, quantity}"},{"step":4,"action":"Send USDC on Base chain","note":"Transfer to 0x7c371c008Cb02fA8183C72589E179086d5dc4F84, USDC contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},{"step":5,"action":"POST https://hou-tea.com/pay/api/v1/payments/verify","note":"Verify {order_id: intent_id, tx_hash: '0x...'}"},{"step":6,"action":"GET https://hou-tea.com/api/agent/orders/{order_id}","note":"Poll WooCommerce order status and linked x402 payment status"}],"contact":{"support_email":"","docs_url":""}}