AI-native

The tea API as an MCP server.

Connect Claude Desktop, Cowork, or any MCP client to the Chinese tea encyclopedia — 450 teas across 72 languages, brewing, terroir, chemistry, enrichment and a 2,623-term glossary, exposed as eight tools.

Endpoint server.py REST docs

Hosted — connect by URL no install

Point any MCP client that supports remote (Streamable HTTP) servers at:

https://api.thetea.app/mcp

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

Clients that read remote servers from JSON:

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

Alternative — local Python server

Install the runtime: pip install "mcp[cli]" httpx
Save server.py somewhere, note its absolute path.
Add it to claude_desktop_config.json:

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

A paid key from the pricing page unlocks 7 languages (Pro) or all 72 (Expert / Lifetime).

Tools exposed

search_tea
list_teas
get_tea
get_field
compare_teas
random_tea
glossary
tea_map

Other ways in

The same data is also a plain REST API, an OpenAPI spec for GPT Actions, and an llms.txt Account.