# Feng Shui MCP Server by RoxyAPI (remote · roxyapi.com)

Kua numbers, Eight Mansions, Flying Star charts and annual afflictions for AI agents.

- Trust score: 85/100 (high trust)
- Change this week: +2
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-20

## Components

- remote · `roxyapi.com`: 85/100 (this document), [markdown](https://verifymcp.io/servers/com-roxyapi-feng-shui/mcp-feng-shui.md), [page](https://verifymcp.io/servers/com-roxyapi-feng-shui/mcp-feng-shui)

## Channel facts

- Endpoint: `https://roxyapi.com/mcp/feng-shui`
- Transports: `streamable-http`
- Auth: `required`
- Version: `1.0.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-20.

- **Endpoint Security**: 80/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 79/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 3596 tokens (~326/item across 11 items; 11 tools + 0 resources), over budget; trim descriptions and params.
  - Tools include usage examples.
- **Stability & Change Management**: 78/100
  - Stability check failed: schema churn in the 25 days we've observed: 0 tool removals, 1 breaking changes, 0 auth/transport breaks, 0 additions.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 11 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 11 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the Feng Shui MCP Server by RoxyAPI server?

Feng Shui MCP Server by RoxyAPI is a hosted endpoint at https://roxyapi.com/mcp/feng-shui, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http com-roxyapi-feng-shui 'https://roxyapi.com/mcp/feng-shui'
```

### Cursor

```json
{
  "mcpServers": {
    "com-roxyapi-feng-shui": {
      "url": "https://roxyapi.com/mcp/feng-shui"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "com-roxyapi-feng-shui": {
      "type": "http",
      "url": "https://roxyapi.com/mcp/feng-shui"
    }
  }
}
```

### Codex

```toml
[mcp_servers.com-roxyapi-feng-shui]
url = "https://roxyapi.com/mcp/feng-shui"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "com-roxyapi-feng-shui": {
      "type": "remote",
      "url": "https://roxyapi.com/mcp/feng-shui",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add com-roxyapi-feng-shui --url 'https://roxyapi.com/mcp/feng-shui' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  com-roxyapi-feng-shui:
    url: "https://roxyapi.com/mcp/feng-shui"
```

### Netclaw

```json
{
  "McpServers": {
    "com-roxyapi-feng-shui": {
      "Transport": "http",
      "Url": "https://roxyapi.com/mcp/feng-shui"
    }
  }
}
```

### Vellum

```bash
assistant mcp add com-roxyapi-feng-shui -t streamable-http -u 'https://roxyapi.com/mcp/feng-shui'
```

### Other

```json
{
  "mcpServers": {
    "com-roxyapi-feng-shui": {
      "type": "http",
      "url": "https://roxyapi.com/mcp/feng-shui"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-20 (score 85, 0)

- [security regression] Stability: 0.80 → fail
- [security regression] A breaking change shipped without a version bump: still 2.0.0
- [functional regression] “get_feng_shui_kua_number” changed the type of “number”: number → integer

### 2026-09-18 (score 85, +1)

No change was recorded against any check on this day. Stability & Change Management went from 73 to 77. That category is still filling its 30-day observation window: 22 days of observed history at the previous scan, 23 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-15 (score 84, +1)

No change was recorded against any check on this day. Stability & Change Management went from 63 to 67. That category is still filling its 30-day observation window: 19 days of observed history at the previous scan, 20 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-13 (score 83, +1)

No change was recorded against any check on this day. Stability & Change Management went from 57 to 60. That category is still filling its 30-day observation window: 17 days of observed history at the previous scan, 18 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-11 (score 82, +1)

No change was recorded against any check on this day. Stability & Change Management went from 50 to 53. That category is still filling its 30-day observation window: 15 days of observed history at the previous scan, 16 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-09 (score 81, +1)

No change was recorded against any check on this day. Stability & Change Management went from 43 to 47. That category is still filling its 30-day observation window: 13 days of observed history at the previous scan, 14 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-07 (score 80, +1)

No change was recorded against any check on this day. Stability & Change Management went from 37 to 40. That category is still filling its 30-day observation window: 11 days of observed history at the previous scan, 12 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-06 (score 79, 0)

- [cosmetic] “get_feng_shui_bagua” reworded the description of “limit”
- [cosmetic] “get_feng_shui_bagua” reworded the description of “offset”
- [cosmetic] “get_feng_shui_flying_stars” reworded the description of “limit”
- [cosmetic] “get_feng_shui_flying_stars” reworded the description of “offset”

## MCP tools (11)

### `post_feng_shui_kua` (~469 tokens)

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.

Input parameters:

- `compact` (boolean): 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.
- `date` (string, required): 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…
- `gender` (string, required): 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.
- `lang` (string): 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 E…
- `yearBoundary` (string): 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 a…

### `get_feng_shui_kua_number` (~260 tokens)

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.

Input parameters:

- `compact` (boolean): 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.
- `lang` (string): 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 E…
- `number` (integer, required): Kua number, 1 to 9.

### `post_feng_shui_eight_mansions` (~506 tokens)

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.

Input parameters:

- `compact` (boolean): 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.
- `date` (string): 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…
- `facing` (string): 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…
- `gender` (string): Selects the Kua formula variant. Required when the Kua is being derived from a birth date.
- `kua` (number): 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.
- `lang` (string): 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 E…
- `yearBoundary` (string): 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.

### `post_feng_shui_flying_stars_natal` (~422 tokens)

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.

Input parameters:

- `compact` (boolean): 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.
- `facing` (string): 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…
- `facingDegrees` (number|null): 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.
- `lang` (string): 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 E…
- `period` (integer): 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. Peri…

### `get_feng_shui_flying_stars_annual_year` (~269 tokens)

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.

Input parameters:

- `compact` (boolean): 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.
- `lang` (string): 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 E…
- `year` (integer, required): 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.

### `get_feng_shui_flying_stars_monthly` (~315 tokens)

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.

Input parameters:

- `compact` (boolean): 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.
- `lang` (string): 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 E…
- `month` (integer): 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.
- `year` (integer): Solar year, 1900 to 2100. Defaults to the solar year in progress, which changes at Li Chun rather than on 1 January.

### `get_feng_shui_flying_stars` (~253 tokens)

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.

Input parameters:

- `compact` (boolean): 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.
- `lang` (string): 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 E…
- `limit` (integer): Maximum items to return per page. Range: 1-9, default 9.
- `offset` (integer|null): Number of items to skip for pagination. Default 0.

### `get_feng_shui_afflictions_year` (~301 tokens)

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.

Input parameters:

- `compact` (boolean): 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.
- `lang` (string): 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 E…
- `year` (integer, required): 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.

### `get_feng_shui_bagua` (~289 tokens)

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.

Input parameters:

- `compact` (boolean): 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.
- `lang` (string): 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 E…
- `limit` (integer): Maximum items to return per page. Range: 1-9, default 9.
- `offset` (integer|null): Number of items to skip for pagination. Default 0.

### `get_feng_shui_bagua_id` (~235 tokens)

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.

Input parameters:

- `compact` (boolean): 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.
- `id` (string, required): Life area id. One of career, knowledge, family, wealth, fame, love, children, helpful-people, health.
- `lang` (string): 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 E…

### `get_feng_shui_periods` (~277 tokens)

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.

Input parameters:

- `compact` (boolean): 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.
- `date` (string): 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.
- `lang` (string): 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 E…

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/com-roxyapi-feng-shui/mcp-feng-shui#diagnostics

## Score history

- 2026-09-20: 85
- 2026-09-19: 85
- 2026-09-18: 85
- 2026-09-17: 84
- 2026-09-16: 84
- 2026-09-15: 84
- 2026-09-14: 83
- 2026-09-13: 83
- 2026-09-12: 82
- 2026-09-11: 82
- 2026-09-10: 81
- 2026-09-09: 81
- 2026-09-08: 80
- 2026-09-07: 80
- 2026-09-06: 79
- 2026-09-05: 79
- 2026-09-04: 78
- 2026-09-03: 78
- 2026-09-02: 77
- 2026-09-01: 77
- 2026-08-31: 76
- 2026-08-30: 76
- 2026-08-29: 75
- 2026-08-28: 75
- 2026-08-27: 74
- 2026-08-26: 74

## Common questions

### What is the Feng Shui MCP Server by RoxyAPI server?

Feng Shui MCP Server by RoxyAPI is listed in the public MCP registry as com.roxyapi/feng-shui. Kua numbers, Eight Mansions, Flying Star charts and annual afflictions for AI agents. This page covers its hosted endpoint (https://roxyapi.com/mcp/feng-shui).

### Is the Feng Shui MCP Server by RoxyAPI server safe to use?

Feng Shui MCP Server by RoxyAPI scores 85 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Feng Shui MCP Server by RoxyAPI server expose?

Feng Shui MCP Server by RoxyAPI exposes 11 tools: post_feng_shui_kua, get_feng_shui_kua_number, post_feng_shui_eight_mansions, post_feng_shui_flying_stars_natal, get_feng_shui_flying_stars_annual_year, and 6 more. Their descriptions and schemas cost roughly 3,596 tokens of context every time the server is loaded.

### Does the Feng Shui MCP Server by RoxyAPI server require authentication?

No. We connected to Feng Shui MCP Server by RoxyAPI without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the Feng Shui MCP Server by RoxyAPI server still maintained?

Feng Shui MCP Server by RoxyAPI is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Remote endpoint: https://roxyapi.com/mcp/feng-shui
- Authorisation metadata: https://roxyapi.com/.well-known/oauth-protected-resource/mcp/feng-shui
- Website: https://roxyapi.com/products/feng-shui-api
- Changelog RSS feed: https://verifymcp.io/servers/com-roxyapi-feng-shui/mcp-feng-shui.xml
- Changelog JSON feed: https://verifymcp.io/servers/com-roxyapi-feng-shui/mcp-feng-shui.json
- HTML version of this page: https://verifymcp.io/servers/com-roxyapi-feng-shui/mcp-feng-shui