AI-native

De tea API als een MCP-server.

Verbind Claude Desktop, Cowork of een andere MCP-client met de Chinese thee-encyclopedie — 450 theesoorten in 72 talen, zetten, terroir, chemie, verrijking en een woordenlijst met 2.623 termen, beschikbaar als acht tools.

Endpoint server.py REST-documentatie

Gehost — verbind via URL geen installatie

Richt elke MCP-client die remote (Streamable HTTP) servers ondersteunt naar:

https://api.thetea.app/mcp

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

Clients die externe servers vanuit JSON uitlezen:

{
  "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"]
    }
  }
}

Alternatief — lokale Python-server

Install the runtime: pip install "mcp[cli]" httpx
Opslaan server.py ergens, noteer het absolute pad.
Add it to claude_desktop_config.json:

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

Een betaalde sleutel van de prijzenpagina ontgrendelt 7 talen (Pro) of alle 72 (Expert / Lifetime).

Beschikbare tools

search_tea
list_teas
get_tea
get_field
compare_teas
random_tea
woordenlijst
tea_map

Andere manieren om binnen te komen

Dezelfde data is ook een platte REST API, een OpenAPI specificatie voor GPT Actions, en een llms.txt.