Fatenava Mcp

fatenava-mcp

English | 繁體中文 | 简体中文 | 日本語 | 한국어

[fatenava-mcp MCP server] [smithery badge]

Cast BaZi, Zi Wei Dou Shu, and Western astrology natal charts from any MCP-capable AI agent.

One tool, three deterministic engines, zero setup: no account, no API key, nothing stored. Powered by the free chart API of FateNava.

What it does

Give it a birth (date, time, place, gender) and it returns structured chart data from up to three systems:

The numbers are computed, not AI-generated — the same birth always produces the same charts. Interpretation is left to your AI agent (or to FateNava's free reading tools).

Quick start

Claude Code

claude mcp add fatenava -- npx -y fatenava-mcp

Codex CLI

# ~/.codex/config.toml[mcp_servers.fatenava]command = "npx"args = ["-y", "fatenava-mcp"]

Cursor / generic MCP client

{  "mcpServers": {    "fatenava": {      "command": "npx",      "args": ["-y", "fatenava-mcp"]    }  }}

Tools

• cast_chart — Cast BaZi (Four Pillars), Zi Wei Dou Shu, and Western astrology natal charts from one birth input. Deterministic computation with True Solar Time correction; supports one-line multilingual birth text or structured fields.

cast_chart

Two ways to describe the birth — pick one:

1. One-line text (easiest; the API parses date, time, place and gender, and resolves the city to coordinates + timezone):

{ "text": "1995-08-10 12:00 Taipei female" }

City names in English, Chinese, Japanese, or Korean are accepted.

2. Structured fields:

{  "year": 1995, "month": 8, "day": 10, "hour": 12, "minute": 0,  "gender": "female",  "longitude": 121.5, "latitude": 25.04, "timeZoneId": "Asia/Taipei"}

Optional:

• systems: ["bazi", "ziwei", "astro"] — pick a subset to keep the response small (default: all three).
• birthTimeKnown: false — when the exact hour is unknown. BaZi still returns three pillars; hour-dependent parts are omitted honestly instead of being guessed.

Response shape

{  "birth": { "date": "1995-08-10", "time": "12:00", "gender": "female", "place": "…" },  "timeKnown": true,  "charts": {    "bazi":  { "ok": true, "view": { "dayMaster": {…}, "fourPillars": […], … } },    "ziwei": { "ok": true, "view": { "palaces": […], … } },    "astro": { "ok": true, "view": { "ascendant": {…}, "bodies": […], … } }  }}

Field names are English; traditional terms (heavenly stems, earthly branches, palace and star names) come in their native Chinese characters — ask your agent to translate them for the user.

Notes & principles

• Free & anonymous. The underlying endpoint requires no login and stores nothing.
• Deterministic. Charts are calculated by tested engines; the AI layer only interprets.
• Honest about limits. Unknown birth time degrades gracefully instead of inventing an hour. Charts describe tendencies and themes — not fixed fate. Not medical, legal, or financial advice.
• Learn the concepts: What is BaZi? · What is a natal chart? · What is Zi Wei Dou Shu?
• Full readings, compatibility (synastry / 合婚) and AI Q&A: fatenava.com

Development

npm installnpm run buildnode dist/index.js   # speaks MCP over stdio

FATENAVA_API_BASE env var overrides the API origin (for testing).

License

MIT