caelus-mcp 0.12.0 → 0.13.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.
Files changed (4) hide show
  1. package/README.md +24 -3
  2. package/dist/src/server.d.ts +2013 -291
  3. package/dist/src/server.js +334 -2
  4. package/package.json +3 -2
package/README.md CHANGED
@@ -1,14 +1,23 @@
1
1
  # caelus-mcp
2
2
 
3
3
  MCP server for the [caelus](https://github.com/heavyblotto/caelus) ephemeris
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
4
+ engine: eighteen chart tools over stdio. Computation only — positions, houses,
5
+ aspects with orbs, event search, electional, returns, progressions, composite,
6
+ dignities, Hermetic lots, the Hellenistic time-lords (profections, firdaria,
7
+ zodiacal releasing), and primary directions — the model does the interpreting.
8
+ It needs
6
9
  no API keys, ephemeris files, or network calls; the engine data ships inside
7
10
  the package.
8
11
 
9
12
  ## Setup
10
13
 
11
- Any MCP client that speaks stdio:
14
+ Claude Code / Claude Desktop, one line:
15
+
16
+ ```bash
17
+ claude mcp add caelus -- npx caelus-mcp
18
+ ```
19
+
20
+ Or any MCP client that speaks stdio:
12
21
 
13
22
  ```json
14
23
  {
@@ -22,6 +31,9 @@ Any MCP client that speaks stdio:
22
31
  - **Cursor** — `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global)
23
32
  - **Anything else** — spawn `npx caelus-mcp` and speak JSON-RPC over stdio
24
33
 
34
+ A hosted Streamable HTTP endpoint is also live at
35
+ `https://www.ephemengine.com/api/mcp` for clients that prefer a remote server.
36
+
25
37
  ## Tools
26
38
 
27
39
  | tool | what it answers |
@@ -35,6 +47,15 @@ Any MCP client that speaks stdio:
35
47
  | `sky_events` | Rise/set/meridian transits, lunar phases, stations, zodiac crossings in a date range (≤370 days) |
36
48
  | `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
49
  | `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 |
50
+ | `returns` | Solar/lunar return instants in a window plus the first return chart, cast at the return location (defaults to the birthplace) |
51
+ | `progressions` | Secondary progressions (day-for-a-year) and solar-arc directions to a target date: per body the secondary and directed longitude, plus the solar arc |
52
+ | `composite` | Two relationship charts for a pair: the midpoint composite (bodies and angles) and the Davison chart |
53
+ | `dignities` | Essential dignity (domicile/exaltation/detriment/fall) and sect for the seven traditional planets at a moment and place |
54
+ | `lots` | The seven Hermetic lots (Arabic parts) — Fortune, Spirit, Eros, Necessity, Courage, Victory, Nemesis — cast from the Ascendant, sect-aware |
55
+ | `profections` | Annual and monthly profections to a target date: age, the profected signs and their whole-sign houses, and the lord of the year |
56
+ | `firdaria` | The firdaria planetary time-lord periods: the full 75-year timeline (nine periods, seven sub-periods each) and the lords active at a target date |
57
+ | `releasing` | Zodiacal releasing (aphesis) from the Lot of Spirit or Fortune: the L1–L4 period timeline and the lords active at a target date, with loosing of the bond |
58
+ | `directions` | Primary directions of the seven traditional planets to the four angles (MC/IC/Asc/Desc) by the Naibod or Ptolemy time key, sorted by age |
38
59
 
39
60
  `natal_chart` and `current_sky` also tag each body with its solar phase
40
61
  (cazimi/combust/under-the-beams) and each aspect with applying/separating.