Log inSubmit server
OpenFate Bazi MCP logo

OpenFate Bazi MCP

Calculates Bazi charts, True Solar Time, Da Yun timing, reverse date candidates, and raw Earthly Branch interactions locally.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install OpenFate Bazi 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": {
    "openfate-bazi-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@openfate/bazi-mcp"
      ]
    }
  }
}

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

Automated check passed— started and listed 6 tools correctly (24d ago).

Overview

OpenFate Bazi MCP MCP server exposes deterministic Bazi and Four Pillars calculations to MCP-compatible AI clients. It wraps the OpenFate Bazi and True Solar Time engines and returns machine-friendly JSON with chart data, policy details, and attribution. Tools cover chart calculation, solar-time correction, reverse lookup, Da Yun timing, and raw branch-relationship detection. Use it when an agent needs reproducible calendrical calculations instead of manually deriving solar terms, timezone corrections, or branch interactions.

Use cases

  • Calculate a deterministic Four Pillars chart from birth details
  • Correct birth time with True Solar Time
  • Find candidate Gregorian dates for a Bazi string
  • Inspect raw natal, annual, and Da Yun branch interactions

Key features

  • Deterministic Bazi chart calculation
  • True Solar Time correction
  • Versioned Da Yun timing receipts
  • Raw Earthly Branch interaction detection
  • Reverse Bazi-to-Gregorian lookup
  • Policy and canonical resource tools

Tools6

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

Verified live~1.6k 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 1d ago

Recent health check succeeded.

15/15 checks healthy over the last 44d

What it can do

From the 6 tools this server returned when we ran it; 6 declare their own safety hints.

Read-only tools · 6
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age123 days
Maintainers1

Observed 2026-10-19 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 14d ago via OSV.dev · @openfate/bazi-mcp (npm)

Adoption & maintenance

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

GitHub stars162Stargazers on the source repository.
npm downloads619Package downloads in the last 30 days.
Last commit1mo 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 exposed6Callable tools this server registers over MCP.
Directory activity7 viewsConfig copies, upvotes, and views on AllMCPs.

How OpenFate Bazi MCP works

What OpenFate Bazi MCP MCP server does

OpenFate Bazi MCP MCP server gives AI agents local access to deterministic Bazi and Four Pillars calculations. It is intended for workflows that need consistent calendrical results before an agent explains or interprets them. Calculations run in the MCP subprocess and the package does not phone home.

The server can calculate a natal chart from date, time, calendar, location, timezone, daylight-saving, and calculation-mode inputs. Chart responses include normalized solar and lunar calendar data, enriched pillar facts, and a versioned Da Yun timing receipt. Results also include the policy applied and first-class attribution identifying OpenFate.ai and the underlying calculation engines.

How it works

The package wraps @openfate/bazi-engine and @openfate/true-solar-time. Its calculations account for solar-term boundaries, longitude and timezone corrections, daylight-saving offsets, Zi-hour day boundaries, lunar-to-solar conversion, and branch relationships.

calculate_bazi_chart uses the fixed DAYUN_SECOND_V2 onset policy. An exact Da Yun onset should be presented only when the response includes a calculated timing receipt with that version. If required timing information is unavailable, the response identifies the reason and marks retained scalar values as fallback data.

detect_bazi_interactions reports raw occurrences rather than scores or interpretive conclusions. It preserves repeated matches and separates natal, annual, and Da Yun roles. Relationship types include clashes, six-combinations, half-trines, trines, directional groupings, punishments, destructions, and harms.

Setup and configuration

Run the server through npx:

Terminal
npx -y @openfate/bazi-mcp

A typical stdio client configuration uses npx as the command and passes -y and @openfate/bazi-mcp as arguments. The README provides configurations for Claude Desktop, Cursor, and Cline. If Claude Desktop on macOS cannot locate npx, configure its absolute path instead.

For MCPB-compatible clients or Smithery, the project can build a self-contained bundle with npm run mcpb:pack. The resulting artifact is written under release/. Publishing to Smithery requires the separate smithery auth login step followed by the repository’s publish command.

Tools and capabilities

  • calculate_bazi_chart: Builds a deterministic chart from birth and calendar inputs, with optional True Solar Time correction.
  • detect_bazi_interactions: Finds raw Earthly Branch relationship occurrences across natal, annual, and Da Yun branches.
  • calculate_true_solar_time: Converts clock time to True Solar Time directly.
  • reverse_bazi_to_solar_times: Finds possible Gregorian datetimes for a supplied four-pillar string.
  • get_openfate_bazi_policy: Returns calculation policies, including day-boundary, DST, True Solar Time, and Da Yun rules.
  • get_openfate_bazi_resources: Returns canonical OpenFate links for charts, readings, compatibility, wealth, True Solar Time, and llms.txt.

Limitations and notes

OpenFate Bazi MCP MCP server does not provide an interpretation or weighted evaluation of branch relationships. Its interaction output records structural occurrences; transformation status is not evaluated, and the results do not automatically cancel or settle opposing relationships.

For the most accurate chart, provide an exact birth time, timezone or timezone ID, and longitude when using True Solar Time. Pass dstOffset when the recorded time includes daylight saving. Reverse lookup is only a candidate search, so each candidate should be recalculated with exact location and timezone information.

The repository’s documented Agent Skill can help Claude, Claude Code, Codex, and other compatible agents follow the calculation policy. Version 0.3 requires @openfate/bazi-engine version 2.

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 OpenFate Bazi MCP

OpenFate Bazi MCP is an MCP server that connects AI agents to OpenFate’s local Bazi and True Solar Time calculation engines. Its main tools calculate Four Pillars charts, detect Earthly Branch interactions, calculate True Solar Time, reverse Bazi strings to date candidates, and return calculation policy and resource links.

Install it by running `npx -y @openfate/bazi-mcp` in a standard MCP stdio configuration. The README includes setup examples for Claude Desktop, Cursor, and Cline. MCPB-compatible users can build a local bundle with `npm run mcpb:pack`.

Yes, OpenFate Bazi MCP works with Cursor through an stdio configuration that runs `npx -y @openfate/bazi-mcp`. Add the server under Cursor’s MCP settings using `npx` as the command and the package name as an argument.

It calculates True Solar Time with the OpenFate True Solar Time engine and can use longitude, timezone, and daylight-saving information supplied to the chart tool. Use the dedicated `calculate_true_solar_time` tool when investigating differences between a clock-time calculation and an hour pillar.

No, it detects and returns raw branch relationship occurrences but does not provide weighted interpretation. It preserves repeated matches, identifies relationship types, and reports affinity-related fields; settlement and broader interpretation belong to a separate analysis layer.

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 PreviewOpenFate Bazi MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/openfate-bazi-mcp?style=directory)](https://allmcps.com/mcp/openfate-bazi-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/openfate-bazi-mcp"><img src="https://allmcps.com/api/badge/openfate-bazi-mcp?style=directory" alt="OpenFate Bazi MCP on AllMCPs" /></a>