jackrain19743/hou-tea-mcp-server

jackrain19743/hou-tea-mcp-server

от jackrain19743
MCP сервер для AI-агентов, позволяющий искать, рекомендовать и покупать настоящий китайский чай с оплатой в USDC через протокол x402. Инструмент предоставляет каталог с фильтрами, сравнение и интег...

@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-contract package. 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
Инструменты были проиндексированы:
hou_tea_browse

[core] Просматривает каталог китайского чая hou-tea. Возвращает товары с названием, ценой (USD/USDC), изображениями, вкусовым профилем, степенью ферментации, сезоном и готовым к рендерингу объектом card.

Параметры
  • categorystring
  • difficultyenum
  • pageinteger
  • per_pageinteger
  • price_maxnumber
  • price_minnumber
  • seasonenum
hou_tea_check_order

[core] Опрашивает статус ранее созданного заказа. Переходы статуса: pending_payment → verifying → confirmed (после ончейн-расчета USDC). Используйте экспоненциальную задержку (~2s, 4s, 8s …, макс ~60s).

Параметры
  • order_idstringобязательный
hou_tea_discover_extended

[meta] Раскрыть расширенные инструменты (compare / health-filter / agent-card), добавив их в tools/list. Опционально отфильтровать по groups или конкретным tools. Вызывайте это, когда шести основных инструментов недостаточно для намерения пользователя. Идемпотентно.

Параметры
  • groupsenum[]

    Reveal all tools in these groups. Default: ['extended'].

  • toolsstring[]

    Reveal a specific subset of extended tools by name.

hou_tea_explain

[core] Возвращает историю происхождения, руководство по завариванию (температура воды, время настаивания, соотношение), полезные свойства для здоровья, темы для обсуждения, культурный контекст и предложения по кросс-продажам для одного продукта.

Параметры
  • skill_idstringобязательный
hou_tea_get_payment_requirements

[core] Инициирует платёжное намерение x402 USDC для товара. Возвращает требования к оплате в стиле HTTP 402 (адрес получателя, сумма, сеть Base chain). Автоматически включает группировку заказов покупателя (register_buyer_list_token или env HOU_TEA_BUYER_LIST_TOKEN). Кошелёк MCP ОБЯЗАН отправить POST с тем же buy_request_body при повторной попытке, а также с заголовком X-Payment.

Параметры
  • product_namestringобязательный
  • quantityinteger
  • unit_pricestringобязательный

    Decimal string e.g. '30.00'

hou_tea_list_my_orders

[core] Выводит список заказов USDC/x402, привязанных к buyer_list_token (возвращается при успешной покупке или хранится в env HOU_TEA_BUYER_LIST_TOKEN). API-ключ мерчанта не требуется.

Параметры
  • buyer_list_tokenstring
  • limitinteger
  • offsetinteger
  • statusstring
hou_tea_recommend

[core] Получает подобранные рекомендации чая из запроса на естественном языке. Возвращает ранжированные продукты с пояснением. Лучшая точка входа, когда пользователь спрашивает «посоветуй мне чай для X» или описывает настроение / повод / сценарий использования.

Параметры
  • budget_maxnumber
  • limitinteger
  • occasionstring
  • querystringобязательный

Похожие MCP-сервера

forgemeshlabs/coinopai-mcp

forgemeshlabs/coinopai-mcp

MCP сервер для AI-агентов, покупающих верифицируемый рыночный контекст Kronos: калиброванные прогнозные диапазоны, риск-статус и аудит решений. Оплата по вызову в USDC на Base через x402. Каждое ре...

JavaScript1
the402ai/mcp-server

the402ai/mcp-server

MCP сервер для маркетплейса the402.ai: AI агенты находят и покупают услуги через x402 микроплатежи на Base, управляют подписками, продают услуги и следят за доходами. Работает в Claude Desktop, Cur...

TypeScript2
cinderwright-ai/cinderwright-api

cinderwright-ai/cinderwright-api

MCP сервер для платежей AI-агентов: автоматически определяет протокол (x402 или L402) и проводит оплату. Агент с USDC вызывает Lightning-сервисы без управления кошельком. Для разработчиков AI-агентов.

JavaScript4
hypeprinter007-stack/anchor-x402-mcp

hypeprinter007-stack/anchor-x402-mcp

MCP-сервер с 14 инструментами для блокчейн-агентов: хеширование, проверка кошельков, декодирование транзакций и анализ. Оплата за вызов через USDC по протоколу x402 — без подписок и API-ключей. Иде...

JavaScript1
lightningfaucet/lightning-wallet-mcp

lightningfaucet/lightning-wallet-mcp

MCP-сервер и CLI, который даёт AI-агентам биткоин-кошелёк на Lightning Network. Поддерживает автоматическую оплату L402 и X402 API, управление бюджетом агентов, вебхуки. Полезен разработчикам, внед...

JavaScript9
gblinproject/GBLIN-MCP

gblinproject/GBLIN-MCP

MCP-сервер для AI-агентов на Base: держите капитал в диверсифицированном индексе GBLIN с Crash-щитом и мгновенно обменивайте на USDC по x402-счетам. Включает 8 инструментов — от проверки состояния ...

JavaScript1
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин