Use structured, bilingual fortune data without scraping the D8ly Compass 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/mcpDaily Chinese Almanac
get_daily_almanacUse 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_chartUse 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.
Daily Bazi Guidance
get_daily_bazi_guidanceUse 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 keyPOST /api/v1/baziBazi chartPOST /api/v1/dailyDaily fortunePOST /api/v1/number-energyNumber energyPOST /api/v1/tarotTarot readingPOST /api/v1/compatibilityCompatibilityPOST /api/v1/kidsKids daily fortunePOST /api/v1/faceFace readingPOST /api/v1/auraAura readingPOST /api/v1/couple-faceCouple face matchReferences and responsible use
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.