White Whale Bazi & Liuyao Engine
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PYTHONPATH | No | Absolute path to the local clone's src directory (e.g. /absolute/path/to/white-whale-bazi/src). Only needed when launching the server via `python3 -m white_whale_bazi.mcp_server`; if the package was installed with `uv tool install --editable .` or `pip install -e .`, the server can be started with the `ww-bazi-mcp` command and no environment variables are required. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Always call calculate_true_solar_bazi or cast_liuyao_hexagram before analyzing Bazi or Liuyao. Never guess sexagenary pillars from raw wall-clock time. Lead with a single clear conclusion, translate luck pillars into Gregorian years and ages, and avoid two-sided hedging disclaimers.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| calculate_true_solar_baziB | Calculate deterministic True Solar Time (Equation of Time + longitude + 1986-1991 PRC DST rollback), minute-precision 24 Solar Terms Four Pillars (Bazi) chart, uncalibrated vs calibrated pillar diff, matched Di Tian Sui (滴天髓) & Qiong Tong Bao Jian (穷通宝鉴) public-domain canons, and anti-hedging output constraints. |
| cast_liuyao_hexagramA | Cast a deterministic Three-Coin Jing Fang Najia (京房纳甲) Liuyao hexagram plate, outputting primary/nuclear/changed hexagrams, Eight-Palace Shi/Ying, Six Relatives, Six Beasts, Fushen (hidden spirits), Day/Month stem-branch Xunkong, and public-domain Zhouyi (周易) hexagram texts. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 2 tools
The two tools target entirely different divination systems: one produces a Bazi (Four Pillars) chart, the other casts a Liuyao hexagram. Their names and descriptions make the boundary unmistakable, so an agent cannot reasonably confuse them.
Both names follow a strict snake_case verb_noun pattern (calculate_true_solar_bazi, cast_liuyao_hexagram), using domain-appropriate verbs. There is no mixing of conventions or casing styles.
Two tools map cleanly onto the server's two advertised engines, each consolidating a large deterministic calculation into one call. The surface is thin, but that reflects the deliberate scope rather than missing structure.
Both tools expose rich, self-contained outputs (pillars, canons, calibrated diff; primary/nuclear/changed hexagrams, six relatives, hidden spirits, Zhouyi texts), covering the core lifecycle of each engine. Minor gaps exist, such as luck-pillar/liunian cycles for Bazi or hexagram lookup/auxiliary reference tools.