MCP Server

Chinese Astrology MCP Server for AI Agents

Give Claude Code, Codex, Cursor and any MCP host a deterministic Chinese astrology engine: BaZi, Zi Wei, Liu Yao, Qi Men, Feng Shui, date selection and naming — with rules, sources and explicit uncertainty.

What the Liki MCP Server does

Liki exposes its Chinese astrology engine as an MCP server, so an AI assistant can compute a real chart instead of improvising one. The same birth data produces the same chart, including solar-term boundaries, true solar time and luck-cycle timing.

Readings are matched from rule tables and returned with aspects, time scope and classical sources. When the birth hour is uncertain, the engine can calibrate against events you know; when evidence is missing, it says so.

Connect Liki to your AI client

Use the Skill when your client supports Skills. For MCP-native clients, add the server from the Official MCP Registry listing for hk.liki/liki.

Recommended: install the Skill

npx skills add ml8s/liki

The Skill bundles the MCP declaration and works in Claude Code, Codex and other hosts that support Skills. No manual chart setup is required.

View on GitHub

MCP-native clients

If your client manages remote MCP servers directly, find hk.liki/liki in the Official MCP Registry and add it as a streamable HTTP server.

Open the registry listing

Claude Code

Install the Skill once; Claude Code reads the bundled MCP declaration and exposes the charting and counsel tools.

Codex

Install the Skill in the same project or workspace; the assistant can call the same MCP tools without a separate integration.

Cursor & other MCP hosts

Connect the registry server from your client’s MCP settings. The tool surface stays the same across hosts.

What the tools cover

One server exposes the core systems and links each result to the corresponding free web experience.

Example questions

The server asks for missing birth data instead of filling gaps with guesses.

Career timing

My birth details are 1990-05-20 12:00 Beijing. When is the stronger window for a career move this year?

Chart comparison

Compare these two birth charts for a business partnership. Where do the charts reinforce each other, and where do they conflict?

Date selection

Find suitable dates for a move next month, and explain which aspects make each date suitable or risky.

Chinese naming

Suggest Chinese names for a baby born in 2024 with surname Chen, using the chart’s yongshen instead of sound-alike characters.

Why use Liki instead of free-form AI astrology

Liki separates calculation, rule matching and interpretation instead of asking a model to improvise a chart.

Deterministic charts

The same birth data and timezone rules produce the same chart. Solar-term boundaries and true solar time are handled explicitly.

Traceable readings

Judgments come from rule tables with structured aspects, time scope and classical sources, so you can inspect the chain instead of trusting a paragraph.

Explicit uncertainty

Ambiguous birth times trigger calibration. Insufficient evidence is reported as insufficient rather than silently guessed.

Verification and rule coverage

Liki uses calibration and coverage checks to keep the rule chain observable. These are coverage figures, not guarantees of life outcomes.

192

Solar-term boundary cases cross-checked with multiple engines

829

Interpretation rules in the truth table

893

Condition groups

1,355

Condition rows

511

Natal aspects

111

Annual aspects

160

Professional competition questions used for calibration

Frequently asked questions

What is an MCP server?

MCP (Model Context Protocol) is a standard way for AI clients to call external tools. The Liki server gives an assistant access to deterministic charting and rule-based counsel.

Is it free?

The Skill is free to install and use. Charting on liki.hk is free; deep Liki Chat readings are a paid web product.

Do I need an API key?

No API key is required for the Skill path. For MCP-native clients, follow the authentication details on the Official MCP Registry listing.

Which clients are supported?

Claude Code, Codex, Cursor and any MCP-compatible host. The Skill path is the simplest option when your client supports Skills.

Is this a separate product?

No. The MCP server is an integration surface for the same Liki engine, rules and sources used by Liki Astrology.

Does it guarantee outcomes?

No. Liki is a traditional-practice lens for reflection and research, not a promise of life outcomes or a substitute for professional advice.

Source, registry and demos

Review the rules, install path and current registry metadata before connecting.

Give your AI a real chart

Start with the Skill, or connect the MCP server from the registry. Free charting is available on the web.