# AstroWay Chinese metaphysics (remote · mcp.astroway.info)

BaZi four pillars, Zi Wei Dou Shu, the Chinese calendar and feng shui.

- Trust score: 25/100 (low)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-10-10

## Components

- remote · `mcp.astroway.info`: 25/100 (this document), [markdown](https://verifymcp.io/servers/info-astroway-chinese/mcp-chinese.md), [page](https://verifymcp.io/servers/info-astroway-chinese/mcp-chinese)

## Channel facts

- Endpoint: `https://mcp.astroway.info/mcp/chinese`
- Transports: `streamable-http`
- Auth: `required`
- Version: `0.4.3`

## 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-10-10.

- **Endpoint Security**: 63/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not yet verified: we couldn't confirm whether this endpoint requires it.
  - 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**: 0/100
  - Transport blocked by authentication: the endpoint requires auth we don't have to verify streamable-http.
- **Schema Quality & AI Usability**: 0/100
  - Schema blocked by authentication: the endpoint requires auth we don't have to read it.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 0/100
  - Tool coverage blocked by authentication: the endpoint requires auth we don't have to read its tools.
- **Tool Safety**: 0/100
  - Tool safety blocked by authentication: the endpoint requires auth we don't have to read its tools.
- **Capabilities**: 0/100
  - Capabilities blocked by authentication: the endpoint requires auth we don't have to read them.

**Unverified: 6 categories.** Categories scored 0 because we could not verify them: authentication we do not have, an unreachable endpoint, or not enough scan history. We only credit what we can confirm.

## Install

### How do I install the AstroWay Chinese metaphysics MCP server?

AstroWay Chinese metaphysics is a hosted endpoint at https://mcp.astroway.info/mcp/chinese, 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 info-astroway-chinese 'https://mcp.astroway.info/mcp/chinese'
```

### Cursor

```json
{
  "mcpServers": {
    "info-astroway-chinese": {
      "url": "https://mcp.astroway.info/mcp/chinese"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "info-astroway-chinese": {
      "type": "http",
      "url": "https://mcp.astroway.info/mcp/chinese"
    }
  }
}
```

### Codex

```toml
[mcp_servers.info-astroway-chinese]
url = "https://mcp.astroway.info/mcp/chinese"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "info-astroway-chinese": {
      "type": "remote",
      "url": "https://mcp.astroway.info/mcp/chinese",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add info-astroway-chinese --url 'https://mcp.astroway.info/mcp/chinese' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  info-astroway-chinese:
    url: "https://mcp.astroway.info/mcp/chinese"
```

### Netclaw

```json
{
  "McpServers": {
    "info-astroway-chinese": {
      "Transport": "http",
      "Url": "https://mcp.astroway.info/mcp/chinese"
    }
  }
}
```

### Vellum

```bash
assistant mcp add info-astroway-chinese -t streamable-http -u 'https://mcp.astroway.info/mcp/chinese'
```

### Other

```json
{
  "mcpServers": {
    "info-astroway-chinese": {
      "type": "http",
      "url": "https://mcp.astroway.info/mcp/chinese"
    }
  }
}
```

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-10-10 (score 25, −50)

- [security regression] Endpoint reachability: reachable → behind authorisation
- [security regression] Tool safety: pass → unverified
- [security regression] Authorization: fail → unverified
- [security regression] Transport: pass → unverified
- [security regression] Stability: 0.03 → unverified
- [functional regression] Capabilities: pass → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Schema quality: 100 → unverified

### 2026-10-07 (score 75, +2)

- [security improvement] Judged manipulation: unverified → pass
- [security] Tool “astroway_chinese_zodiac_animal” rewrote its description, which is the text the model reads
- [functional improvement] Stability: unverified → 0.03

### 2026-10-06 (score 73)

First indexed and scored.

## MCP tools (62)

### `astroway_account_status` (~73 tokens)

Account Status

Check current API key status: tier, credit balance, rate limits, monthly cycle reset. Run this BEFORE invoking expensive endpoints (Tier 4+ at 100+ credits, Tier 6/7 at 500-5000 credits) to confirm the user has budget. Returns plain-text human-readable summary.

### `astroway_cost_estimate` (~91 tokens)

Cost Estimate

Estimate the credit cost of one or more endpoints WITHOUT invoking them. Returns total + per-endpoint breakdown with tier annotations. Useful when planning multi-step workflows: estimate first, ask user confirmation, then invoke. Cache TTL 5 min.

Input parameters:

- `endpoints` (array, required): Endpoint paths to estimate, e.g. ["/chart", "/synastry", "/reports/natal"]. Leading slash optional.

### `astroway_agent_tools` (~364 tokens)

Agent tool definitions

Tool definitions for an agent framework, generated from the live OpenAPI document, so the schema a model fills is the schema the endpoint validates. `format=openai` (default) returns `{ type, function }` objects you can spread straight into a chat completion; `format=anthropic` returns `{ name, description, input_schema }`. The objects carry nothing of ours: how to call each t…

[Group: Agent Platform]
[Cost: see your plan — endpoint not in the public credit manifest]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `format` (string): Which vendor contract the tool objects follow. `openai` returns `{ type, function }`, `anthropic` returns `{ name, description, input_schema }`.
- `limit` (integer): How many tools to return. The ceiling is the OpenAI limit of 128 functions per request; models degrade well before it. Anything left out is counted in `totalMatched`.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `q` (string): Free-text filter applied within the selection, matched against path, summary, description and group.
- `select` (string): What to hand over: `starter` (the curated set, the default), `all`, `group:<tag>` such as `group:Vedic`, or `paths:/chart,/synastry` for an explicit list. An unknown path is named in `notes` rather t…

Output parameters:

- `count`
- `executors`
- `format`
- `notes`
- `select`
- `tools`
- `totalAvailable`
- `totalMatched`
- `truncated`

### `astroway_mcp_ai_chat` (~371 tokens)

Chart-grounded AI chat

Chat answered from the positions we computed for this birth moment, not from the model's memory of a sun sign. Carries up to 10 turns of history, replies in 21 languages, and takes four voices through `persona`. Send your own provider key and the turn costs 5 credits instead of the endpoint price.

[Group: AI & MCP]
[Cost: 100 credits (Tier 4)]

Input parameters:

- `chart` (object): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `history` (array)
- `language` (string)
- `message` (string, required)
- `persona` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `disclaimer`
- `duration_ms`
- `language`
- `model`
- `persona`
- `reply`
- `tokens`

### `astroway_mcp_ai_comparison_coach` (~472 tokens)

Comparison Coach

Coach two charts on relationship dynamics.

[Group: AI & MCP]
[Cost: 100 credits (Tier 4)]

Input parameters:

- `chart1` (object, required): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `chart2` (object, required): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `question` (string, required)

Output parameters:

- `coaching`

### `astroway_mcp_ai_explain_aspect` (~321 tokens)

Explain Aspect

Detailed explanation of an aspect between two planets.

[Group: AI & MCP]
[Cost: 100 credits (Tier 4)]

Input parameters:

- `aspectType` (string, required)
- `chart` (object): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `planet1` (string, required)
- `planet2` (string, required)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `explanation`

### `astroway_mcp_ai_explain_transit` (~329 tokens)

Explain Transit

Explain a current transit hitting your natal chart.

[Group: AI & MCP]
[Cost: 100 credits (Tier 4)]

Input parameters:

- `aspectType` (string, required)
- `chart` (object, required): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `natalPlanet` (string, required)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `transitDate` (string, required)
- `transitPlanet` (string, required)

Output parameters:

- `explanation`

### `astroway_bazi_chart` (~369 tokens)

Full BaZi chart

The four pillars with everything the classical apparatus reads off them in one call: hidden stems, na yin, the twelve stages of the day master, element balance over all eight characters, the strength verdict, symbolic stars from both reference pillars, and the branch and stem interactions. Localised by language. Pass longitude with trueSolarTime true to cut the double-hour fro…

[Group: BaZi (Four Pillars)]
[Cost: 20 credits (Tier 2)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `includeFullTable` (boolean)
- `language` (string)
- `longitude` (number)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `stageSchool` (string)
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number): Ignored when timezone is sent.
- `trueSolarTime` (boolean)

Output parameters:

- `dayMaster`
- `disclaimer`
- `elementBalance`
- `interactions`
- `language`
- `methodology`
- `notes`
- `pillars`
- `solarYear`
- `source`
- `stageSchool`
- `strength`
- `symbolicStars`

### `astroway_bazi_day_master` (~294 tokens)

Day Master

Day stem element + yin/yang polarity + canonical archetype description. The "self" character in BaZi from which all other pillars are interpreted.

[Group: BaZi (Four Pillars)]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number): Ignored when timezone is sent.

Output parameters:

- `dayMaster`
- `dayPillar`
- `disclaimer`
- `interpretation`
- `notes`

### `astroway_bazi_element_balance` (~373 tokens)

5-Element Balance

Element balance across the whole chart. The `balance` object opens the branches and counts all eight characters three ways: visible, with every hidden stem, and weighted so the total stays at eight. The top-level elementCounts, dominantElement and missingElements are DEPRECATED (year and month only, four characters, branches unopened) and keep answering unchanged until 2027-09…

[Group: BaZi (Four Pillars)]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `includeFullTable` (boolean)
- `language` (string)
- `longitude` (number)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `stageSchool` (string)
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number): Ignored when timezone is sent.
- `trueSolarTime` (boolean)

Output parameters:

- `balance`
- `deprecations`
- `disclaimer`
- `dominantElement`
- `elementCounts`
- `methodology`
- `missingElements`
- `notes`
- `pillars`
- `solarYear`
- `source`

### `astroway_bazi_four_pillars` (~339 tokens)

Four Pillars (full)

All four pillars: year, month, day, hour. Day pillar uses the canonical 60-jiazi cycle (anchor 1990-01-01 = Bing-Yin). Pass `time` to compute the hour pillar; day and hour roll at 23:00 local, year and month at the exact Lichun and 節 instants.

[Group: BaZi (Four Pillars)]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number): Ignored when timezone is sent.

Output parameters:

- `dayPillar`
- `disclaimer`
- `hourPillar`
- `monthPillar`
- `notes`
- `solarYear`
- `yearPillar`

### `astroway_bazi_hidden_stems` (~358 tokens)

Hidden stems (Cang Gan)

The one to three stems each branch shelters, with role and weight. This is where most of a chart's elements live: a chart with no visible Water can still be soaked in it. On the four storage branches the middle role belongs to the stored element, not to the second in the list.

[Group: BaZi (Four Pillars)]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `includeFullTable` (boolean)
- `language` (string)
- `longitude` (number)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `stageSchool` (string)
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number): Ignored when timezone is sent.
- `trueSolarTime` (boolean)

Output parameters:

- `disclaimer`
- `methodology`
- `notes`
- `pillars`
- `solarYear`
- `source`
- `weighting`

### `astroway_bazi_hour_pillar` (~302 tokens)

Hour Pillar

Hour pillar via 五鼠遁 (Five-Rats-Escape) day-stem → hour-stem table. The Zi hour opens the day at 23:00 local time.

[Group: BaZi (Four Pillars)]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string, required)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number): Ignored when timezone is sent.

Output parameters:

- `cstHour`
- `date`
- `dayPillar`
- `disclaimer`
- `hourPillar`
- `localHour`
- `methodology`
- `time`
- `timezoneOffset`

### `astroway_bazi_interactions` (~337 tokens)

Branch and stem interactions

Stem combinations, six harmonies, full and half trines, clashes, harms, punishments and self-punishments present in the chart, with the pillars involved and the element a combination produces.

[Group: BaZi (Four Pillars)]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `includeFullTable` (boolean)
- `language` (string)
- `longitude` (number)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `stageSchool` (string)
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number): Ignored when timezone is sent.
- `trueSolarTime` (boolean)

Output parameters:

- `disclaimer`
- `interactions`
- `methodology`
- `notes`
- `pillars`
- `solarYear`
- `source`

### `astroway_bazi_life_stages` (~354 tokens)

Twelve life stages

A stem read against each branch as a life cycle, from Chang Sheng through Di Wang to Jue. The day master through the chart; pass includeFullTable for the ten-by-twelve reference table. stageSchool picks the classical yin-reverse rule or the unified one.

[Group: BaZi (Four Pillars)]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `includeFullTable` (boolean)
- `language` (string)
- `longitude` (number)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `stageSchool` (string)
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number): Ignored when timezone is sent.
- `trueSolarTime` (boolean)

Output parameters:

- `dayMaster`
- `dayMasterThroughChart`
- `disclaimer`
- `methodology`
- `notes`
- `school`
- `schoolNote`
- `solarYear`
- `source`

### `astroway_bazi_luck_pillars` (~301 tokens)

Luck Pillars (Da Yun)

10-year luck pillars sequence. Direction by gender + year-stem polarity per Ziping canon.

[Group: BaZi (Four Pillars)]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `count` (integer)
- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `gender` (string, required)
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number): Ignored when timezone is sent.

Output parameters:

- `count`
- `date`
- `direction`
- `disclaimer`
- `gender`
- `luckPillars`
- `methodology`
- `source`
- `startAge`
- `startReference`

### `astroway_bazi_month_pillar` (~274 tokens)

Month Pillar

Month stem + branch from solar-term boundaries.

[Group: BaZi (Four Pillars)]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number): Ignored when timezone is sent.

Output parameters:

- `monthPillar`

### `astroway_bazi_monthly` (~191 tokens)

Monthly Forecast

Same Sheng-Ke + branch-clash analysis as yearly, but applied to a specific calendar month. Month branch resolved via mid-month jieqi.

[Group: BaZi (Four Pillars)]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `natalDate` (string, required)
- `natalTime` (string)
- `natalTzOffset` (number)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `targetMonth` (integer, required)
- `targetYear` (integer, required)

Output parameters:

- `branchInteractions`
- `disclaimer`
- `elementFlow`
- `natalDayMaster`
- `notes`
- `targetMonth`
- `targetPillar`
- `targetYear`

### `astroway_bazi_na_yin` (~345 tokens)

Na Yin sound-element

The sound-element of each pillar. The sixty jiazi collapse into thirty names, two consecutive pillars to a name; the year pillar na yin is what popular readings mean by "your element", and it is not the day master.

[Group: BaZi (Four Pillars)]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `includeFullTable` (boolean)
- `language` (string)
- `longitude` (number)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `stageSchool` (string)
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number): Ignored when timezone is sent.
- `trueSolarTime` (boolean)

Output parameters:

- `disclaimer`
- `methodology`
- `notes`
- `pillars`
- `solarYear`
- `source`

### `astroway_bazi_strength` (~358 tokens)

Day-master strength

The support-and-suppress reading over the weighted hidden-stem count, with the three classical criteria (season, root, allies) reported unweighted and the favourable elements that follow. The caveat names both limits: the month is counted like any other branch, and the cut points are this API's convention.

[Group: BaZi (Four Pillars)]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `includeFullTable` (boolean)
- `language` (string)
- `longitude` (number)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `stageSchool` (string)
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number): Ignored when timezone is sent.
- `trueSolarTime` (boolean)

Output parameters:

- `dayMaster`
- `disclaimer`
- `methodology`
- `notes`
- `pillars`
- `solarYear`
- `source`
- `strength`

### `astroway_bazi_symbolic_stars` (~356 tokens)

Symbolic stars (Shen Sha)

Peach Blossom, Travelling Horse, Canopy, Heavenly Nobleman, Blade and Void, computed from BOTH the year and the day reference pillar because the transmissions disagree about which one the rules read from. Where two transmissions place a star differently, both placements ship and each names the other.

[Group: BaZi (Four Pillars)]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `includeFullTable` (boolean)
- `language` (string)
- `longitude` (number)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `stageSchool` (string)
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number): Ignored when timezone is sent.
- `trueSolarTime` (boolean)

Output parameters:

- `byDayPillar`
- `byYearPillar`
- `disclaimer`
- `methodology`
- `notes`
- `pillars`
- `referenceNote`
- `solarYear`
- `source`

### `astroway_bazi_ten_gods` (~314 tokens)

Ten Gods (Shi Shen)

Ten Gods classification per day master. Bi Jian/Jie Cai (peer), Shi Shen/Shang Guan (output), Pian Cai/Zheng Cai (wealth), Qi Sha/Zheng Guan (officer), Pian Yin/Zheng Yin (resource).

[Group: BaZi (Four Pillars)]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number): Ignored when timezone is sent.

Output parameters:

- `date`
- `dayMaster`
- `disclaimer`
- `methodology`
- `source`
- `tenGods`

### `astroway_bazi_year_pillar` (~278 tokens)

Year Pillar

Year stem + branch + animal + element with yin/yang.

[Group: BaZi (Four Pillars)]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number): Ignored when timezone is sent.

Output parameters:

- `yearPillar`

### `astroway_bazi_year_pillar_decade` (~142 tokens)

Year Pillars × 10

10 consecutive year pillars from a given starting year.

[Group: BaZi (Four Pillars)]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `startYear` (integer, required)

Output parameters:

- `decade`
- `disclaimer`
- `startYear`

### `astroway_bazi_yearly` (~204 tokens)

Yearly Forecast

Compares target year pillar against natal day master + natal year branch. Returns element-flow relation (companion / mother / output / control / wealth) per Sheng-Ke cycle, branch clashes (六冲), and trine support (三合).

[Group: BaZi (Four Pillars)]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `natalDate` (string, required)
- `natalTime` (string)
- `natalTzOffset` (number)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `targetYear` (integer, required)

Output parameters:

- `branchInteractions`
- `disclaimer`
- `elementFlow`
- `natalDayMaster`
- `notes`
- `targetPillar`
- `targetYear`

### `astroway_chinese_feng_shui_annual_stars` (~384 tokens)

Annual flying stars and afflictions

The nine annual stars for a solar year, plus Tai Sui, Sui Po, San Sha, the five yellow and the two black with the sectors they occupy. Optionally the monthly layer. The year turns at Li Chun, computed from the exact solar term.

[Group: Chinese: Zodiac & Feng Shui]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `date` (string)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `includeMonthly` (boolean)
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset`: Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent.
- `year` (integer)

Output parameters:

- `afflictions`
- `animal`
- `centreStar`
- `palaces`
- `solarYear`
- `yearBranch`

### `astroway_chinese_feng_shui_bagua` (~363 tokens)

Bagua Life Areas

Eastern-school Bagua mapping of 9 life areas (career, knowledge, family, wealth, fame, relationships, children, helpful-people, health) onto compass sectors.

[Group: Chinese: Zodiac & Feng Shui]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `gender` (string, required)
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `solarYear` (integer)
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset`: Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent.

Output parameters:

- `bagua`
- `group`
- `kuaNumber`
- `notes`

### `astroway_chinese_feng_shui_flying_star` (~293 tokens)

Flying Star natal chart (Xuan Kong Fei Xing)

The nine-palace natal chart of a building: mountain star, period star and facing star per sector, the named arrangement (旺山旺水 and the other three), and the special patterns. Send the facing in degrees or as one of the 24 mountains, and the period directly or as the date the building was occupied. Neither is defaulted.

[Group: Chinese: Zodiac & Feng Shui]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `facing` (number)
- `facingMountain` (string)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `occupiedDate` (string)
- `occupiedTime` (string)
- `period` (integer)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `timezoneOffset`: Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC.
- `year` (integer)

Output parameters:

- `annualYear`
- `chartType`
- `facing`
- `flight`
- `notes`
- `palaces`
- `patterns`
- `period`
- `sitting`
- `warnings`

### `astroway_chinese_feng_shui_kua` (~350 tokens)

Kua Number

Personal Kua number from solar-year digit sum + gender. Maps to East/West group for direction work.

[Group: Chinese: Zodiac & Feng Shui]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `gender` (string, required)
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `solarYear` (integer)
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset`: Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent.

Output parameters:

- `description`
- `gender`
- `group`
- `kuaNumber`
- `solarYear`

### `astroway_chinese_feng_shui_lucky_directions` (~350 tokens)

Lucky / Unlucky Directions

Personal 4 lucky + 4 unlucky compass directions from Kua. Standard Pa Kua mapping.

[Group: Chinese: Zodiac & Feng Shui]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `gender` (string, required)
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `solarYear` (integer)
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset`: Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent.

Output parameters:

- `group`
- `kuaNumber`
- `lucky`
- `unlucky`

### `astroway_chinese_lunar_date` (~334 tokens)

Gregorian to Lunar Date

Chinese lunar month and day for a Gregorian date, including leap-month detection, plus the Chinese New Year of that year.

[Group: Chinese: Zodiac & Feng Shui]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset`: Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent.

Output parameters:

- `chineseNewYear`
- `gregorianDate`
- `lunar`

### `astroway_chinese_solar_terms` (~169 tokens)

24 Solar Terms (節氣)

The 24 solar terms of a Chinese solar year as exact instants, in UTC and Beijing time. Twelve of them open a BaZi pillar month; the other twelve decide where a leap month falls.

[Group: Chinese: Zodiac & Feng Shui]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `year` (integer, required)

Output parameters:

- `notes`
- `terms`
- `year`

### `astroway_chinese_tong_shu` (~359 tokens)

Tong Shu day: officer and mansion

The almanac reading of one day: day pillar, the day officer (建除十二神) with what the register endorses and forbids, the 28 mansion with its quadrant and planet, and the animal the day clashes.

[Group: Chinese: Zodiac & Feng Shui]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset`: Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent.

Output parameters:

- `clash`
- `date`
- `dayPillar`
- `mansion`
- `monthBranch`
- `notes`
- `officer`
- `solarYear`

### `astroway_chinese_tong_shu_select` (~215 tokens)

Tong Shu date selection

Walk a date range and return the days the almanac endorses for one activity, each with the officer that decided it. Optionally drop the days that clash a person's animal. Range capped at 366 days and a longer one is refused, not truncated.

[Group: Chinese: Zodiac & Feng Shui]
[Cost: 20 credits (Tier 2)]

Input parameters:

- `activity` (string, required)
- `avoidClashWith` (string)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `from` (string, required)
- `includeNeutral` (boolean)
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `to` (string, required)

Output parameters:

- `activity`
- `days`
- `dropped`
- `matched`
- `scanned`

### `astroway_chinese_true_solar_time` (~327 tokens)

True solar time

The clock corrected to the sun over the birth longitude, split into the meridian term and the equation of time. China runs one zone across sixty degrees, so a Kashgar birth reads nearly three hours from solar noon on a Beijing clock, which moves the hour pillar.

[Group: Chinese: Zodiac & Feng Shui]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `longitude` (number, required)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string, required)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number, required): Ignored when timezone is sent.

Output parameters:

- `clockTime`
- `date`
- `dayShift`
- `equationOfTimeMinutes`
- `hourBranchNote`
- `input`
- `longitudeCorrectionMinutes`
- `methodology`
- `note`
- `source`
- `totalCorrectionMinutes`
- `trueSolarTime`

### `astroway_chinese_zodiac_animal` (~387 tokens)

Chinese Zodiac Animal

Animal sign of the birth year, bounded by the exact Lichun instant, plus the full pillar (stem + branch + element). `yearStart` and `yearEnd` are the two Lichun instants that bound the solar year, in UTC and Beijing time. Pass time + timezoneOffset for births on the boundary day.

[Group: Chinese: Zodiac & Feng Shui]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `solarYear` (integer)
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset`: Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent.

Output parameters:

- `animal`
- `branch`
- `element`
- `glyph`
- `pillar`
- `solarYear`
- `stem`
- `yearEnd`
- `yearStart`

### `astroway_chinese_zodiac_compatibility` (~160 tokens)

Animal Compatibility

Pair compatibility score (0-100) using San He trine + Liu Chong conflict-pair canon.

[Group: Chinese: Zodiac & Feng Shui]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `person1` (object, required)
- `person2` (object, required)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `compatibility`
- `person1`
- `person2`

### `astroway_chinese_zodiac_element` (~336 tokens)

Chinese Element

Fixed-branch element + cycling-stem element + yin/yang for given solar year.

[Group: Chinese: Zodiac & Feng Shui]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `solarYear` (integer)
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset`: Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent.

Output parameters:

- `cyclingElement`
- `description`
- `fixedElement`
- `solarYear`
- `yin`

### `astroway_chinese_zodiac_inner_animal` (~332 tokens)

Inner Animal (month branch)

Month-branch animal: represents inner motivations and private self.

[Group: Chinese: Zodiac & Feng Shui]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `solarYear` (integer)
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset`: Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent.

Output parameters:

- `description`
- `glyph`
- `innerAnimal`

### `astroway_chinese_zodiac_secret_animal` (~336 tokens)

Secret Animal (hour branch)

Hour-of-birth branch animal: represents the deepest self. Requires birth time.

[Group: Chinese: Zodiac & Feng Shui]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `solarYear` (integer)
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset`: Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent.

Output parameters:

- `description`
- `glyph`
- `secretAnimal`

### `astroway_mcp_agent_debate` (~326 tokens)

MCP Agent Debate

2 personas debate a topic, multi-round transcript.

[Group: MCP Advanced]
[Cost: 100 credits (Tier 4)]

Input parameters:

- `agentA` (string, required)
- `agentB` (string, required)
- `chart` (object): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `rounds` (integer)
- `topic` (string, required)

Output parameters:

- `transcript`

### `astroway_mcp_agent_pool_status` (~116 tokens)

MCP Agent Pool Status

8 personas with specialties.

[Group: MCP Advanced]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `count`
- `note`
- `personas`

### `astroway_mcp_multi_agent_coordinate` (~309 tokens)

MCP Multi-Agent Coordinate

Run N personas in parallel + LLM synthesis.

[Group: MCP Advanced]
[Cost: 100 credits (Tier 4)]

Input parameters:

- `agents` (array, required)
- `chart` (object): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `question` (string, required)

Output parameters:

- `individual`
- `synthesis`

### `astroway_mcp_multi_chart_context` (~135 tokens)

MCP Multi-Chart Context

Compact context for MCP agents working across multiple charts.

[Group: AI & MCP]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `charts` (array, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `intent` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `chartCount`
- `contextHash`
- `intent`
- `notes`
- `summaries`
- `summaryString`

### `astroway_mcp_rag_search` (~300 tokens)

MCP RAG Search

Keyword-tag scoring over chart chunks.

[Group: MCP Advanced]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `chart` (object, required): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `query` (string, required)
- `topK` (integer)

Output parameters:

- `matches`
- `query`
- `results`
- `tokens`
- `total`

### `astroway_mcp_streaming` (~304 tokens)

MCP Streaming Chat

Server-Sent Events streaming chat completion with optional chart context.

[Group: AI & MCP]
[Cost: 100 credits (Tier 4)]

Input parameters:

- `chart` (object): Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD;…
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `message` (string, required)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

### `astroway_mcp_tool_call_stream` (~139 tokens)

MCP Tool-Call Stream

SSE-stream of a tool call envelope.

[Group: MCP Advanced]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `args` (object)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `tool` (string, required)

### `astroway_mcp_tools_list` (~132 tokens)

MCP Tools List

Auto-generated tool manifest for MCP clients (modelcontextprotocol/2025-03 spec).

[Group: AI & MCP]
[Cost: see your plan — endpoint not in the public credit manifest]

Input parameters:

- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output parameters:

- `notes`
- `server`
- `spec`
- `toolCount`
- `tools`

### `astroway_ziwei_chart` (~365 tokens)

Full Chart (computed)

Real star placement: soul and body palaces, the five-element class, all 14 main stars plus auxiliaries, the twelve stages, the 12 decade limits and the 四化 marked on the stars that carry them.

[Group: Zi Wei Dou Shu (Purple Star)]
[Cost: 20 credits (Tier 2)]

Input parameters:

- `age` (integer)
- `date` (string, required)
- `dayDivide` (string)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `fixLeap` (boolean)
- `gender` (string, required)
- `language` (string)
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `school` (string)
- `tianmaSchool` (string)
- `time` (string, required)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number): Ignored when timezone is sent.
- `yearDivide` (string)

Output parameters:

- `computed`
- `fiveElementClass`
- `lunar`
- `palaces`
- `soulPalace`
- `ziwei`

### `astroway_ziwei_four_transformations` (~346 tokens)

Four Transformations (四化)

The four stars activated by the birth year stem: 化禄 fortune, 化权 authority, 化科 repute, 化忌 obstruction. The one part of Zi Wei computable without star placement. Seven stems are agreed across traditions; for the three that are not (戊 庚 壬) every school reading ships in schoolVariants, and `school` switches the headline answer.

[Group: Zi Wei Dou Shu (Purple Star)]
[Cost: 10 credits (Tier 1)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `school` (string)
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number): Ignored when timezone is sent.

Output parameters:

- `disputed`
- `notes`
- `school`
- `schoolVariants`
- `solarYear`
- `transformations`
- `yearStem`

### `astroway_ziwei_full_chart` (~308 tokens)

Full Chart (deprecated)

Deprecated 2026-09-08, sunset 2027-11-26. Year pillar + animal + a 12-palace overview, identical for every birth date. Use POST /ziwei/chart, which actually places the stars.

[Group: Zi Wei Dou Shu (Purple Star)]
[Cost: 5 credits (Tier ½)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number): Ignored when timezone is sent.

Output parameters:

- `animal`
- `disclaimer`
- `notes`
- `palaces`
- `solarYear`
- `yearPillar`

### `astroway_ziwei_main_stars` (~294 tokens)

14 Main Stars

The 14 main stars in canonical order (Zi Wei series, then Tian Fu series) with theme/archetype. Reference table: does not vary with the date.

[Group: Zi Wei Dou Shu (Purple Star)]
[Cost: 5 credits (Tier ½)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number): Ignored when timezone is sent.

Output parameters:

- `disclaimer`
- `fourteenMainStars`

### `astroway_ziwei_palace_career` (~268 tokens)

Career Palace (Guanlu)

Profession, status, official position.

[Group: Zi Wei Dou Shu (Purple Star)]
[Cost: 5 credits (Tier ½)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number): Ignored when timezone is sent.

Output parameters:

- `animal`
- `disclaimer`
- `palace`
- `solarYear`

### `astroway_ziwei_palace_children` (~266 tokens)

Children Palace (Zinu)

Children, fertility, juniors.

[Group: Zi Wei Dou Shu (Purple Star)]
[Cost: 5 credits (Tier ½)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number): Ignored when timezone is sent.

Output parameters:

- `animal`
- `disclaimer`
- `palace`
- `solarYear`

### `astroway_ziwei_palace_destiny` (~269 tokens)

Destiny Palace (Ming)

Life path, character, soul mission.

[Group: Zi Wei Dou Shu (Purple Star)]
[Cost: 5 credits (Tier ½)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number): Ignored when timezone is sent.

Output parameters:

- `animal`
- `disclaimer`
- `palace`
- `solarYear`

### `astroway_ziwei_palace_health` (~267 tokens)

Health Palace (Ji'e)

Body, illness, weak points.

[Group: Zi Wei Dou Shu (Purple Star)]
[Cost: 5 credits (Tier ½)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number): Ignored when timezone is sent.

Output parameters:

- `animal`
- `disclaimer`
- `palace`
- `solarYear`

### `astroway_ziwei_palace_property` (~268 tokens)

Property Palace (Tianzhai)

Real estate, family home, ancestry.

[Group: Zi Wei Dou Shu (Purple Star)]
[Cost: 5 credits (Tier ½)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number): Ignored when timezone is sent.

Output parameters:

- `animal`
- `disclaimer`
- `palace`
- `solarYear`

### `astroway_ziwei_palace_siblings` (~268 tokens)

Siblings Palace (Xiongdi)

Brothers, sisters, peer relationships.

[Group: Zi Wei Dou Shu (Purple Star)]
[Cost: 5 credits (Tier ½)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number): Ignored when timezone is sent.

Output parameters:

- `animal`
- `disclaimer`
- `palace`
- `solarYear`

### `astroway_ziwei_palace_spouse` (~267 tokens)

Spouse Palace (Fuqi)

Marriage partner, romantic union.

[Group: Zi Wei Dou Shu (Purple Star)]
[Cost: 5 credits (Tier ½)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number): Ignored when timezone is sent.

Output parameters:

- `animal`
- `disclaimer`
- `palace`
- `solarYear`

### `astroway_ziwei_palace_travel` (~268 tokens)

Travel Palace (Qianyi)

Travel, relocation, foreign opportunities.

[Group: Zi Wei Dou Shu (Purple Star)]
[Cost: 5 credits (Tier ½)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number): Ignored when timezone is sent.

Output parameters:

- `animal`
- `disclaimer`
- `palace`
- `solarYear`

### `astroway_ziwei_palace_wealth` (~266 tokens)

Wealth Palace (Caibo)

Income, material prosperity.

[Group: Zi Wei Dou Shu (Purple Star)]
[Cost: 5 credits (Tier ½)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number): Ignored when timezone is sent.

Output parameters:

- `animal`
- `disclaimer`
- `palace`
- `solarYear`

### `astroway_ziwei_twelve_palaces` (~278 tokens)

12 Palaces

All 12 palaces with English/pinyin/Chinese names + theme + rules.

[Group: Zi Wei Dou Shu (Purple Star)]
[Cost: 5 credits (Tier ½)]

Input parameters:

- `date` (string, required)
- `fields` (string): Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
- `precision` (integer): Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
- `time` (string)
- `timezone` (string): IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it…
- `timezoneOffset` (number): Ignored when timezone is sent.

Output parameters:

- `animal`
- `disclaimer`
- `palaces`
- `solarYear`

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/info-astroway-chinese/mcp-chinese#diagnostics

## Score history

- 2026-10-10: 25
- 2026-10-07: 75
- 2026-10-06: 73

## Common questions

### What is the AstroWay Chinese metaphysics MCP server?

AstroWay Chinese metaphysics is an MCP server listed in the public MCP registry as info.astroway/chinese. BaZi four pillars, Zi Wei Dou Shu, the Chinese calendar and feng shui. This page covers its hosted endpoint (https://mcp.astroway.info/mcp/chinese).

### Is the AstroWay Chinese metaphysics MCP server safe to use?

AstroWay Chinese metaphysics scores 25 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 AstroWay Chinese metaphysics MCP server expose?

AstroWay Chinese metaphysics exposes 62 tools: astroway_account_status, astroway_cost_estimate, astroway_agent_tools, astroway_mcp_ai_chat, astroway_mcp_ai_comparison_coach, and 57 more. Their descriptions and schemas cost roughly 17,964 tokens of context every time the server is loaded.

### Does the AstroWay Chinese metaphysics MCP server require authentication?

Its publisher declares that AstroWay Chinese metaphysics requires credentials, so you will need to authorise it in your MCP client. We have not been able to confirm that against the live endpoint.

### Is the AstroWay Chinese metaphysics MCP server still maintained?

AstroWay Chinese metaphysics is still listed as active in the MCP registry. We last reached this channel on 10 October 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://mcp.astroway.info/mcp/chinese
- Authorisation metadata: https://mcp.astroway.info/.well-known/oauth-protected-resource/mcp/chinese
- Website: https://api.astroway.info/en/examples/mcp/
- Changelog RSS feed: https://verifymcp.io/servers/info-astroway-chinese/mcp-chinese.xml
- Changelog JSON feed: https://verifymcp.io/servers/info-astroway-chinese/mcp-chinese.json
- HTML version of this page: https://verifymcp.io/servers/info-astroway-chinese/mcp-chinese