almanac
Look up the Chinese almanac (黄历/万年历) for a given date. Returns lunar date, auspicious/inauspicious activities, five elements, and more.
LABSCO SUMMARY
The almanac is the tool with a use independent of belief — lunar dates and traditional day designations are reference data people need for real scheduling.
Whatever you make of the divination systems, the Chinese almanac is consulted for genuinely practical reasons: choosing a wedding date, understanding a lunar calendar entry, knowing which festival falls when. That part is lookup rather than prediction. The rest is a structured implementation of traditional practices — BaZi, qiuqian, Zhou Gong, Five Grid — and is worth taking on those terms: these are cultural systems with their own internal logic, presented consistently, and the outputs are readings within those traditions rather than claims that can be checked against outcomes. Useful for anyone working with the material, for cultural reference, or for a reading they are approaching as a reading.
What it is
A divination and traditional-practice reference covering Chinese systems primarily — BaZi, the lunar almanac, qiuqian lot drawing, dream interpretation, name numerology, feng shui — alongside zodiac analysis, compatibility and tarot, with a community feed.
What you get
- bazi_analysis works from birth date and time in the Four Pillars system, and compatibility analyses two people from their birth information.
- almanac returns the Chinese almanac for a date including the lunar date — genuinely useful reference data independent of any predictive claim.
- qiuqian performs temple fortune-stick divination, and dream_interpret applies Zhou Gong dream analysis.
- name_score analyses a Chinese name by Five Grid numerology, and fengshui assesses a living or working space with a score and analysis.
- zodiac returns in-depth sign analysis including element and ruling associations, and daily_fortune is the per-day form.
- tarot performs a reading with a chosen spread.
- A community layer: browse recent posts and create one.
Requirements
GUANXING_API_KEY.
Setup effort
One command plus a key — npx -y @guanxing1/mcp-server, then supply credentials
USE CASES
01
Looking up a date in the traditional calendar
Read the almanac for the lunar date and traditional designations, which is reference data whatever you make of the rest.
02
Getting a BaZi reading
Analyse the Four Pillars from birth date and time, and compare two people's charts for compatibility.
03
Consulting a tradition
Draw a temple lot, interpret a dream through Zhou Gong analysis, or take a tarot spread on a question.
04
Assessing a name or a space
Score a Chinese name by Five Grid numerology, or get a feng shui assessment of a home or workplace.
05
Reading the zodiac material
Get the in-depth sign analysis with element and ruling associations, or the daily form.
06
Seeing what others are asking
Browse recent community posts, or post a question of your own.
12 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
bazi_analysis
Analyze Chinese Four Pillars (BaZi / 八字) based on birth date and time. Returns heavenly stems, earthly branches, five elements breakdown, day master, and detailed analysis.
community_browse
Browse the latest community posts on GuanXing. Returns up to 20 recent posts with authors and engagement counts.
community_post
Create a new post in the GuanXing community. Share thoughts, ask questions, or offer encouragement.
compatibility
Analyze compatibility between two people based on their birth info, zodiac, or names. Returns score, dimensional analysis, and relationship advice.
daily_fortune
Get personalized daily fortune based on zodiac sign and optional birth date. Returns scores for career, love, wealth, health, and advice.
dream_interpret
Interpret a dream using traditional Zhou Gong dream analysis (周公解梦) combined with modern psychology. Describe your dream and get symbols, interpretation, and advice.
fengshui
Feng shui assessment for a living or working space. Get a score, analysis, suggestions, and lucky/unlucky items.
name_score
Score and analyze a Chinese name using traditional Five Grid numerology (五格剖象法). Returns total score, grid breakdown, five elements analysis.
qiuqian
Draw a divine lot (求签) — traditional Chinese temple fortune stick divination. Ask a question and receive a signed poem with interpretation.
tarot
Perform a tarot card reading. Ask a question and choose a spread type. Returns drawn cards with meanings and a comprehensive interpretation.
zodiac
Get in-depth zodiac sign analysis including personality traits, element, ruling planet, and compatibility.
BEFORE YOU INSTALL
What to know first
Tools you get
12 tools when we connected. community_post publishes to the GuanXing community under your account; the other tools are lookups that change nothing.
Requires
- npx on PATH
- GUANXING_API_KEY in your environment
Where it runs
All 5 documented clients run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 12 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y @guanxing1/mcp-serverMCP Clients
Claude Desktop, Claude Code, Windsurf, Cursor
JSON
{
"mcpServers": {
"guanxing": {
"command": "npx",
"args": [
"-y",
"@guanxing1/mcp-server"
],
"env": {
"GUANXING_API_KEY": "<YOUR_GUANXING_API_KEY>"
}
}
}
}VS Code
VS CODE · JSON
{
"servers": {
"guanxing": {
"command": "npx",
"args": [
"-y",
"@guanxing1/mcp-server"
],
"env": {
"GUANXING_API_KEY": "<YOUR_GUANXING_API_KEY>"
}
}
}
}
