# D8ly Read

> Daily Bazi (八字) readings, Chinese almanac data, and deterministic Chinese metaphysics tools at d8ly.app.

D8ly Read calculates Chinese Bazi (Four Pillars of Destiny) birth charts using True Solar Time and provides daily fortune readings, yearly outlooks, and multiple reflection and divination tools.

## What this site provides

- **Bazi calculator**: Four Pillars, Heavenly Stems, Earthly Branches, and Five Elements analysis with True Solar Time correction.
- **Daily Bazi guidance**: Structured daily interactions between a supplied birth chart and a requested calendar date.
- **Chinese almanac**: Day pillar, lunar date, suitable and unsuitable activities, auspicious directions, and zodiac clash.
- **Yearly outlook**: Month-by-month Bazi guidance for the current year.
- **Additional readings**: Tarot, Purple Star Astrology, compatibility, face reading, fortune sticks, moon blocks, number energy, name analysis, aura, and child-friendly guidance.

## Agent entry points

- [MCP endpoint](https://d8ly.app/mcp): Stateless Streamable HTTP endpoint with read-only deterministic tools.
- [MCP quickstart](https://d8ly.app/developers/quickstart): Copy-ready remote MCP configuration and starter prompts.
- [Developer guide](https://d8ly.app/developers): Human-readable connection and API documentation.
- [Markdown API guide](https://d8ly.app/developers/api.md): Compact tool and endpoint directory.
- [OpenAPI 3.1 contract](https://d8ly.app/openapi.json): Machine-readable contract for authenticated HTTP API v1.
- [Full LLM guide](https://d8ly.app/llms-full.txt): Expanded calculation, privacy, and capability reference.

## Citable knowledge

- [What is Bazi?](https://d8ly.app/what-is-bazi)
- [Day Master reference](https://d8ly.app/learn/day-master)
- [Five Elements reference](https://d8ly.app/learn/five-elements)
- [True Solar Time reference](https://d8ly.app/learn/true-solar-time)
- [Bazi calculation method — English](https://d8ly.app/en/learn/bazi-calculation-method)
- [八字計算方法 — 繁體中文](https://d8ly.app/zh-hant/learn/bazi-calculation-method)

## Usage notice

- English: For entertainment and personal reflection only. Do not use this result as medical, legal, financial, or other professional advice.
- 繁體中文：本結果僅供娛樂與個人反思，不應作為醫療、法律、財務或其他專業建議。


# D8ly Read full agent reference

## Selection guidance

- Use `get_daily_almanac` for questions about a calendar date that do not require a birth chart.
- Use `calculate_bazi_chart` only when the subject supplied a birth date, local birth time, latitude, longitude, and the historical UTC offset.
- Use `get_daily_bazi_guidance` when those birth inputs and an explicit reading date are available.
- Do not infer missing birth data, coordinates, daylight-saving rules, or consent.
- Prefer the deterministic MCP tools when an agent needs reproducible structured data.

## Deterministic MCP tools

### `get_daily_almanac`

- English: Use this when a date-only request needs the day pillar, lunar date, suitable and unsuitable activities, auspicious directions, or zodiac clash. Do not use it for personalized Bazi readings.
- 繁體中文：當僅依日期查詢日柱、農曆日期、宜忌、吉神方位或生肖相沖時使用；個人化八字解讀請勿使用。
- Deterministic: yes
- Canonical interface: https://d8ly.app/guidance

### `calculate_bazi_chart`

- English: Use this when complete birth details are supplied and a Four Pillars chart with True Solar Time correction is needed. Do not infer missing birth details.
- 繁體中文：當已提供完整出生資料，且需要以真太陽時校正建立四柱八字時使用；請勿推測缺少的出生資料。
- Deterministic: yes
- Canonical interface: https://d8ly.app/charts

### `get_daily_bazi_guidance`

- English: Use this when complete birth details and a reading date are supplied for deterministic daily Bazi guidance. Do not use it for a date-only almanac request.
- 繁體中文：當已提供完整出生資料與解讀日期，且需要確定式八字每日指引時使用；僅查日期黃曆時請勿使用。
- Deterministic: yes
- Canonical interface: https://d8ly.app/daily

## Authenticated HTTP API v1

The HTTP API supports additional AI-generated and media-based readings. It requires a bearer key created at https://d8ly.app/settings/api-keys and is separate from the public deterministic MCP tools.

- `POST /api/v1/bazi` — Bazi chart / 八字命盤
- `POST /api/v1/daily` — Daily fortune / 每日運勢
- `POST /api/v1/number-energy` — Number energy / 數字能量
- `POST /api/v1/tarot` — Tarot reading / 塔羅解讀
- `POST /api/v1/compatibility` — Compatibility / 人際合盤
- `POST /api/v1/kids` — Kids daily fortune / 兒童每日運勢
- `POST /api/v1/face` — Face reading / 面相解讀
- `POST /api/v1/aura` — Aura reading / 氣場解讀
- `POST /api/v1/couple-face` — Couple face match / 夫妻臉分析

## Calculation method

1. Accept local civil birth date and time, geographic coordinates, and the historical UTC offset as explicit inputs.
2. Correct local civil time toward local apparent solar time using longitude and the Equation of Time.
3. Calculate the Year, Month, Day, and Hour pillars as Heavenly Stem and Earthly Branch pairs.
4. Derive Five Elements and Day Master relationships from the resulting chart.
5. For daily guidance, compare the supplied chart with the pillar and almanac data for the requested reading date.

The MCP tools do not infer a location, time zone, daylight-saving transition, or missing birth time. See https://d8ly.app/en/learn/bazi-calculation-method for the English methodology and https://d8ly.app/zh-hant/learn/bazi-calculation-method for Traditional Chinese.

## Data handling

- Tool arguments are used only for the requested calculation.
- MCP tools do not create accounts, change profiles, or save readings.
- Operational telemetry excludes birth data, full arguments, IP addresses, and person profiles.
- Use another person's birth data only with their permission.

## Interpretation boundary

- English: For entertainment and personal reflection only. Do not use this result as medical, legal, financial, or other professional advice.
- 繁體中文：本結果僅供娛樂與個人反思，不應作為醫療、法律、財務或其他專業建議。