Chinese Astrology MCP: BaZi and Zi Wei Inside Claude, Codex, and Cursor

Most astrology in an AI assistant starts with a prompt and ends with a confident paragraph.

There is no chart, no rule, and no way to check how the answer was produced. The model is doing what language models do: producing a plausible sequence of words. It can sound certain about your career, your relationship, or the right month to change jobs without calculating anything.

Liki MCP takes a different route. It gives an AI assistant a set of deterministic tools for Chinese astrology: BaZi, Zi Wei Dou Shu, Liu Yao, Qi Men Dun Jia, Feng Shui, date selection, and Chinese naming. The engine computes the chart and the rule output. The model explains it.

This post explains what that means in practice, how to connect it, and where the limits are.

The problem: a fluent answer is not a calculated answer

Chinese astrology is structural. A BaZi chart depends on the year, month, day, and hour of birth, solar-term boundaries, true solar time, and the relationship between the four pillars. Zi Wei Dou Shu adds twelve palaces, major and minor stars, transformations, and decade cycles.

If an AI assistant does not compute those structures, it can still produce a reading. It just cannot show its work.

That is the gap Liki MCP is built to close. The assistant should not invent a chart, a rule, or a classical source. It should call a tool, receive structured output, and explain that output in plain language.

What the MCP server exposes

Liki MCP exposes deterministic tools rather than one generic “fortune telling” endpoint. The domains include:

  • BaZi / Four Pillars: natal chart, solar terms, true solar time, ten gods, hidden stems, element states, luck cycles, and annual pillars.
  • Zi Wei Dou Shu: twelve palaces, major and minor stars, transformations, and period cycles.
  • Liu Yao: six-line divination with moving lines and relationships.
  • Qi Men Dun Jia: chart structure, doors, stars, and spirits.
  • Feng Shui: directional and environmental analysis.
  • Date selection: Chinese almanac and auspicious timing.
  • Chinese naming: chart-informed name analysis, not sound-alike matching.

The exact tool names and schemas live in the public repository. The point is not the list. The point is that each tool returns facts the assistant can use, instead of asking the model to remember a tradition.

What the assistant receives

A useful MCP response is not a paragraph of prophecy. It is a structured object: chart facts, rule ids, time scope, the factors that fired, and the classical source behind the judgment.

For example, a career reading may include:

  • the natal chart and the year being analyzed,
  • the rule that fired,
  • the factors that activated it,
  • the time window,
  • the source text,
  • and a clear statement when data is missing.

That structure changes the conversation. You can ask “why?” and get an answer that points to a rule and a time scope, not another confident sentence.

Why birth time matters

A chart is only as good as its input. Birth time is the most fragile input in Chinese astrology.

A few minutes can move the hour pillar. An uncertain birth hour can change the chart structure, the day master context, and the reading that follows. Many readings fail not because the tradition has nothing to say, but because the input was wrong from the start.

Liki handles this explicitly. When the birth hour is unclear, it can calibrate against events you already know, and it labels uncertainty instead of hiding it. If the data is missing, the output says so.

Connect it to your AI tool

Liki is available as a Skill and as an MCP server. The Skill is the easiest path for Claude Code, Codex, and Cursor:

npx skills add ml8s/liki

The Skill talks to the hosted charting and counsel engines through MCP-compatible tools. The same engine is available to any MCP host. The public repository and setup notes are at:

https://github.com/ml8s/liki

The server is listed as hk.liki/liki in the Official MCP Registry. You do not need to paste your birth details into a prompt and hope the model computes them. You connect the tool, provide the birth data, and let the engine return the chart.

Example prompts

Once connected, the useful questions are specific:

  • “Cast my BaZi chart from these birth details and explain the day master and element balance.”
  • “Which palaces in my Zi Wei chart are activated in 2027?”
  • “Compare these two dates for a launch, using the Chinese almanac and my chart.”
  • “Calibrate my birth hour against these three life events, and tell me what remains uncertain.”
  • “Suggest names that support the element my chart needs, with the reasoning.”

The assistant should call the relevant tool, not improvise the chart. If it cannot call the tool, it should say so.

What Liki MCP is not

Chinese astrology is a traditional system of interpretation. It is not a scientific prediction engine, and it should not be presented as one.

Liki MCP is also not:

  • a replacement for medical, legal, or financial advice,
  • a guarantee of outcomes,
  • a way to hide uncertainty,
  • an “AI astrologer” that speaks with authority it has not earned.

The engine computes. The model explains. The user can check the reasoning. That is the standard.

FAQ

Is Liki MCP free?

Charting is free. Deeper readings in Liki Chat are paid. Pricing is listed on liki.hk.

Does it work with Claude, Codex, and Cursor?

Yes. Liki is distributed as a Skill and as an MCP server, so it can work with any MCP-compatible host.

Does the model calculate the chart?

No. The engine calculates the chart and the rule output. The model explains the result and can call tools for more detail.

What happens if my birth time is wrong?

Liki can calibrate against known events when the birth hour is uncertain, and it labels what remains undetermined. It does not silently guess.

Where can I check the source?

Each judgment is designed to return its rule id, time scope, factors, and classical source. The public repository documents the tool surface.

Try it

Start with a free chart at liki.hk. If you use Claude Code, Codex, Cursor, or another MCP host, connect Liki Skill and ask a real question.

Liki is launching on Product Hunt on November 17. The demo is on YouTube:

For Astrology, use Liki.

Liki Astrology — Professional Chinese Astrology.
Traditional-practice perspective; not professional advice.