caelus-mcp 0.8.0 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # caelus-mcp
2
2
 
3
3
  MCP server for the [caelus](https://github.com/heavyblotto/caelus) ephemeris
4
- engine: seven chart tools over stdio. Computation only — positions, houses,
5
- aspects with orbs, event search — the model does the interpreting. It needs
4
+ engine: nine chart tools over stdio. Computation only — positions, houses,
5
+ aspects with orbs, event search, electional — the model does the interpreting. It needs
6
6
  no API keys, ephemeris files, or network calls; the engine data ships inside
7
7
  the package.
8
8
 
@@ -33,6 +33,11 @@ Any MCP client that speaks stdio:
33
33
  | `find_aspect_dates` | Exact dates a transiting body aspects a longitude or another body, retrograde re-hits included |
34
34
  | `rectification_grid` | ASC/MC sweep across a window of hours for birth-time rectification |
35
35
  | `sky_events` | Rise/set/meridian transits, lunar phases, stations, zodiac crossings in a date range (≤370 days) |
36
+ | `planetary_hours` | The planetary hour in effect at a moment and place: ruler, day/night, hour number, start/end, day ruler, and the 24-hour ruler sequence |
37
+ | `void_of_course` | Whether the Moon is void-of-course at a moment: its sign, sign-exit time, and next perfecting aspect to Sun–Saturn |
38
+
39
+ `natal_chart` and `current_sky` also tag each body with its solar phase
40
+ (cazimi/combust/under-the-beams) and each aspect with applying/separating.
36
41
 
37
42
  Bodies (core chart): sun through pluto, chiron, mean and true node. Optional
38
43
  bodies (mean/true Lilith, asteroids, Uranians) follow engine data on the Node
@@ -40,15 +45,15 @@ loader path. House systems: twelve total — placidus (default), whole_sign,
40
45
  equal, porphyry, koch, regiomontanus, campanus, alcabitius, morinus,
41
46
  meridian, polich_page, vehlow. Placidus and Koch fall back to whole_sign
42
47
  above the polar circles and say so in the payload. `zodiac` supports tropical
43
- (default) and five sidereal ayanamsas on chart tools.
48
+ (default) and seven sidereal ayanamsas on chart tools.
44
49
 
45
50
  ## Output
46
51
 
47
52
  Token-frugal JSON: terse keys, positions to 0.01°, a full natal chart is
48
- ~2.5 KB. Each aspect is a structured object the client can use directly:
53
+ ~3 KB. Each aspect is a structured object the client can use directly:
49
54
 
50
55
  ```json
51
- { "a": "moon", "b": "venus", "aspect": "trine", "orb": 2.09 }
56
+ { "a": "moon", "b": "venus", "aspect": "trine", "orb": 2.09, "phase": "separating" }
52
57
  ```
53
58
 
54
59
  A `natal_chart` or `current_sky` response feeds