{
  "markdown": "# fatenava-mcp\n\n**English** | [繁體中文](./README.zh-Hant.md) | [简体中文](./README.zh-Hans.md) | [日本語](./README.ja.md) | [한국어](./README.ko.md)\n\n[![fatenava-mcp MCP server](https://glama.ai/mcp/servers/fatenava/fatenava-mcp/badges/score.svg)](https://glama.ai/mcp/servers/fatenava/fatenava-mcp)\n[![smithery badge](https://smithery.ai/badge/fatenava/fatenava-mcp)](https://smithery.ai/servers/fatenava/fatenava-mcp)\n\n**Cast BaZi, Zi Wei Dou Shu, and Western astrology natal charts from any MCP-capable AI agent.**\n\nOne tool, three deterministic engines, zero setup: no account, no API key, nothing stored.\nPowered by the free chart API of [FateNava](https://fatenava.com?utm_source=fatenava-mcp&utm_medium=readme).\n\n## What it does\n\nGive it a birth (date, time, place, gender) and it returns structured chart data from up to three systems:\n\n| System | What you get |\n|---|---|\n| **BaZi 八字** (Four Pillars of Destiny) | Four pillars (stems & branches), Day Master, Five-Elements distribution — computed with **True Solar Time** correction from the birthplace longitude |\n| **Zi Wei Dou Shu 紫微斗數** (Purple Star Astrology) | Twelve palaces with major stars, Life Palace, transformations |\n| **Western natal chart** | Tropical zodiac, Placidus houses: Ascendant, planets by sign/house, elements & modalities |\n\nThe 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](https://fatenava.com?utm_source=fatenava-mcp&utm_medium=readme)).\n\n## Quick start\n\n### Claude Code\n\n```bash\nclaude mcp add fatenava -- npx -y fatenava-mcp\n```\n\n### Codex CLI\n\n```toml\n# ~/.codex/config.toml\n[mcp_servers.fatenava]\ncommand = \"npx\"\nargs = [\"-y\", \"fatenava-mcp\"]\n```\n\n### Cursor / generic MCP client\n\n```json\n{\n  \"mcpServers\": {\n    \"fatenava\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"fatenava-mcp\"]\n    }\n  }\n}\n```\n\n## Tools\n\n- **`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.\n\n### `cast_chart`\n\nTwo ways to describe the birth — pick one:\n\n**1. One-line text** (easiest; the API parses date, time, place and gender, and resolves the city to coordinates + timezone):\n\n```json\n{ \"text\": \"1995-08-10 12:00 Taipei female\" }\n```\n\nCity names in English, Chinese, Japanese, or Korean are accepted.\n\n**2. Structured fields**:\n\n```json\n{\n  \"year\": 1995, \"month\": 8, \"day\": 10, \"hour\": 12, \"minute\": 0,\n  \"gender\": \"female\",\n  \"longitude\": 121.5, \"latitude\": 25.04, \"timeZoneId\": \"Asia/Taipei\"\n}\n```\n\nOptional:\n\n- `systems`: `[\"bazi\", \"ziwei\", \"astro\"]` — pick a subset to keep the response small (default: all three).\n- `birthTimeKnown: false` — when the exact hour is unknown. BaZi still returns three pillars; hour-dependent parts are omitted honestly instead of being guessed.\n\n### Response shape\n\n```jsonc\n{\n  \"birth\": { \"date\": \"1995-08-10\", \"time\": \"12:00\", \"gender\": \"female\", \"place\": \"…\" },\n  \"timeKnown\": true,\n  \"charts\": {\n    \"bazi\":  { \"ok\": true, \"view\": { \"dayMaster\": {…}, \"fourPillars\": […], … } },\n    \"ziwei\": { \"ok\": true, \"view\": { \"palaces\": […], … } },\n    \"astro\": { \"ok\": true, \"view\": { \"ascendant\": {…}, \"bodies\": […], … } }\n  }\n}\n```\n\nField 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.\n\n## Notes & principles\n\n- **Free & anonymous.** The underlying endpoint requires no login and stores nothing.\n- **Deterministic.** Charts are calculated by tested engines; the AI layer only interprets.\n- **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.\n- Learn the concepts: [What is BaZi?](https://fatenava.com/en/articles/what-is-bazi/?utm_source=fatenava-mcp&utm_medium=readme) · [What is a natal chart?](https://fatenava.com/en/articles/what-is-a-natal-chart/?utm_source=fatenava-mcp&utm_medium=readme) · [What is Zi Wei Dou Shu?](https://fatenava.com/en/articles/what-is-ziwei/?utm_source=fatenava-mcp&utm_medium=readme)\n- Full readings, compatibility (synastry / 合婚) and AI Q&A: **[fatenava.com](https://fatenava.com?utm_source=fatenava-mcp&utm_medium=readme)**\n\n## Development\n\n```bash\nnpm install\nnpm run build\nnode dist/index.js   # speaks MCP over stdio\n```\n\n`FATENAVA_API_BASE` env var overrides the API origin (for testing).\n\n## License\n\n[MIT](./LICENSE)\n",
  "bytes": 4641,
  "sha": "51c446e4aaf39ed6531105e019fe7283327bdd073d5c0924c50db70b1db28803",
  "repo_slug": "fatenava/fatenava-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_fatenava_fatenava_mcp_689d65e6/readme"
}