Feng Shui MCP Server by RoxyAPI
Kua numbers, Eight Mansions, Flying Star charts and annual afflictions for AI agents.
我該用這個嗎
品質與安全性
A
發現項目（5）
- LOWTool 'get_feng_shui_bagua' description lacks action verb在 get_feng_shui_bagua 中
- LOWTool 'get_feng_shui_bagua_id' description lacks action verb在 get_feng_shui_bagua_id 中
- LOWTool 'post_feng_shui_flying_stars_natal' name length outside 3-30 range在 post_feng_shui_flying_stars_natal 中
- LOWTool 'get_feng_shui_flying_stars_annual_year' name length outside 3-30 range在 get_feng_shui_flying_stars_annual_year 中
- LOWTool 'get_feng_shui_flying_stars_monthly' name length outside 3-30 range在 get_feng_shui_flying_stars_monthly 中
根據工具定義與協定合規性的自動化分析。
上下文成本
~8,708Token（工具定義）
~7.7 KB典型回應大小
顯著的注意力影響（128k 上下文的 6.80%）
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"feng-shui": {
"url": "https://roxyapi.com/mcp/feng-shui"
}
}
}遠端端點
https://roxyapi.com/mcp/feng-shuistreamable-http它能做什麼
工具清單
工具（11）
🟢 唯讀🟡 寫入🔴 刪除⚪ 未知
🟢post_feng_shui_kua(lang, date, gender, yearBoundary, compact)
Calculate the Kua number, also called the Ming Gua or life gua, from a birth date and sex. Returns the number, the east or west life group, the personal trigram, and all eight compass sectors classified from best to worst. The Chinese year is resolved at Li Chun by default, so an early February birthday is placed in the correct year rather than the calendar one, and the boundary that decided it is echoed back. Built for room and desk placement features, personalised feng shui reports, and any product that needs a favourable direction per person.
輸入結構描述
{
"type": "object",
"properties": {
"lang": {
"type": "string",
"description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.",
"enum": [
"en",
"tr",
"de",
"es",
"hi",
"pt",
"fr",
"ru",
"zh-Hans",
"zh-Hant"
],
"default": "en",
"example": "en"
},
"date": {
"type": "string",
"format": "date",
"example": "1985-07-15",
"description": "Birth date in YYYY-MM-DD format. Only the Chinese YEAR this date falls in enters the formula, so no birth time, latitude or longitude is needed. A January or early February birthday is the case that matters: it usually belongs to the PREVIOUS Chinese year and produces a different Kua. A date is read at the start of its day, and the boundary falls part-way through its own day, so a birth date landing exactly on the boundary day is placed in the outgoing year."
},
"gender": {
"type": "string",
"enum": [
"male",
"female"
],
"example": "male",
"description": "Selects the Kua formula variant. The two formulas are different arithmetic on the same year, and they also differ in where a raw result of 5 is reassigned."
},
"yearBoundary": {
"type": "string",
"enum": [
"li-chun",
"lunar-new-year"
],
"default": "li-chun",
"example": "li-chun",
"description": "Which boundary starts the Chinese year. Defaults to li-chun, the astronomical start of spring in early February, which is the classical position and the one feng shui uses for periods, annual stars and afflictions alike. Send lunar-new-year to match popular zodiac tables, which start the year two to four weeks later. The two disagree for anyone born between the two dates."
},
"compact": {
"type": "boolean",
"description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.",
"default": false
}
},
"required": [
"date",
"gender"
],
"examples": [
{
"date": "1985-07-15",
"gender": "male"
}
]
}輸出結構描述
{
"type": "object",
"properties": {
"kua": {
"type": "number"
},
"rawKua": {
"type": "number"
},
"reassigned": {
"type": "boolean"
},
"gender": {
"type": "string"
},
"group": {
"type": "string"
},
"solarYear": {
"type": "number"
},
"boundaryDate": {
"type": "string"
},
"trigram": {
"type": "object",
"properties": {
"number": {
"type": "number"
},
"chinese": {
"type": "string"
},
"english": {
"type": "string"
},
"nameLocalized": {
"type": "string"
},
"pinyin": {
"type": "string"
},
"symbol": {
"type": "string"
},
"binary": {
"type": "string"
},
"element": {
"type": "string"
},
"elementLocalized": {
"type": "string"
},
"direction": {
"type": "string"
},
"directionLocalized": {
"type": "string"
},
"familyMember": {
"type": "string"
}
},
"required": [
"number",
"chinese",
"english",
"pinyin",
"symbol",
"binary",
"element",
"direction",
"familyMember"
]
},
"sectors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"direction": {
"type": "string"
},
"star": {
"type": "string"
},
"starName": {
"type": "string"
},
"starNameLocalized": {
"type": "string"
},
"nature": {
"type": "string"
},
"rank": {
"type": "number"
},
"domain": {
"type": "string"
}
},
"required": [
"direction",
"star",
"starName",
"nature",
"rank",
"domain"
]
}
},
"conventions": {
"type": "object",
"properties": {
"yearBoundary": {
"type": "string"
}
},
"required": [
"yearBoundary"
]
}
},
"required": [
"kua",
"rawKua",
"reassigned",
"gender",
"group",
"solarYear",
"boundaryDate",
"trigram",
"sectors",
"conventions"
]
}🟢get_feng_shui_kua_number(number, lang, compact)
Look up the reference chart for one Kua number: its trigram, its east or west life group, and how it classifies all eight compass sectors. A pure reference endpoint with no birth data required, for building a lookup table or a picker. Number 5 is served for completeness and is never a computed result, because it belongs to the centre and has no direction of its own: a man whose formula gives 5 reads Kua 2 and a woman reads Kua 8, and the chart returned for 5 is therefore the Kua 2 chart.
輸入結構描述
{
"type": "object",
"properties": {
"number": {
"type": "integer",
"description": "Kua number, 1 to 9.",
"minimum": 1,
"maximum": 9,
"example": 8
},
"lang": {
"type": "string",
"description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.",
"enum": [
"en",
"tr",
"de",
"es",
"hi",
"pt",
"fr",
"ru",
"zh-Hans",
"zh-Hant"
],
"default": "en",
"example": "en"
},
"compact": {
"type": "boolean",
"description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.",
"default": false
}
},
"required": [
"number"
],
"examples": [
{
"number": 8
}
]
}輸出結構描述
{
"type": "object",
"properties": {
"number": {
"type": "number"
},
"group": {
"type": "string"
},
"trigram": {
"type": "object",
"properties": {
"number": {
"type": "number"
},
"chinese": {
"type": "string"
},
"english": {
"type": "string"
},
"nameLocalized": {
"type": "string"
},
"pinyin": {
"type": "string"
},
"symbol": {
"type": "string"
},
"binary": {
"type": "string"
},
"element": {
"type": "string"
},
"elementLocalized": {
"type": "string"
},
"direction": {
"type": "string"
},
"directionLocalized": {
"type": "string"
},
"familyMember": {
"type": "string"
}
},
"required": [
"number",
"chinese",
"english",
"pinyin",
"symbol",
"binary",
"element",
"direction",
"familyMember"
]
},
"sectors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"direction": {
"type": "string"
},
"star": {
"type": "string"
},
"starName": {
"type": "string"
},
"starNameLocalized": {
"type": "string"
},
"nature": {
"type": "string"
},
"rank": {
"type": "number"
},
"domain": {
"type": "string"
}
},
"required": [
"direction",
"star",
"starName",
"nature",
"rank",
"domain"
]
}
}
},
"required": [
"number",
"group",
"trigram",
"sectors"
]
}🟢post_feng_shui_eight_mansions(lang, kua, date, gender, yearBoundary, ...)
Build the full Eight Mansions (Ba Zhai) map for a person: all eight compass sectors classified into the four favourable stars, Sheng Chi, Tian Yi, Yan Nian and Fu Wei, and the four unfavourable ones, Huo Hai, Wu Gui, Liu Sha and Jue Ming. Sectors come back ordered best to worst with a composed reading each, plus the ranking that decides which affliction to accept when no favourable sector is reachable. Accepts a Kua number directly or derives one from a birth date and sex. Built for bed and desk placement tools, room-by-room reports and floor plan overlays.
輸入結構描述
{
"type": "object",
"properties": {
"lang": {
"type": "string",
"description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.",
"enum": [
"en",
"tr",
"de",
"es",
"hi",
"pt",
"fr",
"ru",
"zh-Hans",
"zh-Hant"
],
"default": "en",
"example": "en"
},
"kua": {
"type": "number",
"minimum": 1,
"maximum": 9,
"example": 6,
"description": "Kua number to build the map for, if you already have one. Send this OR date and gender, not neither. A Kua of 5 is read as the Kua 2 chart, since 5 has no direction of its own."
},
"date": {
"type": "string",
"format": "date",
"example": "1985-07-15",
"description": "Birth date in YYYY-MM-DD format, used to derive the Kua when no kua is sent. Requires gender alongside it. A date is read at the start of its day, so a birth date landing exactly on the year boundary is placed in the outgoing year."
},
"gender": {
"type": "string",
"enum": [
"male",
"female"
],
"example": "male",
"description": "Selects the Kua formula variant. Required when the Kua is being derived from a birth date."
},
"yearBoundary": {
"type": "string",
"enum": [
"li-chun",
"lunar-new-year"
],
"default": "li-chun",
"example": "li-chun",
"description": "Which boundary starts the Chinese year when the Kua is derived from a birth date. Defaults to li-chun, the classical position. Ignored when a kua is sent directly, and echoed back either way."
},
"facing": {
"type": "string",
"enum": [
"North",
"Northeast",
"East",
"Southeast",
"South",
"Southwest",
"West",
"Northwest"
],
"example": "Southeast",
"description": "Optional compass sector the main door faces, one of North, Northeast, East, Southeast, South, Southwest, West, Northwest. When sent, the response names the star sitting on that sector so a caller can judge an entrance without scanning the whole map."
},
"compact": {
"type": "boolean",
"description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.",
"default": false
}
},
"examples": [
{}
]
}輸出結構描述
{
"type": "object",
"properties": {
"kua": {
"type": "number"
},
"group": {
"type": "string"
},
"trigram": {
"type": "object",
"properties": {
"number": {
"type": "number"
},
"chinese": {
"type": "string"
},
"english": {
"type": "string"
},
"nameLocalized": {
"type": "string"
},
"pinyin": {
"type": "string"
},
"symbol": {
"type": "string"
},
"binary": {
"type": "string"
},
"element": {
"type": "string"
},
"elementLocalized": {
"type": "string"
},
"direction": {
"type": "string"
},
"directionLocalized": {
"type": "string"
},
"familyMember": {
"type": "string"
}
},
"required": [
"number",
"chinese",
"english",
"pinyin",
"symbol",
"binary",
"element",
"direction",
"familyMember"
]
},
"sectors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"direction": {
"type": "string"
},
"star": {
"type": "string"
},
"starName": {
"type": "string"
},
"starNameLocalized": {
"type": "string"
},
"chinese": {
"type": "string"
},
"pinyin": {
"type": "string"
},
"nature": {
"type": "string"
},
"rank": {
"type": "number"
},
"domain": {
"type": "string"
},
"trigram": {
"type": "object",
"properties": {
"number": {
"type": "number"
},
"chinese": {
"type": "string"
},
"english": {
"type": "string"
},
"nameLocalized": {
"type": "string"
},
"pinyin": {
"type": "string"
},
"symbol": {
"type": "string"
},
"binary": {
"type": "string"
},
"element": {
"type": "string"
},
"elementLocalized": {
"type": "string"
},
"direction": {
"type": "string"
},
"directionLocalized": {
"type": "string"
},
"familyMember": {
"type": "string"
}
},
"required": [
"number",
"chinese",
"english",
"pinyin",
"symbol",
"binary",
"element",
"direction",
"familyMember"
]
},
"reading": {
"type": "string"
}
},
"required": [
"direction",
"star",
"starName",
"chinese",
"pinyin",
"nature",
"rank",
"domain",
"trigram",
"reading"
]
}
},
"bestSector": {
"type": "string"
},
"worstSector": {
"type": "string"
},
"facingSector": {
"type": "object",
"properties": {
"direction": {
"type": "string"
},
"star": {
"type": "string"
},
"nature": {
"type": "string"
}
},
"required": [
"direction",
"star",
"nature"
]
},
"conventions": {
"type": "object",
"properties": {
"yearBoundary": {
"type": "string"
}
},
"required": [
"yearBoundary"
]
}
},
"required": [
"kua",
"group",
"trigram",
"sectors",
"bestSector",
"worstSector",
"conventions"
]
}🟢post_feng_shui_flying_stars_natal(lang, period, facing, facingDegrees, compact)
Cast the Xuan Kong flying star natal chart for a building from its construction period and the direction it faces. Returns all nine palaces with the period star, the mountain star that governs health and relationships and the water star that governs wealth, plus the named formation and a composed reading for every palace, and the classical verdict on how the two prosperous stars landed. Facing is accepted as one of the 24 mountains or as a compass bearing. Built for property analysis tools, floor plan overlays and consultation software.
輸入結構描述
{
"type": "object",
"properties": {
"lang": {
"type": "string",
"description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.",
"enum": [
"en",
"tr",
"de",
"es",
"hi",
"pt",
"fr",
"ru",
"zh-Hans",
"zh-Hant"
],
"default": "en",
"example": "en"
},
"period": {
"type": "integer",
"minimum": 1,
"maximum": 9,
"example": 9,
"description": "Construction period of the building, 1 to 9. This is the twenty year cycle the building was completed in, or last renovated heavily enough to reset, and it is fixed for the life of the building. Periods change at Li Chun in early February, so a building finished in January 2024 is a Period 8 building. Defaults to the period in force now."
},
"facing": {
"type": "string",
"enum": [
"ren",
"zi",
"gui",
"chou",
"gen",
"yin",
"jia",
"mao",
"yi",
"chen",
"xun",
"si",
"bing",
"wu",
"ding",
"wei",
"kun",
"shen",
"geng",
"you",
"xin",
"xu",
"qian",
"hai",
"N1",
"N2",
"N3",
"NE1",
"NE2",
"NE3",
"E1",
"E2",
"E3",
"SE1",
"SE2",
"SE3",
"S1",
"S2",
"S3",
"SW1",
"SW2",
"SW3",
"W1",
"W2",
"W3",
"NW1",
"NW2",
"NW3"
],
"example": "wu",
"description": "The mountain the front of the building faces, by id or by compass label such as S2. Send this or facingDegrees, not neither. The facing side is the open, active, public side, which is not always the side with the front door."
},
"facingDegrees": {
"type": [
"number",
"null"
],
"minimum": 0,
"maximum": 360,
"example": 180,
"description": "The compass bearing the front of the building faces, 0 to 360 degrees, measured looking out from inside. Resolved to one of the 24 mountains. Send this or facing, not neither."
},
"compact": {
"type": "boolean",
"description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.",
"default": false
}
},
"examples": [
{}
]
}輸出結構描述
{
"type": "object",
"properties": {
"period": {
"type": "number"
},
"facing": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"chinese": {
"type": "string"
},
"pinyin": {
"type": "string"
},
"direction": {
"type": "string"
},
"yuan": {
"type": "string"
},
"polarity": {
"type": "string"
},
"startDegree": {
"type": "number"
},
"endDegree": {
"type": "number"
}
},
"required": [
"id",
"label",
"chinese",
"pinyin",
"direction",
"yuan",
"polarity",
"startDegree",
"endDegree"
]
},
"sitting": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"chinese": {
"type": "string"
},
"pinyin": {
"type": "string"
},
"direction": {
"type": "string"
},
"yuan": {
"type": "string"
},
"polarity": {
"type": "string"
},
"startDegree": {
"type": "number"
},
"endDegree": {
"type": "number"
}
},
"required": [
"id",
"label",
"chinese",
"pinyin",
"direction",
"yuan",
"polarity",
"startDegree",
"endDegree"
]
},
"facingDegrees": {
"type": "number"
},
"straddling": {
"type": "boolean"
},
"mountainCenterStar": {
"type": "number"
},
"waterCenterStar": {
"type": "number"
},
"mountainFlight": {
"type": "string"
},
"waterFlight": {
"type": "string"
},
"structure": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"chinese": {
"type": "string"
},
"meaning": {
"type": "string"
}
},
"required": [
"id",
"name",
"chinese",
"meaning"
]
},
"palaces": {
"type": "array",
"items": {
"type": "object",
"properties": {
"palace": {
"type": "string"
},
"base": {
"type": "number"
},
"period": {
"type": "number"
},
"mountain": {
"type": "number"
},
"water": {
"type": "number"
},
"combination": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"nameLocalized": {
"type": "string"
},
"chinese": {
"type": "string"
},
"nature": {
"type": "string"
}
},
"required": [
"id",
"name",
"nature"
]
},
"reading": {
"type": "string"
}
},
"required": [
"palace",
"base",
"period",
"mountain",
"water",
"reading"
]
}
}
},
"required": [
"period",
"facing",
"sitting",
"straddling",
"mountainCenterStar",
"waterCenterStar",
"mountainFlight",
"waterFlight",
"structure",
"palaces"
]
}🟢get_feng_shui_flying_stars_annual_year(year, lang, compact)
Return the annual flying star plate for a solar year: which of the nine stars occupies each of the nine palaces, what it means there, and which element strengthens or drains it. The annual plate is universal and does not depend on any building, so it is the layer every yearly feng shui guide is built on. The changeover is Li Chun in early February rather than Lunar New Year, and the exact date is returned so a caller can apply the plate on the right day.
輸入結構描述
{
"type": "object",
"properties": {
"year": {
"type": "integer",
"description": "Solar year, 1900 to 2100. The year runs from Li Chun to Li Chun, so a date in January belongs to the previous year here.",
"minimum": 1900,
"maximum": 2100,
"example": 2026
},
"lang": {
"type": "string",
"description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.",
"enum": [
"en",
"tr",
"de",
"es",
"hi",
"pt",
"fr",
"ru",
"zh-Hans",
"zh-Hant"
],
"default": "en",
"example": "en"
},
"compact": {
"type": "boolean",
"description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.",
"default": false
}
},
"required": [
"year"
],
"examples": [
{
"year": 2026
}
]
}輸出結構描述
{
"type": "object",
"properties": {
"year": {
"type": "number"
},
"centerStar": {
"type": "number"
},
"changeoverDate": {
"type": "string"
},
"palaces": {
"type": "array",
"items": {
"type": "object",
"properties": {
"palace": {
"type": "string"
},
"star": {
"type": "number"
},
"name": {
"type": "string"
},
"nameLocalized": {
"type": "string"
},
"element": {
"type": "string"
},
"nature": {
"type": "string"
},
"enhancer": {
"type": "string"
},
"remedy": {
"type": "string"
},
"meaning": {
"type": "string"
}
},
"required": [
"palace",
"star",
"name",
"element",
"nature",
"enhancer",
"remedy",
"meaning"
]
}
}
},
"required": [
"year",
"centerStar",
"changeoverDate",
"palaces"
]
}🟢get_feng_shui_flying_stars_monthly(lang, year, month, compact)
Return the monthly flying star plate, the faster overlay that sits on top of the annual one. Months here are SOLAR months: month 1 begins at Li Chun in early February and each month begins at the next of the twelve major solar terms, so they never line up with calendar months. Omit both parameters to get the month in progress. Built for monthly guidance features and for timing work around an affliction that only lands for part of the year.
輸入結構描述
{
"type": "object",
"properties": {
"lang": {
"type": "string",
"description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.",
"enum": [
"en",
"tr",
"de",
"es",
"hi",
"pt",
"fr",
"ru",
"zh-Hans",
"zh-Hant"
],
"default": "en",
"example": "en"
},
"year": {
"type": "integer",
"description": "Solar year, 1900 to 2100. Defaults to the solar year in progress, which changes at Li Chun rather than on 1 January.",
"minimum": 1900,
"maximum": 2100,
"example": 2026
},
"month": {
"type": "integer",
"description": "Solar month, 1 to 12, where 1 begins at Li Chun in early February. This is NOT the calendar month: solar month 1 covers roughly 4 February to 5 March. Defaults to the solar month in progress.",
"minimum": 1,
"maximum": 12,
"example": 1
},
"compact": {
"type": "boolean",
"description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.",
"default": false
}
},
"examples": [
{}
]
}輸出結構描述
{
"type": "object",
"properties": {
"year": {
"type": "number"
},
"month": {
"type": "number"
},
"centerStar": {
"type": "number"
},
"yearBranch": {
"type": "string"
},
"palaces": {
"type": "array",
"items": {
"type": "object",
"properties": {
"palace": {
"type": "string"
},
"star": {
"type": "number"
},
"name": {
"type": "string"
},
"nameLocalized": {
"type": "string"
},
"element": {
"type": "string"
},
"nature": {
"type": "string"
},
"enhancer": {
"type": "string"
},
"remedy": {
"type": "string"
},
"meaning": {
"type": "string"
}
},
"required": [
"palace",
"star",
"name",
"element",
"nature",
"enhancer",
"remedy",
"meaning"
]
}
}
},
"required": [
"year",
"month",
"centerStar",
"yearBranch",
"palaces"
]
}🟢get_feng_shui_flying_stars(lang, limit, offset, compact)
The reference catalogue of the nine flying stars: name, Chinese characters, five phase, home palace and trigram, the period each rules, what each means, and which element strengthens or drains it. The remedy element is what the star itself produces, because a harmful star is drained by giving it somewhere to go rather than fought with the phase that controls it. A pure reference endpoint that needs no chart.
輸入結構描述
{
"type": "object",
"properties": {
"lang": {
"type": "string",
"description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.",
"enum": [
"en",
"tr",
"de",
"es",
"hi",
"pt",
"fr",
"ru",
"zh-Hans",
"zh-Hant"
],
"default": "en",
"example": "en"
},
"limit": {
"type": "integer",
"description": "Maximum items to return per page. Range: 1-9, default 9.",
"minimum": 1,
"maximum": 9,
"default": 9,
"example": 9
},
"offset": {
"type": "integer",
"description": "Number of items to skip for pagination. Default 0.",
"minimum": 0,
"default": 0,
"example": 0
},
"compact": {
"type": "boolean",
"description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.",
"default": false
}
},
"examples": [
{}
]
}輸出結構描述
{
"type": "object",
"properties": {
"total": {
"type": "number"
},
"limit": {
"type": "number"
},
"offset": {
"type": "number"
},
"stars": {
"type": "array",
"items": {
"type": "object",
"properties": {
"number": {
"type": "number"
},
"name": {
"type": "string"
},
"nameLocalized": {
"type": "string"
},
"chinese": {
"type": "string"
},
"pinyin": {
"type": "string"
},
"element": {
"type": "string"
},
"nature": {
"type": "string"
},
"keywords": {
"type": "array",
"items": {
"type": "string"
}
},
"meaning": {
"type": "string"
},
"enhancer": {
"type": "string"
},
"remedy": {
"type": "string"
},
"palace": {
"type": "string"
},
"period": {
"type": "number"
},
"trigram": {
"type": "object",
"properties": {
"number": {
"type": "number"
},
"english": {
"type": "string"
},
"chinese": {
"type": "string"
}
},
"required": [
"number",
"english",
"chinese"
]
},
"base": {
"type": "number"
}
},
"required": [
"number",
"name",
"chinese",
"pinyin",
"element",
"nature",
"keywords",
"meaning",
"enhancer",
"remedy",
"palace",
"period",
"base"
]
}
}
},
"required": [
"total",
"limit",
"offset",
"stars"
]
}🟢get_feng_shui_afflictions_year(year, lang, compact)
Return the four annual feng shui afflictions for a solar year with their exact positions: Tai Sui on the mountain of the year branch, Sui Po on the mountain opposite, the Three Killings across the cardinal span opposite the elemental frame of the year, and the Five Yellow wherever it lands on the annual star plate. Positions come with degree ranges rather than only sector names, because Tai Sui occupies 15 degrees and the neighbouring mountains of the same sector are unaffected. All four move at Li Chun in early February, not at Lunar New Year, and the changeover date is returned. Built for renovation planning, date selection and yearly guidance features.
輸入結構描述
{
"type": "object",
"properties": {
"year": {
"type": "integer",
"description": "Solar year, 1900 to 2100. The year runs from Li Chun to Li Chun, so a date in January belongs to the previous year here.",
"minimum": 1900,
"maximum": 2100,
"example": 2026
},
"lang": {
"type": "string",
"description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.",
"enum": [
"en",
"tr",
"de",
"es",
"hi",
"pt",
"fr",
"ru",
"zh-Hans",
"zh-Hant"
],
"default": "en",
"example": "en"
},
"compact": {
"type": "boolean",
"description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.",
"default": false
}
},
"required": [
"year"
],
"examples": [
{
"year": 2026
}
]
}輸出結構描述
{
"type": "object",
"properties": {
"year": {
"type": "number"
},
"yearBranch": {
"type": "string"
},
"changeoverDate": {
"type": "string"
},
"taiSui": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"chinese": {
"type": "string"
},
"pinyin": {
"type": "string"
},
"meaning": {
"type": "string"
},
"mountain": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"chinese": {
"type": "string"
},
"pinyin": {
"type": "string"
},
"direction": {
"type": "string"
},
"yuan": {
"type": "string"
},
"polarity": {
"type": "string"
},
"startDegree": {
"type": "number"
},
"endDegree": {
"type": "number"
}
},
"required": [
"id",
"label",
"chinese",
"pinyin",
"direction",
"yuan",
"polarity",
"startDegree",
"endDegree"
]
},
"direction": {
"type": "string"
},
"animal": {
"type": "string"
},
"clashingAnimal": {
"type": "string"
}
},
"required": [
"id",
"name",
"chinese",
"pinyin",
"meaning",
"mountain",
"direction",
"animal",
"clashingAnimal"
]
},
"suiPo": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"chinese": {
"type": "string"
},
"pinyin": {
"type": "string"
},
"meaning": {
"type": "string"
},
"mountain": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"chinese": {
"type": "string"
},
"pinyin": {
"type": "string"
},
"direction": {
"type": "string"
},
"yuan": {
"type": "string"
},
"polarity": {
"type": "string"
},
"startDegree": {
"type": "number"
},
"endDegree": {
"type": "number"
}
},
"required": [
"id",
"label",
"chinese",
"pinyin",
"direction",
"yuan",
"polarity",
"startDegree",
"endDegree"
]
},
"direction": {
"type": "string"
}
},
"required": [
"id",
"name",
"chinese",
"pinyin",
"meaning",
"mountain",
"direction"
]
},
"sanSha": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"chinese": {
"type": "string"
},
"pinyin": {
"type": "string"
},
"meaning": {
"type": "string"
},
"direction": {
"type": "string"
},
"frameElement": {
"type": "string"
},
"frameDirection": {
"type": "string"
},
"startDegree": {
"type": "number"
},
"endDegree": {
"type": "number"
},
"parts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"chinese": {
"type": "string"
},
"pinyin": {
"type": "string"
},
"meaning": {
"type": "string"
},
"mountain": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"chinese": {
"type": "string"
},
"pinyin": {
"type": "string"
},
"direction": {
"type": "string"
},
"yuan": {
"type": "string"
},
"polarity": {
"type": "string"
},
"startDegree": {
"type": "number"
},
"endDegree": {
"type": "number"
}
},
"required": [
"id",
"label",
"chinese",
"pinyin",
"direction",
"yuan",
"polarity",
"startDegree",
"endDegree"
]
}
},
"required": [
"id",
"name",
"chinese",
"pinyin",
"meaning",
"mountain"
]
}
}
},
"required": [
"id",
"name",
"chinese",
"pinyin",
"meaning",
"direction",
"frameElement",
"frameDirection",
"startDegree",
"endDegree",
"parts"
]
},
"fiveYellow": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"chinese": {
"type": "string"
},
"pinyin": {
"type": "string"
},
"meaning": {
"type": "string"
},
"palace": {
"type": "string"
},
"star": {
"type": "number"
},
"remedy": {
"type": "string"
}
},
"required": [
"id",
"name",
"chinese",
"pinyin",
"meaning",
"palace",
"star",
"remedy"
]
}
},
"required": [
"year",
"yearBranch",
"changeoverDate",
"taiSui",
"suiPo",
"sanSha",
"fiveYellow"
]
}🟢get_feng_shui_bagua(lang, limit, offset, compact)
The nine palaces of the compass Bagua map: the eight trigram sectors plus the centre, each with the life area it governs, its five phase, its colours, and both its Later Heaven and Earlier Heaven trigrams. This is the compass map aligned to true directions, so career is always North and wealth is always Southeast whichever way the entrance faces. Trigram details are served from the same source as the I-Ching trigram endpoints, so the two agree field for field. Built for floor plan overlays, room-by-room guides and any interface that maps a space onto life areas.
輸入結構描述
{
"type": "object",
"properties": {
"lang": {
"type": "string",
"description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.",
"enum": [
"en",
"tr",
"de",
"es",
"hi",
"pt",
"fr",
"ru",
"zh-Hans",
"zh-Hant"
],
"default": "en",
"example": "en"
},
"limit": {
"type": "integer",
"description": "Maximum items to return per page. Range: 1-9, default 9.",
"minimum": 1,
"maximum": 9,
"default": 9,
"example": 9
},
"offset": {
"type": "integer",
"description": "Number of items to skip for pagination. Default 0.",
"minimum": 0,
"default": 0,
"example": 0
},
"compact": {
"type": "boolean",
"description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.",
"default": false
}
},
"examples": [
{}
]
}輸出結構描述
{
"type": "object",
"properties": {
"total": {
"type": "number"
},
"limit": {
"type": "number"
},
"offset": {
"type": "number"
},
"sectors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"nameLocalized": {
"type": "string"
},
"number": {
"type": "number"
},
"palace": {
"type": "string"
},
"direction": {
"type": "string"
},
"element": {
"type": "string"
},
"colors": {
"type": "array",
"items": {
"type": "string"
}
},
"trigram": {
"type": "object",
"properties": {
"number": {
"type": "number"
},
"chinese": {
"type": "string"
},
"english": {
"type": "string"
},
"nameLocalized": {
"type": "string"
},
"pinyin": {
"type": "string"
},
"symbol": {
"type": "string"
},
"binary": {
"type": "string"
},
"element": {
"type": "string"
},
"elementLocalized": {
"type": "string"
},
"direction": {
"type": "string"
},
"directionLocalized": {
"type": "string"
},
"familyMember": {
"type": "string"
}
},
"required": [
"number",
"chinese",
"english",
"pinyin",
"symbol",
"binary",
"element",
"direction",
"familyMember"
]
},
"earlierHeavenTrigram": {
"type": "object",
"properties": {
"number": {
"type": "number"
},
"chinese": {
"type": "string"
},
"english": {
"type": "string"
},
"nameLocalized": {
"type": "string"
},
"pinyin": {
"type": "string"
},
"symbol": {
"type": "string"
},
"binary": {
"type": "string"
},
"element": {
"type": "string"
},
"elementLocalized": {
"type": "string"
},
"direction": {
"type": "string"
},
"directionLocalized": {
"type": "string"
},
"familyMember": {
"type": "string"
}
},
"required": [
"number",
"chinese",
"english",
"pinyin",
"symbol",
"binary",
"element",
"direction",
"familyMember"
]
},
"focus": {
"type": "string"
},
"meaning": {
"type": "string"
}
},
"required": [
"id",
"name",
"number",
"palace",
"element",
"colors",
"focus",
"meaning"
]
}
}
},
"required": [
"total",
"limit",
"offset",
"sectors"
]
}🟢get_feng_shui_bagua_id(id, lang, compact)
Look up one palace of the compass Bagua map by its life area id, such as wealth, career or love. Returns the compass sector it occupies, its five phase and colours, both trigram arrangements and what the sector governs. The health palace is the centre and carries no direction and no trigram, because the centre of the Lo Shu is not a trigram.
輸入結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Life area id. One of career, knowledge, family, wealth, fame, love, children, helpful-people, health.",
"enum": [
"career",
"knowledge",
"family",
"wealth",
"fame",
"love",
"children",
"helpful-people",
"health"
],
"example": "wealth"
},
"lang": {
"type": "string",
"description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.",
"enum": [
"en",
"tr",
"de",
"es",
"hi",
"pt",
"fr",
"ru",
"zh-Hans",
"zh-Hant"
],
"default": "en",
"example": "en"
},
"compact": {
"type": "boolean",
"description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.",
"default": false
}
},
"required": [
"id"
],
"examples": [
{
"id": "wealth"
}
]
}輸出結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"nameLocalized": {
"type": "string"
},
"number": {
"type": "number"
},
"palace": {
"type": "string"
},
"direction": {
"type": "string"
},
"element": {
"type": "string"
},
"colors": {
"type": "array",
"items": {
"type": "string"
}
},
"trigram": {
"type": "object",
"properties": {
"number": {
"type": "number"
},
"chinese": {
"type": "string"
},
"english": {
"type": "string"
},
"nameLocalized": {
"type": "string"
},
"pinyin": {
"type": "string"
},
"symbol": {
"type": "string"
},
"binary": {
"type": "string"
},
"element": {
"type": "string"
},
"elementLocalized": {
"type": "string"
},
"direction": {
"type": "string"
},
"directionLocalized": {
"type": "string"
},
"familyMember": {
"type": "string"
}
},
"required": [
"number",
"chinese",
"english",
"pinyin",
"symbol",
"binary",
"element",
"direction",
"familyMember"
]
},
"earlierHeavenTrigram": {
"type": "object",
"properties": {
"number": {
"type": "number"
},
"chinese": {
"type": "string"
},
"english": {
"type": "string"
},
"nameLocalized": {
"type": "string"
},
"pinyin": {
"type": "string"
},
"symbol": {
"type": "string"
},
"binary": {
"type": "string"
},
"element": {
"type": "string"
},
"elementLocalized": {
"type": "string"
},
"direction": {
"type": "string"
},
"directionLocalized": {
"type": "string"
},
"familyMember": {
"type": "string"
}
},
"required": [
"number",
"chinese",
"english",
"pinyin",
"symbol",
"binary",
"element",
"direction",
"familyMember"
]
},
"focus": {
"type": "string"
},
"meaning": {
"type": "string"
}
},
"required": [
"id",
"name",
"number",
"palace",
"element",
"colors",
"focus",
"meaning"
]
}🟢get_feng_shui_periods(lang, date, compact)
The nine twenty year periods of the 180 year San Yuan cycle from 1864 to 2043, each with its ruling star, five phase, palace and the exact Li Chun date it opened, plus which period is in force on a given date. A building takes the period it was completed in and keeps that period plate for life, so this is the table that decides which natal chart a property gets. Period 9 opened on 4 February 2024, which means a building finished in January 2024 is still a Period 8 building.
輸入結構描述
{
"type": "object",
"properties": {
"lang": {
"type": "string",
"description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.",
"enum": [
"en",
"tr",
"de",
"es",
"hi",
"pt",
"fr",
"ru",
"zh-Hans",
"zh-Hant"
],
"default": "en",
"example": "en"
},
"date": {
"type": "string",
"description": "Date to resolve the current period for, in YYYY-MM-DD format. Defaults to today in UTC. Useful for asking which period a building was completed in.",
"format": "date",
"example": "2026-08-23"
},
"compact": {
"type": "boolean",
"description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.",
"default": false
}
},
"examples": [
{}
]
}輸出結構描述
{
"type": "object",
"properties": {
"total": {
"type": "number"
},
"cycleStartYear": {
"type": "number"
},
"cycleEndYear": {
"type": "number"
},
"date": {
"type": "string"
},
"currentPeriod": {
"type": "number"
},
"periods": {
"type": "array",
"items": {
"type": "object",
"properties": {
"number": {
"type": "number"
},
"startYear": {
"type": "number"
},
"endYear": {
"type": "number"
},
"startDate": {
"type": "string"
},
"era": {
"type": "string"
},
"eraName": {
"type": "string"
},
"rulingStar": {
"type": "number"
},
"rulingStarName": {
"type": "string"
},
"rulingStarNameLocalized": {
"type": "string"
},
"element": {
"type": "string"
},
"palace": {
"type": "string"
},
"trigram": {
"type": "object",
"properties": {
"number": {
"type": "number"
},
"english": {
"type": "string"
},
"chinese": {
"type": "string"
}
},
"required": [
"number",
"english",
"chinese"
]
},
"base": {
"type": "number"
}
},
"required": [
"number",
"startYear",
"endYear",
"startDate",
"era",
"eraName",
"rulingStar",
"rulingStarName",
"element",
"palace",
"base"
]
}
}
},
"required": [
"total",
"cycleStartYear",
"cycleEndYear",
"date",
"currentPeriod",
"periods"
]
}社群
證據
近期觀測
已驗證未記錄版本11 個工具
已驗證未記錄版本11 個工具