# freebazi [Health: Active]

**Category:** 🔮 Spirituality & Esoterica  
**Repository:** https://github.com/alexsu1212/freebazi-mcp  
**GitHub Stars:** 0  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/freebazi

## Description
Offline Bazi (八字, Four Pillars) chart: True Solar Time, Ten Gods, Shen Sha, luck pillars.

## Tools
Capabilities this server exposes over MCP:

- **compute_bazi_chart** — Compute a full Chinese Bazi (八字, Four Pillars of Destiny) chart from a birth date, time, and place. Returns the four pillars, Day Master, Ten Gods, Hidden Stems, Five Elements, Na Yin, Growth Stages, Shen Sha, branch relations, Luck Pillars, and the current year, computed with True Solar Time and historical daylight-saving handling. Provide a birth city (use search_cities to resolve it) for accurate true solar time, or pass longitude and utcOffset directly.
- **search_cities** — Search the built-in city list (about 490 major world cities) by English or Chinese name. Returns matches with their country, longitude, and IANA time zone, so you can pass an exact city to compute_bazi_chart for accurate True Solar Time.

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

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

## Documentation

## What the freebazi MCP server does

The freebazi MCP server calculates a complete Chinese Bazi chart from a recorded birth moment and location. Its output covers the Year, Month, Day, and Hour pillars, with each pillar represented by a Heavenly Stem and Earthly Branch. It also identifies the Day Master and assigns the Ten Gods across the chart.

The result includes hidden stems, Na Yin, the Twelve Growth Stages, and Five Elements distributions both with and without hidden stems. Additional sections report Shen Sha, branch relationships such as combinations, clashes, punishments, and harms, plus the luck-pillar sequence, the currently active period, and the current year's pillar. The response also contains a link to a corresponding interactive chart on freebazi.com.

## How it works

The calculation engine runs on the local machine and does not require an API key or network access. It adjusts the supplied local clock time using the location's longitude and time-zone data to calculate True Solar Time. Historical daylight-saving rules are also considered through IANA time-zone data.

Solar-term boundaries use the Sun's apparent longitude. The project states that its Four Pillars have been compared character by character with established Bazi libraries across thousands of test charts. These calculations describe a traditional chart for reflection on temperament, tendencies, and timing; they are not presented as predictions of specific events.

## Setup and configuration

Node.js 18 or newer is required. Start the server directly with:

```bash
npx freebazi-mcp
```

For Claude Desktop, add an MCP entry whose command is `npx` and whose argument list contains `-y` and `freebazi-mcp`. The README gives the same command-and-arguments pattern for Cline, Continue, Cursor, and other MCP clients that support stdio servers.

`compute_bazi_chart` accepts numeric year, month, day, hour, and minute values, plus a required `gender` of `male` or `female` for determining luck-pillar direction. Supply either a `city` or explicit `longitude` and `utcOffset`. Set `timeUnknown` when the birth hour is unavailable; in that case, the Hour pillar is tentative. `trueSolarTime` defaults to enabled. The `dayRule` can use a 23:00 or midnight boundary, while `yearRule` can use Li Chun or Chinese New Year.

## Tools and capabilities

- `compute_bazi_chart`: Produces the full chart from birth and location inputs.
- `search_cities`: Searches roughly 490 major cities by English or Chinese name and returns the country, longitude, and IANA time zone for each match.

A typical workflow is to search for the exact city first, then use its location information when requesting the chart. Alternatively, callers can provide longitude and UTC offset directly. The city lookup is useful when a place name could match more than one location.

## Limitations and notes

The city index covers about 490 major world cities rather than every locality. An unknown birth time makes the Hour pillar tentative. Gender is required for luck-pillar direction. The server calculates and describes charts; it does not claim to forecast events. The package is licensed under MIT, and its city data is credited to GeoNames under CC BY 4.0.

_Full upstream README: https://allmcps.com/mcp/freebazi/readme_