Eyakhelwe i-AI

Ithemu API njengeseva ye-MCP.

Xhuma i-Claude Desktop, i-Cowork, noma yiliphi iklayenti le-MCP ku-encyclopedia yetiye laseShayina — amatiye nezindatshana zezihloko ngezilimi ezingu-72 ezinokuphunga, indawo yokutshala, ikhemistri, izigaba zokukhiqiza, izinkomba zendawo yemvelaphi eziqinisekisiwe neglosari yezilimi eziningi — kanye nohlu lwezinkampani zetiye lwe-b2btea.com. Amathuluzi abhalwe ngezansi; izibalo ezibukhoma zikufayela llms.txt.

I-Endpoint server.py Imibhalo ye-REST

Ibanjelwe — xhuma nge-URL akukho ukufaka

Khomba noma iyiphi iklayenti le-MCP elisekela amaseva akude (i-Streamable HTTP) lapha:

https://api.thetea.app/mcp

Add an Authorization: Bearer tt_… header to use a paid key — free works without one (English only).

Amakhasimende afunda amaseva akude kuJSON:

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

Stdio-only clients (some Claude Desktop builds) can bridge with mcp-remote:

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

Okunye — iseva yePython yasendaweni

Install the runtime: pip install "mcp[cli]" httpx
Londoloza server.py kwenye indawo, qaphela umzila wayo ophelele.
Add it to claude_desktop_config.json:

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

Ukhiye okhokhelwayo ovela ikhasi lentengo ivula izilimi ezingu-7 (Pro) noma zonke ezingu-72 (Expert / Lifetime).

Amathuluzi avezekile

I-encyclopedia yetiye

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

Okokubhekisela

glossary
get_term
find_places
tea_families
catalog_meta
list_infusions
get_infusion

Uhla lwezinkampani

search_companies
get_company
company_facets
companies_for_tea

get_tea returns Markdown for reading; get_tea_card returns the same card as JSON with every field. catalog_meta lists the section and field codes that get_field accepts. Summaries written by a model are marked as machine drafts.

Uhla lwezinkampani

Iseva efanayo iphinde ivule b2btea.com, uhla lwezinkampani zetiye emhlabeni wonke — amafekthri, abathengisi ngobuningi, abangenisi bempahla, abathumeli bempahla kwamanye amazwe, izindlu zetiye, izimakethe nemifelandawonye — ngezilimi ezingu-15: isiNgisi, isiRashiya, isiShayina, isiJalimane, isiFulentshi, isiSpeyini, isiNtaliyane, isiPutukezi, isiJapane, isiKoriya, isiTheki, isi-Arabhu, isiPolishi, isiDashi nesiVietnam.

search_companies filters by country, city, Chinese province, company type, tea, Chinese-tea focus and evidence level; each result links to its page on b2btea.com.
get_company returns the card as published on b2btea.com: description, address, phone, website, contact form, teas linked to encyclopedia articles.
company_facets counts companies by country, type, tea and region; companies_for_tea goes from an encyclopedia article to the companies that deal in that tea. The directory tags companies by tea class and a few named teas, so for most articles it falls back to the class and says so in matched.

What you will not find there: e-mail addresses, in any field. Entries come from open sources and do not claim that a company operates today; each carries its evidence level, from a website that answered a live check to a name a source mentioned. Without a key a search returns the first 10 results and no paging; company cards are always open. REST: /api/v2/companies, /api/v2/company/{slug}, /api/v2/companies/facets.

Ezinye izindlela zokungena

Idatha efanayo futhi iwumbhalo osobala REST API, i- OpenAPI i-spec ye-GPT Actions, kanye ne- llms.txt. Uhlelo lwakho nokusetshenziswa: I-akhawunti.