Skip to main content
Glama
White Whale Bazi & Liuyao Engine

White Whale Bazi & Liuyao Engine

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PYTHONPATHNoAbsolute 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

CapabilityDetails
tools
{
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.7/5.0

Scored across 2 tools

Disambiguation5/5

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.

Naming Consistency5/5

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.

Tool Count4/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues