AI-ориентированный

Чайный API как MCP-сервер.

Подключите Claude Desktop, Cowork или любой MCP-клиент к энциклопедии китайского чая — чаи и обзорные статьи на 72 языках: заваривание, терруар, химия, шаги производства, выверенные географические указания и многоязычный глоссарий, — и к справочнику чайных компаний b2btea.com. Инструменты перечислены ниже, живые числа — в llms.txt.

Конечная точка server.py REST-документация

Хостинг — подключение по URL без установки

Направьте любой MCP-клиент с поддержкой удалённых серверов (Streamable HTTP) на:

https://api.thetea.app/mcp

Для платного ключа добавьте заголовок Authorization: Bearer tt_…; без ключа сервер тоже работает, но только на английском.

Клиенты, читающие удалённые серверы из JSON:

{
  "mcpServers": {
    "thetea": {
      "url": "https://api.thetea.app/mcp",
      "headers": { "Authorization": "Bearer tt_your_key" }
    }
  }
}

Клиенты, которые умеют только stdio (некоторые сборки Claude Desktop), подключаются через mcp-remote:

{
  "mcpServers": {
    "thetea": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.thetea.app/mcp",
               "--header", "Authorization: Bearer tt_your_key"]
    }
  }
}

Альтернатива — локальный Python-сервер

Установите зависимости: pip install "mcp[cli]" httpx
Сохраните server.py и запишите абсолютный путь к нему.
Добавьте его в claude_desktop_config.json:

{
  "mcpServers": {
    "thetea": {
      "command": "python3",
      "args": ["/absolute/path/to/server.py"],
      "env": { "THETEA_KEY": "tt_your_paid_key" }
    }
  }
}

Платный ключ со страницы цен открывает 7 языков (Pro) или все 72 (Expert / Lifetime).

Доступные инструменты

Энциклопедия чая

search_tea
get_tea
get_tea_card
preview_tea
get_field
list_teas
compare_teas
random_tea
list_topics
similar_teas
semantic_search
recommend_like
ask_sommelier
tea_map

Справочные данные

glossary
get_term
find_places
tea_families
catalog_meta
list_infusions
get_infusion

Справочник компаний

search_companies
get_company
company_facets
companies_for_tea

get_tea отдаёт карточку чая в Markdown для чтения, get_tea_card — ту же карточку в JSON со всеми полями. catalog_meta перечисляет разделы и коды полей, которые принимает get_field. Тексты, написанные моделью, помечены как машинный черновик.

Справочник чайных компаний

Тот же сервер открывает b2btea.com — справочник чайных компаний мира: фабрики, оптовики, импортёры, экспортёры, чайные дома, рынки и кооперативы. Пятнадцать языков: английский, русский, китайский, немецкий, французский, испанский, итальянский, португальский, японский, корейский, турецкий, арабский, польский, нидерландский и вьетнамский.

search_companies ищет по стране, городу, китайской провинции, типу компании, сорту, доле китайского чая и уровню подтверждения; у каждого результата — ссылка на его страницу на b2btea.com. Страну и тип можно писать ключом или подписью на языке запроса: China, Китай.
get_company отдаёт карточку в том виде, в каком она опубликована на b2btea.com: описание, адрес, телефон, сайт, форма связи, сорта со ссылками на статьи энциклопедии.
company_facets считает компании по странам, типам, сортам и регионам. companies_for_tea ведёт от статьи энциклопедии к компаниям, которые работают с этим чаем. Справочник размечает компании классами чая и десятком известных сортов, поэтому для большинства статей поиск идёт по классу, и ответ об этом говорит в поле matched.

Чего там нет: адресов электронной почты, ни в одном поле. Записи собраны из открытых источников и не утверждают, что компания работает сегодня; у каждой указан уровень подтверждения — от сайта, ответившего на живую проверку, до названия, которое упомянул источник. Без ключа поиск отдаёт первые 10 результатов без листания; карточки компаний открыты всегда. REST: /api/v2/companies, /api/v2/company/{slug}, /api/v2/companies/facets.

Другие способы входа

Те же данные доступны как обычный REST API, как спецификация OpenAPI для GPT Actions и как llms.txt. Тариф и расход: кабинет.