Servidor MCP

Feng Shui MCP Server by RoxyAPI

com.roxyapi/feng-shui
Otros Público y accesible MCP 2025-11-25

Qué hace este MCP

Provides feng shui reference data and calculations for Kua numbers, Eight Mansions, Bagua sectors, annual afflictions, and flying-star charts.

get_feng_shui_afflictions_year
Annual afflictions - Tai Sui, San Sha and Five Yellow API
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.
Solo lectura
Esquema de entrada
{'type': 'object', 'examples': [{'year': 2026}], 'required': ['year'], 'properties': {'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', '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.'}, 'year': {'type': 'integer', 'example': 2026, 'maximum': 2100, 'minimum': 1900, '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.'}, 'compact': {'type': 'boolean', 'default': False, '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.'}}}
Esquema de salida
{'type': 'object', 'required': ['year', 'yearBranch', 'changeoverDate', 'taiSui', 'suiPo', 'sanSha', 'fiveYellow'], 'properties': {'year': {'type': 'number'}, 'suiPo': {'type': 'object', 'required': ['id', 'name', 'chinese', 'pinyin', 'meaning', 'mountain', 'direction'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'pinyin': {'type': 'string'}, 'chinese': {'type': 'string'}, 'meaning': {'type': 'string'}, 'mountain': {'type': 'object', 'required': ['id', 'label', 'chinese', 'pinyin', 'direction', 'yuan', 'polarity', 'startDegree', 'endDegree'], 'properties': {'id': {'type': 'string'}, 'yuan': {'type': 'string'}, 'label': {'type': 'string'}, 'pinyin': {'type': 'string'}, 'chinese': {'type': 'string'}, 'polarity': {'type': 'string'}, 'direction': {'type': 'string'}, 'endDegree': {'type': 'number'}, 'startDegree': {'type': 'number'}}}, 'direction': {'type': 'string'}}}, 'sanSha': {'type': 'object', 'required': ['id', 'name', 'chinese', 'pinyin', 'meaning', 'direction', 'frameElement', 'frameDirection', 'startDegree', 'endDegree', 'parts'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'parts': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'chinese', 'pinyin', 'meaning', 'mountain'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'pinyin': {'type': 'string'}, 'chinese': {'type': 'string'}, 'meaning': {'type': 'string'}, 'mountain': {'type': 'object', 'required': ['id', 'label', 'chinese', 'pinyin', 'direction', 'yuan', 'polarity', 'startDegree', 'endDegree'], 'properties': {'id': {'type': 'string'}, 'yuan': {'type': 'string'}, 'label': {'type': 'string'}, 'pinyin': {'type': 'string'}, 'chinese': {'type': 'string'}, 'polarity': {'type': 'string'}, 'direction': {'type': 'string'}, 'endDegree': {'type': 'number'}, 'startDegree': {'type': 'number'}}}}}}, 'pinyin': {'type': 'string'}, 'chinese': {'type': 'string'}, 'meaning': {'type': 'string'}, 'direction': {'type': 'string'}, 'endDegree': {'type': 'number'}, 'startDegree': {'type': 'number'}, 'frameElement': {'type': 'string'}, 'frameDirection': {'type': 'string'}}}, 'taiSui': {'type': 'object', 'required': ['id', 'name', 'chinese', 'pinyin', 'meaning', 'mountain', 'direction', 'animal', 'clashingAnimal'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'animal': {'type': 'string'}, 'pinyin': {'type': 'string'}, 'chinese': {'type': 'string'}, 'meaning': {'type': 'string'}, 'mountain': {'type': 'object', 'required': ['id', 'label', 'chinese', 'pinyin', 'direction', 'yuan', 'polarity', 'startDegree', 'endDegree'], 'properties': {'id': {'type': 'string'}, 'yuan': {'type': 'string'}, 'label': {'type': 'string'}, 'pinyin': {'type': 'string'}, 'chinese': {'type': 'string'}, 'polarity': {'type': 'string'}, 'direction': {'type': 'string'}, 'endDegree': {'type': 'number'}, 'startDegree': {'type': 'number'}}}, 'direction': {'type': 'string'}, 'clashingAnimal': {'type': 'string'}}}, 'fiveYellow': {'type': 'object', 'required': ['id', 'name', 'chinese', 'pinyin', 'meaning', 'palace', 'star', 'remedy'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'star': {'type': 'number'}, 'palace': {'type': 'string'}, 'pinyin': {'type': 'string'}, 'remedy': {'type': 'string'}, 'chinese': {'type': 'string'}, 'meaning': {'type': 'string'}}}, 'yearBranch': {'type': 'string'}, 'changeoverDate': {'type': 'string'}}}
get_feng_shui_bagua
List Bagua sectors - Feng shui bagua map API
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.
Solo lectura
Esquema de entrada
{'type': 'object', 'examples': [{}], 'properties': {'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', '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.'}, 'limit': {'type': 'integer', 'default': 9, 'example': 9, 'maximum': 9, 'minimum': 1, 'description': 'Maximum items to return per page. Range: 1-9, default 9.'}, 'offset': {'type': 'integer', 'default': 0, 'example': 0, 'minimum': 0, 'description': 'Number of items to skip for pagination. Default 0.'}, 'compact': {'type': 'boolean', 'default': False, '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.'}}}
Esquema de salida
{'type': 'object', 'required': ['total', 'limit', 'offset', 'sectors'], 'properties': {'limit': {'type': 'number'}, 'total': {'type': 'number'}, 'offset': {'type': 'number'}, 'sectors': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'number', 'palace', 'element', 'colors', 'focus', 'meaning'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'focus': {'type': 'string'}, 'colors': {'type': 'array', 'items': {'type': 'string'}}, 'number': {'type': 'number'}, 'palace': {'type': 'string'}, 'element': {'type': 'string'}, 'meaning': {'type': 'string'}, 'trigram': {'type': 'object', 'required': ['number', 'chinese', 'english', 'pinyin', 'symbol', 'binary', 'element', 'direction', 'familyMember'], 'properties': {'binary': {'type': 'string'}, 'number': {'type': 'number'}, 'pinyin': {'type': 'string'}, 'symbol': {'type': 'string'}, 'chinese': {'type': 'string'}, 'element': {'type': 'string'}, 'english': {'type': 'string'}, 'direction': {'type': 'string'}, 'familyMember': {'type': 'string'}, 'nameLocalized': {'type': 'string'}, 'elementLocalized': {'type': 'string'}, 'directionLocalized': {'type': 'string'}}}, 'direction': {'type': 'string'}, 'nameLocalized': {'type': 'string'}, 'earlierHeavenTrigram': {'type': 'object', 'required': ['number', 'chinese', 'english', 'pinyin', 'symbol', 'binary', 'element', 'direction', 'familyMember'], 'properties': {'binary': {'type': 'string'}, 'number': {'type': 'number'}, 'pinyin': {'type': 'string'}, 'symbol': {'type': 'string'}, 'chinese': {'type': 'string'}, 'element': {'type': 'string'}, 'english': {'type': 'string'}, 'direction': {'type': 'string'}, 'familyMember': {'type': 'string'}, 'nameLocalized': {'type': 'string'}, 'elementLocalized': {'type': 'string'}, 'directionLocalized': {'type': 'string'}}}}}}}}
get_feng_shui_bagua_id
Look up a Bagua sector - Life area reference API
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.
Solo lectura
Esquema de entrada
{'type': 'object', 'examples': [{'id': 'wealth'}], 'required': ['id'], 'properties': {'id': {'enum': ['career', 'knowledge', 'family', 'wealth', 'fame', 'love', 'children', 'helpful-people', 'health'], 'type': 'string', 'example': 'wealth', 'description': 'Life area id. One of career, knowledge, family, wealth, fame, love, children, helpful-people, health.'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', '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.'}, 'compact': {'type': 'boolean', 'default': False, '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.'}}}
Esquema de salida
{'type': 'object', 'required': ['id', 'name', 'number', 'palace', 'element', 'colors', 'focus', 'meaning'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'focus': {'type': 'string'}, 'colors': {'type': 'array', 'items': {'type': 'string'}}, 'number': {'type': 'number'}, 'palace': {'type': 'string'}, 'element': {'type': 'string'}, 'meaning': {'type': 'string'}, 'trigram': {'type': 'object', 'required': ['number', 'chinese', 'english', 'pinyin', 'symbol', 'binary', 'element', 'direction', 'familyMember'], 'properties': {'binary': {'type': 'string'}, 'number': {'type': 'number'}, 'pinyin': {'type': 'string'}, 'symbol': {'type': 'string'}, 'chinese': {'type': 'string'}, 'element': {'type': 'string'}, 'english': {'type': 'string'}, 'direction': {'type': 'string'}, 'familyMember': {'type': 'string'}, 'nameLocalized': {'type': 'string'}, 'elementLocalized': {'type': 'string'}, 'directionLocalized': {'type': 'string'}}}, 'direction': {'type': 'string'}, 'nameLocalized': {'type': 'string'}, 'earlierHeavenTrigram': {'type': 'object', 'required': ['number', 'chinese', 'english', 'pinyin', 'symbol', 'binary', 'element', 'direction', 'familyMember'], 'properties': {'binary': {'type': 'string'}, 'number': {'type': 'number'}, 'pinyin': {'type': 'string'}, 'symbol': {'type': 'string'}, 'chinese': {'type': 'string'}, 'element': {'type': 'string'}, 'english': {'type': 'string'}, 'direction': {'type': 'string'}, 'familyMember': {'type': 'string'}, 'nameLocalized': {'type': 'string'}, 'elementLocalized': {'type': 'string'}, 'directionLocalized': {'type': 'string'}}}}}
get_feng_shui_flying_stars
List the nine flying stars - Xuan Kong star reference API
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.
Solo lectura
Esquema de entrada
{'type': 'object', 'examples': [{}], 'properties': {'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', '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.'}, 'limit': {'type': 'integer', 'default': 9, 'example': 9, 'maximum': 9, 'minimum': 1, 'description': 'Maximum items to return per page. Range: 1-9, default 9.'}, 'offset': {'type': 'integer', 'default': 0, 'example': 0, 'minimum': 0, 'description': 'Number of items to skip for pagination. Default 0.'}, 'compact': {'type': 'boolean', 'default': False, '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.'}}}
Esquema de salida
{'type': 'object', 'required': ['total', 'limit', 'offset', 'stars'], 'properties': {'limit': {'type': 'number'}, 'stars': {'type': 'array', 'items': {'type': 'object', 'required': ['number', 'name', 'chinese', 'pinyin', 'element', 'nature', 'keywords', 'meaning', 'enhancer', 'remedy', 'palace', 'period', 'base'], 'properties': {'base': {'type': 'number'}, 'name': {'type': 'string'}, 'nature': {'type': 'string'}, 'number': {'type': 'number'}, 'palace': {'type': 'string'}, 'period': {'type': 'number'}, 'pinyin': {'type': 'string'}, 'remedy': {'type': 'string'}, 'chinese': {'type': 'string'}, 'element': {'type': 'string'}, 'meaning': {'type': 'string'}, 'trigram': {'type': 'object', 'required': ['number', 'english', 'chinese'], 'properties': {'number': {'type': 'number'}, 'chinese': {'type': 'string'}, 'english': {'type': 'string'}}}, 'enhancer': {'type': 'string'}, 'keywords': {'type': 'array', 'items': {'type': 'string'}}, 'nameLocalized': {'type': 'string'}}}}, 'total': {'type': 'number'}, 'offset': {'type': 'number'}}}
get_feng_shui_flying_stars_annual_year
Annual flying stars - Yearly feng shui star chart API
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.
Solo lectura
Esquema de entrada
{'type': 'object', 'examples': [{'year': 2026}], 'required': ['year'], 'properties': {'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', '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.'}, 'year': {'type': 'integer', 'example': 2026, 'maximum': 2100, 'minimum': 1900, '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.'}, 'compact': {'type': 'boolean', 'default': False, '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.'}}}
Esquema de salida
{'type': 'object', 'required': ['year', 'centerStar', 'changeoverDate', 'palaces'], 'properties': {'year': {'type': 'number'}, 'palaces': {'type': 'array', 'items': {'type': 'object', 'required': ['palace', 'star', 'name', 'element', 'nature', 'enhancer', 'remedy', 'meaning'], 'properties': {'name': {'type': 'string'}, 'star': {'type': 'number'}, 'nature': {'type': 'string'}, 'palace': {'type': 'string'}, 'remedy': {'type': 'string'}, 'element': {'type': 'string'}, 'meaning': {'type': 'string'}, 'enhancer': {'type': 'string'}, 'nameLocalized': {'type': 'string'}}}}, 'centerStar': {'type': 'number'}, 'changeoverDate': {'type': 'string'}}}
get_feng_shui_flying_stars_monthly
Monthly flying stars - Month by month feng shui overlay API
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.
Solo lectura
Esquema de entrada
{'type': 'object', 'examples': [{}], 'properties': {'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', '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.'}, 'year': {'type': 'integer', 'example': 2026, 'maximum': 2100, 'minimum': 1900, 'description': 'Solar year, 1900 to 2100. Defaults to the solar year in progress, which changes at Li Chun rather than on 1 January.'}, 'month': {'type': 'integer', 'example': 1, 'maximum': 12, 'minimum': 1, '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.'}, 'compact': {'type': 'boolean', 'default': False, '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.'}}}
Esquema de salida
{'type': 'object', 'required': ['year', 'month', 'centerStar', 'yearBranch', 'palaces'], 'properties': {'year': {'type': 'number'}, 'month': {'type': 'number'}, 'palaces': {'type': 'array', 'items': {'type': 'object', 'required': ['palace', 'star', 'name', 'element', 'nature', 'enhancer', 'remedy', 'meaning'], 'properties': {'name': {'type': 'string'}, 'star': {'type': 'number'}, 'nature': {'type': 'string'}, 'palace': {'type': 'string'}, 'remedy': {'type': 'string'}, 'element': {'type': 'string'}, 'meaning': {'type': 'string'}, 'enhancer': {'type': 'string'}, 'nameLocalized': {'type': 'string'}}}}, 'centerStar': {'type': 'number'}, 'yearBranch': {'type': 'string'}}}
get_feng_shui_kua_number
Look up a Kua number - Eight Mansions reference API
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.
Solo lectura
Esquema de entrada
{'type': 'object', 'examples': [{'number': 8}], 'required': ['number'], 'properties': {'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', '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.'}, 'number': {'type': 'integer', 'example': 8, 'maximum': 9, 'minimum': 1, 'description': 'Kua number, 1 to 9.'}, 'compact': {'type': 'boolean', 'default': False, '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.'}}}
Esquema de salida
{'type': 'object', 'required': ['number', 'group', 'trigram', 'sectors'], 'properties': {'group': {'type': 'string'}, 'number': {'type': 'number'}, 'sectors': {'type': 'array', 'items': {'type': 'object', 'required': ['direction', 'star', 'starName', 'nature', 'rank', 'domain'], 'properties': {'rank': {'type': 'number'}, 'star': {'type': 'string'}, 'domain': {'type': 'string'}, 'nature': {'type': 'string'}, 'starName': {'type': 'string'}, 'direction': {'type': 'string'}, 'starNameLocalized': {'type': 'string'}}}}, 'trigram': {'type': 'object', 'required': ['number', 'chinese', 'english', 'pinyin', 'symbol', 'binary', 'element', 'direction', 'familyMember'], 'properties': {'binary': {'type': 'string'}, 'number': {'type': 'number'}, 'pinyin': {'type': 'string'}, 'symbol': {'type': 'string'}, 'chinese': {'type': 'string'}, 'element': {'type': 'string'}, 'english': {'type': 'string'}, 'direction': {'type': 'string'}, 'familyMember': {'type': 'string'}, 'nameLocalized': {'type': 'string'}, 'elementLocalized': {'type': 'string'}, 'directionLocalized': {'type': 'string'}}}}}
get_feng_shui_periods
List the nine periods - San Yuan period table API
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.
Solo lectura
Esquema de entrada
{'type': 'object', 'examples': [{}], 'properties': {'date': {'type': 'string', 'format': 'date', 'example': '2026-08-23', '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. A date landing exactly on the Li Chun day a period opens is placed in the outgoing period.'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', '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.'}, 'compact': {'type': 'boolean', 'default': False, '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.'}}}
Esquema de salida
{'type': 'object', 'required': ['total', 'cycleStartYear', 'cycleEndYear', 'date', 'currentPeriod', 'periods'], 'properties': {'date': {'type': 'string'}, 'total': {'type': 'number'}, 'periods': {'type': 'array', 'items': {'type': 'object', 'required': ['number', 'startYear', 'endYear', 'startDate', 'era', 'eraName', 'rulingStar', 'rulingStarName', 'element', 'palace', 'base'], 'properties': {'era': {'type': 'string'}, 'base': {'type': 'number'}, 'number': {'type': 'number'}, 'palace': {'type': 'string'}, 'element': {'type': 'string'}, 'endYear': {'type': 'number'}, 'eraName': {'type': 'string'}, 'trigram': {'type': 'object', 'required': ['number', 'english', 'chinese'], 'properties': {'number': {'type': 'number'}, 'chinese': {'type': 'string'}, 'english': {'type': 'string'}}}, 'startDate': {'type': 'string'}, 'startYear': {'type': 'number'}, 'rulingStar': {'type': 'number'}, 'rulingStarName': {'type': 'string'}, 'rulingStarNameLocalized': {'type': 'string'}}}}, 'cycleEndYear': {'type': 'number'}, 'currentPeriod': {'type': 'number'}, 'cycleStartYear': {'type': 'number'}}}
post_feng_shui_eight_mansions
Generate Eight Mansions map - Ba Zhai lucky direction API
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.
Solo lectura
Esquema de entrada
{'type': 'object', 'examples': [{}], 'properties': {'kua': {'type': 'number', 'example': 6, 'maximum': 9, 'minimum': 1, '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.'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', '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.'}, 'facing': {'enum': ['North', 'Northeast', 'East', 'Southeast', 'South', 'Southwest', 'West', 'Northwest'], 'type': 'string', '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.'}, 'gender': {'enum': ['male', 'female'], 'type': 'string', 'example': 'male', 'description': 'Selects the Kua formula variant. Required when the Kua is being derived from a birth date.'}, 'compact': {'type': 'boolean', 'default': False, '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.'}, 'yearBoundary': {'enum': ['li-chun', 'lunar-new-year'], 'type': 'string', '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.'}}}
Esquema de salida
{'type': 'object', 'required': ['kua', 'group', 'trigram', 'sectors', 'bestSector', 'worstSector', 'conventions'], 'properties': {'kua': {'type': 'number'}, 'group': {'type': 'string'}, 'sectors': {'type': 'array', 'items': {'type': 'object', 'required': ['direction', 'star', 'starName', 'chinese', 'pinyin', 'nature', 'rank', 'domain', 'trigram', 'reading'], 'properties': {'rank': {'type': 'number'}, 'star': {'type': 'string'}, 'domain': {'type': 'string'}, 'nature': {'type': 'string'}, 'pinyin': {'type': 'string'}, 'chinese': {'type': 'string'}, 'reading': {'type': 'string'}, 'trigram': {'type': 'object', 'required': ['number', 'chinese', 'english', 'pinyin', 'symbol', 'binary', 'element', 'direction', 'familyMember'], 'properties': {'binary': {'type': 'string'}, 'number': {'type': 'number'}, 'pinyin': {'type': 'string'}, 'symbol': {'type': 'string'}, 'chinese': {'type': 'string'}, 'element': {'type': 'string'}, 'english': {'type': 'string'}, 'direction': {'type': 'string'}, 'familyMember': {'type': 'string'}, 'nameLocalized': {'type': 'string'}, 'elementLocalized': {'type': 'string'}, 'directionLocalized': {'type': 'string'}}}, 'starName': {'type': 'string'}, 'direction': {'type': 'string'}, 'starNameLocalized': {'type': 'string'}}}}, 'trigram': {'type': 'object', 'required': ['number', 'chinese', 'english', 'pinyin', 'symbol', 'binary', 'element', 'direction', 'familyMember'], 'properties': {'binary': {'type': 'string'}, 'number': {'type': 'number'}, 'pinyin': {'type': 'string'}, 'symbol': {'type': 'string'}, 'chinese': {'type': 'string'}, 'element': {'type': 'string'}, 'english': {'type': 'string'}, 'direction': {'type': 'string'}, 'familyMember': {'type': 'string'}, 'nameLocalized': {'type': 'string'}, 'elementLocalized': {'type': 'string'}, 'directionLocalized': {'type': 'string'}}}, 'bestSector': {'type': 'string'}, 'conventions': {'type': 'object', 'required': ['yearBoundary'], 'properties': {'yearBoundary': {'type': 'string'}}}, 'worstSector': {'type': 'string'}, 'facingSector': {'type': 'object', 'required': ['direction', 'star', 'nature'], 'properties': {'star': {'type': 'string'}, 'nature': {'type': 'string'}, 'direction': {'type': 'string'}}}}}
post_feng_shui_flying_stars_natal
Generate flying star natal chart - Xuan Kong Fei Xing API
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.
Solo lectura
Esquema de entrada
{'type': 'object', 'examples': [{}], 'properties': {'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', '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.'}, 'facing': {'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'], 'type': 'string', '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.'}, 'period': {'type': 'integer', 'example': 9, 'maximum': 9, 'minimum': 1, '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.'}, 'compact': {'type': 'boolean', 'default': False, '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.'}, 'facingDegrees': {'type': ['number', 'null'], 'example': 180, 'maximum': 360, 'minimum': 0, '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.'}}}
Esquema de salida
{'type': 'object', 'required': ['period', 'facing', 'sitting', 'straddling', 'mountainCenterStar', 'waterCenterStar', 'mountainFlight', 'waterFlight', 'structure', 'palaces'], 'properties': {'facing': {'type': 'object', 'required': ['id', 'label', 'chinese', 'pinyin', 'direction', 'yuan', 'polarity', 'startDegree', 'endDegree'], 'properties': {'id': {'type': 'string'}, 'yuan': {'type': 'string'}, 'label': {'type': 'string'}, 'pinyin': {'type': 'string'}, 'chinese': {'type': 'string'}, 'polarity': {'type': 'string'}, 'direction': {'type': 'string'}, 'endDegree': {'type': 'number'}, 'startDegree': {'type': 'number'}}}, 'period': {'type': 'number'}, 'palaces': {'type': 'array', 'items': {'type': 'object', 'required': ['palace', 'base', 'period', 'mountain', 'water', 'reading'], 'properties': {'base': {'type': 'number'}, 'water': {'type': 'number'}, 'palace': {'type': 'string'}, 'period': {'type': 'number'}, 'reading': {'type': 'string'}, 'mountain': {'type': 'number'}, 'combination': {'type': 'object', 'required': ['id', 'name', 'nature'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'nature': {'type': 'string'}, 'chinese': {'type': 'string'}, 'nameLocalized': {'type': 'string'}}}}}}, 'sitting': {'type': 'object', 'required': ['id', 'label', 'chinese', 'pinyin', 'direction', 'yuan', 'polarity', 'startDegree', 'endDegree'], 'properties': {'id': {'type': 'string'}, 'yuan': {'type': 'string'}, 'label': {'type': 'string'}, 'pinyin': {'type': 'string'}, 'chinese': {'type': 'string'}, 'polarity': {'type': 'string'}, 'direction': {'type': 'string'}, 'endDegree': {'type': 'number'}, 'startDegree': {'type': 'number'}}}, 'structure': {'type': 'object', 'required': ['id', 'name', 'chinese', 'meaning'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'chinese': {'type': 'string'}, 'meaning': {'type': 'string'}}}, 'straddling': {'type': 'boolean'}, 'waterFlight': {'type': 'string'}, 'facingDegrees': {'type': 'number'}, 'mountainFlight': {'type': 'string'}, 'waterCenterStar': {'type': 'number'}, 'mountainCenterStar': {'type': 'number'}}}
post_feng_shui_kua
Calculate Kua number - Feng shui personal direction calculator API
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.
Solo lectura
Esquema de entrada
{'type': 'object', 'examples': [{'date': '1985-07-15', 'gender': 'male'}], 'required': ['date', 'gender'], 'properties': {'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.'}, 'lang': {'enum': ['en', 'tr', 'de', 'es', 'hi', 'pt', 'fr', 'ru', 'zh-Hans', 'zh-Hant'], 'type': 'string', 'default': 'en', 'example': 'en', '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.'}, 'gender': {'enum': ['male', 'female'], 'type': 'string', '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.'}, 'compact': {'type': 'boolean', 'default': False, '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.'}, 'yearBoundary': {'enum': ['li-chun', 'lunar-new-year'], 'type': 'string', '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.'}}}
Esquema de salida
{'type': 'object', 'required': ['kua', 'rawKua', 'reassigned', 'gender', 'group', 'solarYear', 'boundaryDate', 'trigram', 'sectors', 'conventions'], 'properties': {'kua': {'type': 'number'}, 'group': {'type': 'string'}, 'gender': {'type': 'string'}, 'rawKua': {'type': 'number'}, 'sectors': {'type': 'array', 'items': {'type': 'object', 'required': ['direction', 'star', 'starName', 'nature', 'rank', 'domain'], 'properties': {'rank': {'type': 'number'}, 'star': {'type': 'string'}, 'domain': {'type': 'string'}, 'nature': {'type': 'string'}, 'starName': {'type': 'string'}, 'direction': {'type': 'string'}, 'starNameLocalized': {'type': 'string'}}}}, 'trigram': {'type': 'object', 'required': ['number', 'chinese', 'english', 'pinyin', 'symbol', 'binary', 'element', 'direction', 'familyMember'], 'properties': {'binary': {'type': 'string'}, 'number': {'type': 'number'}, 'pinyin': {'type': 'string'}, 'symbol': {'type': 'string'}, 'chinese': {'type': 'string'}, 'element': {'type': 'string'}, 'english': {'type': 'string'}, 'direction': {'type': 'string'}, 'familyMember': {'type': 'string'}, 'nameLocalized': {'type': 'string'}, 'elementLocalized': {'type': 'string'}, 'directionLocalized': {'type': 'string'}}}, 'solarYear': {'type': 'number'}, 'reassigned': {'type': 'boolean'}, 'conventions': {'type': 'object', 'required': ['yearBoundary'], 'properties': {'yearBoundary': {'type': 'string'}}}, 'boundaryDate': {'type': 'string'}}}
Modificado
get_feng_shui_periods
1 de October de 2026 a las 02:54
Modificado
get_feng_shui_bagua
25 de September de 2026 a las 03:03
Modificado
get_feng_shui_flying_stars
25 de September de 2026 a las 03:03
Modificado
get_feng_shui_periods
21 de September de 2026 a las 03:01
Modificado
get_feng_shui_bagua_id
21 de September de 2026 a las 03:01
Modificado
get_feng_shui_bagua
21 de September de 2026 a las 03:01
Modificado
get_feng_shui_afflictions_year
21 de September de 2026 a las 03:01
Modificado
get_feng_shui_flying_stars
21 de September de 2026 a las 03:01
Modificado
get_feng_shui_flying_stars_monthly
21 de September de 2026 a las 03:01
Modificado
get_feng_shui_flying_stars_annual_year
21 de September de 2026 a las 03:01
Modificado
post_feng_shui_flying_stars_natal
21 de September de 2026 a las 03:01
Modificado
post_feng_shui_eight_mansions
21 de September de 2026 a las 03:01
Modificado
get_feng_shui_kua_number
21 de September de 2026 a las 03:01
Modificado
post_feng_shui_kua
21 de September de 2026 a las 03:01
Añadido
get_feng_shui_periods
17 de September de 2026 a las 12:37
Añadido
get_feng_shui_bagua_id
17 de September de 2026 a las 12:37
Añadido
get_feng_shui_bagua
17 de September de 2026 a las 12:37
Añadido
get_feng_shui_afflictions_year
17 de September de 2026 a las 12:37
Añadido
get_feng_shui_flying_stars
17 de September de 2026 a las 12:37
Añadido
get_feng_shui_flying_stars_monthly
17 de September de 2026 a las 12:37
Añadido
get_feng_shui_flying_stars_annual_year
17 de September de 2026 a las 12:37
Añadido
post_feng_shui_flying_stars_natal
17 de September de 2026 a las 12:37
Añadido
post_feng_shui_eight_mansions
17 de September de 2026 a las 12:37
Añadido
get_feng_shui_kua_number
17 de September de 2026 a las 12:37
Añadido
post_feng_shui_kua
17 de September de 2026 a las 12:37