Log inSubmit server
Fatenava MCP logo

Fatenava MCP

Cast deterministic BaZi, Zi Wei Dou Shu, and Western natal charts from an MCP-compatible AI client.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Fatenava MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "fatenava-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "fatenava-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 1 tools correctly (4d ago).

Overview

The fatenava-mcp MCP server connects MCP-capable AI agents to FateNava’s free chart API for BaZi, Zi Wei Dou Shu, and Western astrology calculations. Its single `cast_chart` tool accepts either a multilingual birth description or structured date, time, location, and gender fields, then returns structured chart data. Calculations are deterministic and use True Solar Time for BaZi; no account or API key is required, and the API stores nothing. Reach for it when an agent needs computed natal-chart data rather than AI-generated interpretations.

Use cases

  • Calculate BaZi charts from multilingual birth descriptions
  • Generate Zi Wei Dou Shu palace data for an agent workflow
  • Compare selected Western astrology and Chinese chart systems
  • Handle births with unknown times without inventing an hour

Key features

  • Deterministic BaZi, Zi Wei Dou Shu, and Western chart calculations
  • One-line multilingual or structured birth inputs
  • True Solar Time correction for BaZi
  • Selective chart-system responses
  • No account or API key required

Tools1

What Fatenava MCP lets your agent do. Expand a tool for its parameters.

Verified live~594 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

10/10 checks healthy over the last 53d

What it can do

From the 1 tool this server returned when we ran it.

Read-only tools · 1
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age66 days
Maintainers1

Observed 2026-10-31 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 12d ago via OSV.dev · fatenava-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads169Package downloads in the last 30 days.
Last commit2mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed1Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Fatenava MCP works

What fatenava-mcp does

The fatenava-mcp MCP server gives an AI agent one tool, cast_chart, for calculating three kinds of natal charts from birth information:

  • BaZi, also called the Four Pillars of Destiny, including stems and branches, the Day Master, and Five-Elements distribution.
  • Zi Wei Dou Shu, including the twelve palaces, major stars, Life Palace, and transformations.
  • Western astrology using the tropical zodiac and Placidus houses, with the Ascendant, planets by sign and house, elements, and modalities.

The calculations come from FateNava’s free chart API. Results are structured rather than prose interpretations, so an agent can translate native Chinese terms, explain the fields, or build a downstream response. The same birth input produces the same chart data because the calculations are deterministic.

How it works

The cast_chart tool supports two input styles. A one-line text value can contain the birth date, time, place, and gender, such as 1995-08-10 12:00 Taipei female. The API parses the text, resolves a city name to coordinates and a time zone, and accepts city names in English, Chinese, Japanese, or Korean.

Structured input instead supplies numeric date and time fields, gender, longitude, latitude, and an IANA time-zone identifier such as Asia/Taipei. An optional systems array limits the response to bazi, ziwei, or astro; if omitted, all three systems are returned.

BaZi applies a True Solar Time correction based on the birthplace longitude. If the exact birth hour is unknown, set birthTimeKnown to false. The service returns three BaZi pillars and omits calculations that depend on the missing hour instead of creating an estimated value.

Setup and configuration

The fatenava-mcp MCP server runs over standard input and output. With Node.js and npm available, an MCP client can launch it with npx -y fatenava-mcp. Claude Code uses claude mcp add fatenava -- npx -y fatenava-mcp; Codex CLI can define the same command in its MCP server configuration; Cursor and other compatible clients can use a server entry with command set to npx and args set to ["-y", "fatenava-mcp"].

There is no account, API key, or required environment variable. FATENAVA_API_BASE is optional and changes the API origin, which is useful for testing. For local development, install dependencies with npm install, build with npm run build, and start node dist/index.js.

Tools and capabilities

The server exposes one MCP tool:

  • cast_chart: Calculates one or more of the supported chart systems from a single birth input.

Responses include the interpreted birth details, whether the time was known, and a charts object containing successful results for the selected systems. Field names are in English, while traditional stems, branches, palace names, and star names may appear in their original Chinese characters.

Limitations and notes

The fatenava-mcp MCP server calculates chart data but does not provide a separate interpretation tool. An agent must explain the returned values, or users can use FateNava’s reading tools separately. Unknown birth times reduce the available output, particularly for hour-dependent calculations.

Its charts represent tendencies and themes rather than fixed outcomes, and the results are not medical, legal, or financial advice. The underlying endpoint is dependent on the configured API origin; FATENAVA_API_BASE can replace the default origin for testing.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Fatenava MCP

fatenava-mcp is an MCP server that connects AI agents to FateNava’s free chart API. Its main `cast_chart` tool calculates deterministic BaZi, Zi Wei Dou Shu, and Western astrology natal charts from a birth date, time, place, and gender, without requiring an account or API key.

Run it with `npx -y fatenava-mcp` from an MCP client configuration. Claude Code uses `claude mcp add fatenava -- npx -y fatenava-mcp`; Cursor and other compatible clients can configure `npx` with `-y` and `fatenava-mcp` as arguments.

Yes, fatenava-mcp works with Cursor through a standard MCP server entry. Configure the server command as `npx` and pass `-y` and `fatenava-mcp` as arguments.

Yes, set `birthTimeKnown` to `false`. BaZi still returns three pillars, while calculations that depend on the missing hour are omitted instead of being guessed.

It supports either one-line birth text or structured fields. Text can include the date, time, place, and gender; structured input uses numeric date and time values, gender, coordinates, and a time-zone ID. City names may be English, Chinese, Japanese, or Korean.

Related MCP servers

All in Spirituality & Esoterica All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewFatenava MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/fatenava-mcp?style=directory)](https://allmcps.com/mcp/fatenava-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/fatenava-mcp"><img src="https://allmcps.com/api/badge/fatenava-mcp?style=directory" alt="Fatenava MCP on AllMCPs" /></a>