Fatenava Mcp

io.github.fatenavaPublished by GitHub account fatenavav0.1.2Updated Oct 25, 2026

Cast BaZi, Zi Wei Dou Shu, and Western astrology natal charts - deterministic, free, no account.

VerifiedSTDIODesktop onlyLocation & LifestyleAI & ML

Overview

AI-generated overview

A local MCP server that lets an assistant cast BaZi, Zi Wei Dou Shu and Western natal charts from a birth date, time and place.

What you can do
Cast charts from a birth: one tool returns BaZi four pillars, Zi Wei Dou Shu palaces, or a Western natal chart, or a chosen subset of the three, from a one-line birth text or structured date, time, place and gender fields. Handle unknown birth time: when the hour is unknown, hour-dependent parts are omitted rather than guessed. Return structured chart data with English field names and traditional terms in Chinese characters for the assistant to interpret.
When to use it
Useful when someone wants an assistant to compute astrology or Chinese destiny charts from birth details and then explain them, without creating an account or paying for a chart service.
Requirements
Runs locally over stdio, typically started with npx from the npm package, so Node.js and network access to the chart API are needed. No account, API key or environment variables are required; an optional FATENAVA_API_BASE variable overrides the API origin for testing.
Before you install
Birth details (date, time, place, gender) are sent to the provider's remote chart API, so treat them as personal data. The server itself stores nothing and needs no credentials. Output is described as tendencies and themes, not medical, legal or financial advice.

Installation

In SourceWeft

  1. Open Fatenava Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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:

SystemWhat you get
BaZi 八字 (Four Pillars of Destiny)Four pillars (stems & branches), Day Master, Five-Elements distribution — computed with True Solar Time correction from the birthplace longitude
Zi Wei Dou Shu 紫微斗數 (Purple Star Astrology)Twelve palaces with major stars, Life Palace, transformations
Western natal chartTropical zodiac, Placidus houses: Ascendant, planets by sign/house, elements & modalities

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

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

Codex CLI

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

Cursor / generic MCP client

json
{  "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):

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

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

2. Structured fields:

json
{  "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

jsonc
{  "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

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

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

License

MIT

Source: README.md at commit 9d8806f

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts