Status: Production.
When to use: comparing two dates only (
date_a, date_b). For a single date → get_date.One call returns two full date profiles (each the same shape as
get_date — Cosmic card + calendars, moon, season, Rx, and the rest) plus a weighted compatibility score and cross-wheel aspects. Each side’s cosmic.planetary_spread includes spread_pos (1–14) — sort by that field; see get_date → Planetary spread order.
Ask:
How compatible are 1985-03-15 and 1990-11-08?Live payloads are large (~85 KB). Below is a teaching excerpt — Cosmic card A / B profiles abbreviated. Full payload / raw JSON: call this tool — live response is the complete object (no verbosity flag). Chat may summarize; ask for the raw tool result if the UI truncates.
Example response
chinese_zodiac_aspect can also be harmonic_pair (Chinese secret-friend / Liu He pair — not a Western aspect). When that wins, chinese_wheel_aspect still shows the leftover 9027 Western-grid label; chinese_wheel_bonus is returned and not added to overall_score. See What you get → Aspect map.
How scoring works (do one pair by hand)
You can score one pair yourself. Use the MCP tool when you have many dates or many permutations — same math, just faster. Most real pairs have different Cosmic cards. Same-card matches are rare; the first example below shows one on purpose so you can see the same-card line, then a second example shows the usual case.Chinese bonus table (what enters the score)
Only
chinese_zodiac_bonus is summed. If you also see chinese_wheel_aspect / chinese_wheel_bonus, that is a leftover Western-grid label — do not add it.
Example A — Liu He + same Cosmic card (uncommon)
Dates:2029-02-27 × 2024-02-27 (rooster × dragon — Chinese secret-friend / Liu He).
Scored Chinese aspect =
harmonic_pair → chinese_zodiac_bonus = +8.
overall_score 26, chinese_zodiac_aspect harmonic_pair, interpretation deeply_harmonious.
Example B — San He trine + different Cosmic cards (typical)
Dates:2024-03-01 × 2028-06-15 (dragon × monkey — Chinese San He / trine). Cosmic cards differ.
Scored Chinese aspect =
trine → chinese_zodiac_bonus = +13. Wheel leftover is none / 0 (San He has no 9027 Western-grid twin).
overall_score 12, chinese_zodiac_aspect trine, same-card bonus 0.
When to use the tool
The six Liu He pairs: rat–ox · tiger–pig · rabbit–dog · dragon–rooster · snake–monkey · horse–goat.
San He (trine) groups: rat–dragon–monkey · ox–snake–rooster · tiger–horse–dog · rabbit–goat–pig.
Wire names: inputs and
temporal_context use date_a / date_b. Full date profiles are cosmic_card_a / cosmic_card_b. Out-of-range Cosmic-card-only scope uses payload_scope: "cosmic_card_only". Cosmic card = birth = life = sun (cosmic.also_called).