Openfate Bazi MCP MCP Server

OpenFate Bazi MCP server with deterministic Four Pillars calculation, True Solar Time, branch interactions, and reverse Bazi lookup.

Local serverstdio

What is the Openfate Bazi MCP MCP server?

OpenFate Bazi MCP server with deterministic Four Pillars calculation, True Solar Time, branch interactions, and reverse Bazi lookup. Exposed over MCP by the openfate bazi mcp mcp server, that capability becomes something an assistant can invoke while it works, not something you go and do afterwards.

What it actually does

OpenFate Bazi MCP is a Model Context Protocol server for accurate Bazi / Four Pillars calculation inside AI agents such as Claude Desktop, Cursor, Cline, and Continue.

  • 24 solar-term boundaries
  • True Solar Time
  • longitude and timezone correction
  • Zi-hour day-boundary rules
  • lunar-to-solar conversion
  • branch interactions

Its toolset

Everything the assistant can do here goes through one of these:

  • calculate_bazi_chart — Best practice: pass longitude plus timezone or timezoneId for professional True Solar Time accuracy
  • detect_bazi_interactions — Detects Earthly Branch interactions for a natal chart, annual trigger, or simple synastry target
  • calculate_true_solar_time — Use this when a user asks why OpenFate's hour pillar differs from a clock-time tool
  • reverse_bazi_to_solar_times — Finds possible Gregorian datetimes for a four-pillar Bazi string
  • get_openfate_bazi_policy — The get_openfate_bazi_policy tool exposed by this server
  • get_openfate_bazi_resources — Returns canonical OpenFate links for charting, readings, compatibility, wealth, true solar time, and llms.txt

Adding it to your client

Installation goes through your MCP client rather than a global install: point it at @openfate/bazi-mcp on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

When to reach for it

Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Openfate Bazi MCP's toolset — calculate_bazi_chart, detect_bazi_interactions, calculate_true_solar_time and 3 more — is a fair guide to whether it matches your workflow. It is maintained by openfate-ai; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Openfate Bazi MCP's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the openfate bazi mcp mcp server does with a few real requests.

Available tools

ToolWhat it does
calculate_bazi_chartBest practice: pass longitude plus timezone or timezoneId for professional True Solar Time accuracy.
detect_bazi_interactionsDetects Earthly Branch interactions for a natal chart, annual trigger, or simple synastry target.
calculate_true_solar_timeUse this when a user asks why OpenFate's hour pillar differs from a clock-time tool.
reverse_bazi_to_solar_timesFinds possible Gregorian datetimes for a four-pillar Bazi string.
get_openfate_bazi_policyThe get_openfate_bazi_policy tool exposed by this server.
get_openfate_bazi_resourcesReturns canonical OpenFate links for charting, readings, compatibility, wealth, true solar time, and llms.txt.

How to install the Openfate Bazi MCP MCP server

## Claude Desktop

```jsonc
{
  "mcpServers": {
    "openfate-bazi": {
      "command": "npx",
      "args": ["-y", "@openfate/bazi-mcp"]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Example prompts to try

  • Use Openfate Bazi MCP to calculate bazi chart.
  • Use Openfate Bazi MCP to detect bazi interactions.
  • Use Openfate Bazi MCP to calculate true solar time.

Frequently asked questions

LLMs should not manually calculate Bazi charts. The difficult parts (solar terms, True Solar Time, timezone corrections, DST, Zi‑hour rules, lunar‑solar conversion, branch interactions) are deterministic and better handled by a dedicated engine.