# Fengshui Calculator

> Verifiable Chinese calendar & feng shui: BaZi, flying stars, Kua, almanac. SHA-256 replayable.

- name: com.fengshuicalculator/fengshui-calculator
- version: 0.1.0
- connection class: R0 (autonomous)
- trust: 80/100 flags: no-repository
- quality: 73/100 (needs work)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.fengshuicalculator%2Ffengshui-calculator
- tools: https://api.protogrid.dev/v1/servers/com.fengshuicalculator%2Ffengshui-calculator/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "fengshui-calculator": {
      "type": "http",
      "url": "https://fengshuicalculator.com/v1/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 100
- freshness: 100
- provenance: 45
- drivers: +dns-namespace +reachable +uptime-99% +updated-23d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 73/100 (needs work)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-06-18; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 75 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: calendar (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); ganzhi (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); sun_position (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 1,325 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump
- pass `tools.hidden_text`: no hidden text in tool names, descriptions, schemas or annotations

### stability: 67 (weight 15)

- pass `stability.changes`: 2 tool changes in 30 days
- fail `stability.rug_pull`: 1 tools kept their name but changed most of their description in 30 days; review before trusting them
- pass `stability.new_links`: no tool change named a new site

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 11, about 1,325 tokens to load them all
- tool set hash: 47b0f82392e5a58dad1ea1b96ff5951b
- tools last changed: 2026-10-31T03:51:52.456Z
- badge: [![protogrid quality](https://protogrid.dev/badge/com.fengshuicalculator/fengshui-calculator.svg)](https://protogrid.dev/servers/com.fengshuicalculator/fengshui-calculator)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-31 `sun_position` added
  - Sun azimuth/elevation for a location and instant (solar compass numeric base): azimuth 0=north clockwise, geometric vs apparent (Sæmundsson refraction) elevation, declination, hour angle, explicit polar day/night state — measurement link only, no direction is inferred from photos
- 2026-10-31 `solar_terms` changed (description) **meaning changed**
  - before: All 24 solar terms of a year with exact Beijing instants (DE441-based), ΔT, and midnight-margin uncertainty flags
  - after: All 24 solar terms of a year with exact Beijing instants. Model: VSOP87D apparent solar longitude + nutation + aberration + ΔT; root tolerance 1e-7 day (~8.6 ms); verified against an independent JPL DE441-based reconstruction. ΔT and midnight-margin uncertainty flags included.

Full history: https://api.protogrid.dev/v1/servers/com.fengshuicalculator%2Ffengshui-calculator/changes

## Remotes

- https://fengshuicalculator.com/v1/mcp (streamable-http, auth none, reachable true, uptime30d 0.98913044)

## Packages

_none_

## Tools (11)

- `calendar`: Chinese calendar for a date: lunar date (with leap month), zodiac, day officer 建除, yellow/black path, six-day cycle — computed on Beijing time
- `flying_star_chart`: Xuan Kong flying star natal chart: nine palaces with mountain/facing/period stars plus classical pattern labels (e.g. 旺山旺向). Period from a construction date, or explicit yun
- `form_analysis`: Indoor form-sha from a floor-plan wireframe: 穿堂煞 (door-window alignment), 缺角 (nine-palace missing corners), 厕占中宫 (toilet at centre) — plus optional fusion with the Eight Mansions house stars and Ming Gua. Grade B verdicts, no aggregate score
- `ganzhi`: Four pillars (BaZi) for a date+hour, returned under BOTH year conventions (Lichun vs Lunar New Year) × BOTH day boundaries (midnight vs 23:00) — differences are shown, not hidden
- `kua_number`: Ming Gua (Kua number) from birth date + gender, with the Lichun year boundary computed astronomically, five-yellow substitution conventions, and eight favourable/unfavourable directions
- `replay`: Verifiability as an API call: recompute a stored request and compare its SHA-256 input digest (JCS-canonicalised) against an expected value — byte-identical reproduction or honest mismatch
- `rulesets`: List the rule sets the kernel actually implements, with parameters and honest review_state — nothing not implemented is advertised
- `solar_terms`: All 24 solar terms of a year with exact Beijing instants. Model: VSOP87D apparent solar longitude + nutation + aberration + ΔT; root tolerance 1e-7 day (~8.6 ms); verified against an independent JPL DE441-based reconstruction. ΔT and midnight-margin uncertainty flags included.
- `sun_position`: Sun azimuth/elevation for a location and instant (solar compass numeric base): azimuth 0=north clockwise, geometric vs apparent (Sæmundsson refraction) elevation, declination, hour angle, explicit polar day/night state — measurement link only, no direction is inferred from photos
- `terrain_white_tiger`: White tiger elevation check (白虎抬头) from a DEM-derived 360-bin skyline: compares the right (white tiger) vs left (azure dragon) sector elevation within ±45° of the sitting direction
- `yun_period`: San Yuan period (三元九运, 1–9) for a date; periods switch at Lichun, anchored 1984 = start of Period 7