D8ly Read for Developers

Bazi tools for agents and apps

Use structured, bilingual fortune data without scraping the D8ly Read interface. Start with the deterministic MCP tools, or use the authenticated HTTP API for AI-generated readings.

Connect an agent

Add the Streamable HTTP endpoint to an MCP-compatible client. These tools are read-only, deterministic, and do not call generative AI.

https://d8ly.app/mcp

Available MCP tools

get_daily_almanac

Daily Chinese Almanac

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.

calculate_bazi_chart

Calculate Bazi Chart

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.

get_daily_bazi_guidance

Daily Bazi Guidance

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.

HTTP API v1

These endpoints require a bearer API key. The current account-wide limit is 100 requests per day.

Create an API key
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

Machine-readable references

MCP quickstartMarkdown API guideFull agent referenceOpenAPI 3.1 contract

Data and interpretation notice

MCP arguments are used only for the requested calculation and are not saved. Use birth data only with the subject’s permission. Results are for entertainment and personal reflection—not medical, legal, financial, or other professional advice.