# BaZi Four Pillars MCP [Verified owner] [Health: Active]

**Category:** 🔮 Spirituality & Esoterica  
**Repository:** https://github.com/cdaily1995-create/four-pillars-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/bazi-four-pillars-mcp

## Description
Deterministic BaZi Four Pillars calculation from local date, time, IANA timezone, and longitude, with true solar time and astronomical solar terms.

## Tools
Capabilities this server exposes over MCP:

- **calculate_four_pillars** — Input:

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "bazi-four-pillars-mcp": {
    "command": "npx",
    "args": ["-y","bazi-four-pillars-mcp"]
  }
}
```

## Documentation

## What BaZi Four Pillars MCP does

BaZi Four Pillars MCP exposes a local MCP calculation service for normalizing birth-chart inputs into the four traditional pillars: year, month, day, and hour. It is designed for software and calendrical workflows that need repeatable calculation facts rather than generated readings or predictions.

The calculation accepts a local civil date and time, an IANA timezone identifier, and a longitude. Latitude is optional and is retained for traceability. Locations are supplied directly as coordinates; the server does not look up an address or geocode a place name.

## How it works

The server calculates day and hour values using local apparent true solar time. Its output also exposes the time-correction details used in that process, making the normalization steps available to downstream applications.

Year and month boundaries use astronomical solar terms rather than a simple calendar-date rule. The calculation treats 23:00 as the Zi-hour transition into the next day. Each result includes explicit engine and rules versions, nearby solar-term information, warnings, provenance, and the chart’s stem-and-branch details.

## Setup and configuration

The package can be launched directly through npm:

```bash
npx -y bazi-four-pillars-mcp
```

To build it from source, clone the repository, install dependencies with pnpm, build the project, and start the generated server:

```bash
git clone https://github.com/cdaily1995-create/four-pillars-mcp.git
cd four-pillars-mcp
pnpm install
pnpm build
node dist/server.js
```

A stdio MCP client can register the npm command with this configuration:

```json
{
  "mcpServers": {
    "four-pillars": {
      "command": "npx",
      "args": ["-y", "bazi-four-pillars-mcp"]
    }
  }
}
```

The process calculates results locally and does not require an account, database, analytics service, payment setup, address search, or remote API.

## Tools and capabilities

### `calculate_four_pillars`

The tool requires these fields:

- `date`: local civil date in `YYYY-MM-DD` format.
- `time`: local civil time in `HH:mm` format.
- `timezone`: an IANA timezone such as `Asia/Shanghai` or `America/Los_Angeles`.
- `longitude`: decimal degrees from -180 to 180, with east as positive.

`latitude` is optional and accepts decimal degrees from -90 to 90. A typical request supplies a date, time, timezone, longitude, and latitude in one JSON object.

Responses contain the four pillar names, stem and branch elements, yin-yang labels, the Day Master, solar-time correction information, nearby solar-term data, warnings, provenance, and version identifiers for the calculation engine and rules.

## Limitations and notes

The server reports calculation facts and does not automatically interpret them as personality profiles, life outcomes, or guaranteed predictions. Traditional BaZi meanings are culturally interpretive and are not presented as scientific proof, diagnosis, or certainty.

Because the caller supplies the timezone and longitude, input quality affects the result. The service does not perform address-based location discovery, and it does not provide gender-dependent luck cycles or store birth data.

_Full upstream README: https://allmcps.com/mcp/bazi-four-pillars-mcp/readme_

